Inbox

Agent workspace for WhatsApp, Telegram, web chat, and other channels. List conversations, take over from bots, hand back to automation, reply on the originating channel, and manage tickets.

Conversations

• GET /v1/inbox/conversations — list with team scoping
• GET /v1/inbox/conversations/{id}/messages — thread history
• POST /v1/inbox/conversations/{id}/messages — agent reply (delivers on channel)

Bot takeover & handback

• POST /v1/inbox/conversations/{id}/takeover — agent assumes control_mode
• POST /v1/inbox/conversations/{id}/handback — return to bot automation
• Flow handoff nodes set pending_handoff until an agent takes over

Tickets & SLA

• GET/POST /v1/inbox/tickets — support tickets linked to conversations
• SLA policies with first-response and resolution targets
• Ticket status and priority for operator workflows

Real-time events

GET /v1/inbox/events streams Server-Sent Events for new messages and conversation updates (PostgreSQL NOTIFY). Use for live console dashboards.