API ReferenceHandover
Request a human agent
POST
Moves the contact's latest conversation into the live-chat queue, so the bot stops
replying and an agent can pick it up. Returns success: false if a handover is
already requested. Requires scope conversation:handover:request.
header
AuthorizationBearer <token>Your organization API key: Authorization: Bearer org_…
application/json- body
audienceExternalId*AudienceExternalIdThe contact's ID on its channel. For WhatsApp it is
<phone number>:<your WhatsApp phone number ID>.
Done, or success: false if already requested.
application/json- response
success*booleancurl -X POST 'https://api.enigma-ai.com/v1/handover' \ -H 'Content-Type: application/json' \ -d '{ "audienceExternalId": "string"}'{ "success": true}