Give a conversation back to the AI to continue
Give a WhatsApp conversation the AI handed to the team back to the AI, which continues the contact's pending request now, though the contact has not written. Review the resolved blocker first; use expectedVersion and expectedHandoffMessageId to refuse a stale decision with VERSION_CONFLICT. note preserves the evidence and remaining request for the Agent. Only inside WhatsApp's 24-hour window, once per handoff, and for an AI handoff. Preserve explicit human requests, unresolved clinical/administrative decisions, identity conflicts and uncertain writes with the team. Not an AI tool: it makes the Agent write to a real person.
- Scope:
raiz:conversations:write - Credentials: an API key, a client-credentials token or a person's access token
- Effect: writes
- Limits: request body up to 32 KB, response up to 1 MB
- CLI:
arbol raiz conversations continue· not available on MCP
https://api.getarbol.com/v1/raiz/conversations/{conversationId}/continueAuthorization
Path parameters
Request body JSON required
- expectedHandoffMessageIdoptionalstring
The humanReviewMessageId just reviewed by the operator. A different current handoff refuses the continuation with VERSION_CONFLICT, without resuming or sending anything. Use with expectedVersion after checking that the original blocker is resolved.
pattern: ^msg_(?:[0-7][0-9a-hjkmnp-tv-z]{25}|(?:[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}|[a-f0-9]{32}))$ - noteoptionalstring
A short internal note about the resolved blocker, authoritative evidence, confirmed appointments and any remaining request. A note does not establish coverage, clinical equivalence, consent or a booking. Preserve explicit human requests and unresolved clinical decisions, identity conflicts or uncertain writes with the team.
maxLength: 500
Returns
200
Successful operation.
400
INVALID_INPUT: The request does not match the published schema.INVALID_CURSOR: The cursor is malformed or belongs to a different list.
404
NOT_FOUND: The requested resource does not exist.RESOURCE_NOT_FOUND: The requested resource does not exist in this organization.
409
CONVERSATION_CLOSED: The conversation is closed. Start a new conversation to write again.CONVERSATION_NOT_HANDED_OFF: The AI has not handed this conversation to the team, so there is nothing to give back to it.HANDOFF_ALREADY_CONTINUED: This handoff was already given back to the AI to continue. It continues once per handoff; a new escalation can be given back again.CHANNEL_NOT_READY: The channel is not connected yet, or this kind of traffic is not enabled on it.CHANNEL_TYPE_MISMATCH: This operation or field does not apply to this channel's type.WHATSAPP_WINDOW_CLOSED: More than 24 hours passed since the contact last wrote. Start the conversation with an approved template.VERSION_CONFLICT: The resource changed after it was read. Read it again and retry with the new version.
502
OUTCOME_UNKNOWN: The operation may have been applied; check its result before repeating it.
503
UPSTREAM_UNAVAILABLE: The upstream service could not complete the request.INTEGRATIONS_UNAVAILABLE: The organization's integrations cannot be read right now. Try again shortly.