Overview
Using the Agent Chat API
13 methods a bot or an integration calls with a bot token.
Before you start
The Agent Chat API is what a bot or an integration uses to work chats: list and read them, reply, tag, transfer to a person and close. Each method is one POST to https://app.staging.mlive.chat/v1/agent/action/<method> with a JSON body, authenticated with a bot token (Authorization: Bearer mlcb_…). A bot sees only the chats assigned to it; any other chat answers not_found. New to bots? Start with Build a bot.
Agent Chat API resources
| Resource | Methods |
|---|---|
| Chats | List chats, Get a chat, List threads, Deactivate a chat |
| Chat access | Transfer a chat |
| Thread tags | Tag a thread, Untag a thread |
| Events | Send an event, Upload a file |
| Customers | Get a customer |
| Status | Set routing status |
| Other | Send a typing indicator |
| Realtime | Get a WebSocket ticket |