Conversations & human handover
Read threads, reply as a human, hand back to the AI.
| Method | Path | What it does |
|---|---|---|
| GET | /conversations?status=handover |
List conversations (newest first). Filter by status: open, handover, resolved. |
| GET | /conversations/{id} |
One conversation with all messages. {id} is the conversation_id returned by /chat. |
| POST | /conversations/{id}/messages |
Reply as a human: { "message": "…", "user_email": "agent@yourco.com" }. Pauses the AI. |
| POST | /conversations/{id}/handover |
Ask for a human: { "reason": "VIP customer" }. Pauses the AI. |
| POST | /conversations/{id}/resolve |
Close the conversation and give it back to the AI. |
While a conversation is paused, new customer messages are stored and shown in the inbox, but the AI stays quiet until the conversation is resolved or handed back.