Отправить сообщение оператора к Клиенту

Метод позволяет отправить Клиенту сообщение от имени оператора.

С помощью метода можно отправить:

  • текстовое сообщение (до 10 000 символов);
  • файл или изображение (размер до 50 МБ).

Если передается файл, используется формат multipart/form-data.

HTTP-запрос:

POST https://app.mango-office.ru/cc/md/session/chat/send_message

Параметры запроса:

Параметр Тип Обязательное Описание
id String Да Уникальный идентификатор вызова (например, UUID). Формируется внешней системой. Манго Диалоги и ВАТС никак не обрабатывают этот идентификатор, не анализируют и не полагаются на его уникальность
chat_id String Да Уникальный идентификатор чата. Узнать идентификатор чата вы можете при помощи запроса "Получить список виджетов" или API Realtime
abonent_id Integer Да Идентификатор сотрудника ВАТС, отправителя сообщения. Узнать список сотрудников ВАТС и их идентификаторы вы можете при помощи API MANGO OFFICE или API Realtime
local_message_id String Да Уникальный локальный идентификатор сообщения. Формируется внешней системой. Манго Диалоги и ВАТС полагаются на уникальность его значения.
payload Object Да Объект сообщения (см. раздел 2.4.6 «Объект Message»)

Примеры запроса.

  1. Текстовое сообщение:
{
    "id": "fc30",
    "chat_id": "847b",
    "abonent_id": 3645,
    "local_message_id": "1678",
    "payload": {
        "type": "text",
        "text": "Hello world!"
    }
}
  1. Отправка файла (multipart/form-data):
Content-Type: multipart/form-data; boundary="1234567890-boundary"

--1234567890-boundary
Content-Disposition: form-data; name="request"
Content-Type: application/json

{
    "id": "fc30",
    "chat_id": "847b",
    "abonent_id": 3645,
    "local_message_id": "1678",
    "payload": {
        "type": "file",
        "name": "data.zip"
    }
}

--1234567890-boundary
Content-Disposition: form-data; name="file"; filename="data.zip"
Content-Type: application/octet-stream

<...........................binary data...........................>

--1234567890-boundary--

Параметры ответа:

Параметр Тип Обязательное Описание
name String Да Наименование статуса HTTP
status Integer Да Код ответа HTTP
code Integer Да Код результата (список)
error String Нет Текст ошибки, если она произошла
message Object Нет Информация об отправленном сообщении

Структура объекта message

Параметр Тип Обязательное Описание
local_message_id String Да Локальный идентификатор сообщения
message_id String Да Идентификатор сообщения в МД
time Integer Да Время отправки сообщения (Unix Timestamp)

Пример ответа:

{
    "name": "OK",
    "status": 200,
    "code": 1000,
    "message": {
        "local_message_id": "1678",
        "message_id": "1678",
        "time": 1678
    }
}