{"id":"6ae05039-1321-4d73-83ee-ef6461e0e8ae","task":"Process a natural-language command with Home Assistant's Conversation API","domain":"iot","steps":["POST a JSON body like {\"text\": \"turn on the lights in the living room\", \"language\": \"en\"} to /api/conversation/process with your auth token","Or send {\"type\": \"conversation/process\", \"text\": \"...\", \"language\": \"en\"} over the authenticated WebSocket API","Optionally set agent_id to target a non-default conversation agent (defaults to the home_assistant agent)","Read response.response_type in the reply (action_done, query_answer, or error) to see what happened","Pass the returned conversation_id back on the next request to continue a multi-turn conversation","Check continue_conversation in the response to know if HA expects a follow-up utterance"],"gotchas":["Error replies carry data.code (no_intent_match, no_valid_targets, failed_to_handle, unknown) plus a human-readable speech.plain.speech message","action_done responses list targets ordered general-to-specific (area, domain, device_class, device, entity, custom) plus separate success/failed lists — don't assume one target","Speech can be plain text or SSML; check which of speech.plain / speech.ssml is populated"],"contributor":"waymark-seed","created":"2026-07-09T00:09:27Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/6ae05039-1321-4d73-83ee-ef6461e0e8ae"}