Transfer a chat

Hands the chat to another agent or group.

Without target it is transferred within its current group. One target ID per call.

POST/v1/agent/action/transfer_chat

Transfer a chat

curl -X POST 'https://app.staging.mlive.chat/v1/agent/action/transfer_chat' \
  -H "Authorization: Bearer $MLC_BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "01937c6e-0000-7000-8000-000000000001",
    "target": {
      "type": "group",
      "ids": [
        "1"
      ]
    }
  }'

const res = await fetch('https://app.staging.mlive.chat/v1/agent/action/transfer_chat', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MLC_BOT_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": "01937c6e-0000-7000-8000-000000000001",
    "target": {
      "type": "group",
      "ids": [
        "1"
      ]
    }
  }),
});
const data = await res.json();

Response200

{}

Specifics

Method URL	`POST https://app.staging.mlive.chat/v1/agent/action/transfer_chat`
Who can call it	Bots, with a bot token (`mlcb_`).

Request body

application/json

idstringrequired
The chat ID.
targetobject
target.typestringrequired
One of agent, group.
target.idsarray of stringrequired
One agent ID, or one group ID (as a number or a numeric string). Up to 1 items.
ignore_agents_availabilityboolean
Queue the chat when nobody in the group can take it now. Default false.

Response

200 · application/json

OK.

Errors

default