Send an event

A message or a file (from upload_file) in the visitor's chat.

event.custom_id makes a retry safe: the same custom_id returns the first event_id.

POST/v1/customer/action/send_event

Send an event

curl -X POST 'https://app.staging.mlive.chat/v1/customer/action/send_event' \
  -H "Authorization: Bearer $MLC_CUSTOMER_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "chat_id": "01937c6e-0000-7000-8000-000000000001",
    "event": {
      "type": "message",
      "text": "Do you ship to Penang?"
    }
  }'

const res = await fetch('https://app.staging.mlive.chat/v1/customer/action/send_event', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${customerToken}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "chat_id": "01937c6e-0000-7000-8000-000000000001",
    "event": {
      "type": "message",
      "text": "Do you ship to Penang?"
    }
  }),
});
const data = await res.json();

Response200

{
  "event_id": "63cd2bab-0458-71e8-84e3-3825456e3e62"
}

Specifics

Method URL	`POST https://app.staging.mlive.chat/v1/customer/action/send_event`
Who can call it	Visitors, with a customer access token (`mlcc_`).
WebSocket action	`send_event`, the same call over an open socket

Request body

application/json

chat_idstringrequired
eventobjectrequired
event.typestringrequired
One of message, file.
event.textstring
Up to 4000 characters.
event.urlstring
File only.
event.custom_idstring
Up to 200 characters.

Response

200 · application/json

OK.

event_idstringrequired

Errors

default