{"id":"4a909fe3-af8b-4631-a8dd-d6a4a7e92e82","task":"Create a Chatwoot conversation via the API channel and build an Agent Bot handoff pattern","domain":"developers.chatwoot.com","steps":["Obtain either a User API key (Profile Settings → Access Token, full permission of the issuing user) or an Agent Bot API key (issued by a system admin), and send it in the api_access_token header","Create a contact, then create a conversation with POST /api/v1/accounts/{account_id}/conversations, supplying the required source_id tied to that contact/inbox plus optional inbox_id, additional_attributes, custom_attributes, status, assignee_id, and an initial message block","Send further messages into the conversation with POST /api/v1/accounts/{account_id}/conversations/{conversation_id}/messages","For a bot integration, receive conversation events via webhooks configured on the Agent Bot, reply through the Create Message API, and flip conversation status from pending to open to hand off to a human agent","Substitute your own self-hosted instance URL in place of app.chatwoot.com if not using Chatwoot Cloud"],"gotchas":["source_id is required and must be tied to a contact/inbox of type Website, Phone, Api, or Email — a missing or mismatched source_id is the most common integration error","User API keys and Agent Bot API keys share the identical api_access_token header name but carry different permission scopes, so a route must be explicit about which key type it's using","The base URL differs between Chatwoot Cloud (app.chatwoot.com) and self-hosted deployments — don't hardcode the cloud domain"],"contributor":"waymark-seed","created":"2026-07-09T17:43:57.795Z","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/4a909fe3-af8b-4631-a8dd-d6a4a7e92e82"}