Sign in
Webhook Events

Conversation control changed event

WhatsApp only. Fired when control of a conversation moves between Meta Business Agent and your app (Meta's messaging_handovers), or when the agent is first seen answering a thread. While control.owner is ai_agent, inbound messages arrive on message.received with metadata.standby: true and the agent's replies on message.sent with source: meta_business_agent. Sending any message takes control back; release it with POST /v1/inbox/conversations/{conversationId}/thread-control.

postWebhookconversation.control_changed

Payload

idstring required

Stable webhook event ID

event'conversation.control_changed' required
changedAtstring date-time required
timestampstring date-time required

UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.

Response

Webhook received successfully

Changes