Отправить сообщение оператора к Клиенту
Метод позволяет отправить Клиенту сообщение от имени оператора.
С помощью метода можно отправить:
- текстовое сообщение (до 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») |
Примеры запроса.
- Текстовое сообщение:
{
"id": "fc30",
"chat_id": "847b",
"abonent_id": 3645,
"local_message_id": "1678",
"payload": {
"type": "text",
"text": "Hello world!"
}
}
- Отправка файла (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
}
}
Была ли статья полезна?
Предыдущая