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

Обновлено: 24 марта 2026

Метод отправляет исходящее сообщение в закрытый тред — открывает тред, отправляет в него сообщение и закрывает тред.

Чтобы отправить сообщение на определенное устройство, укажите его идентификатор в поле deviceAddress.

    ----
    Permissions:INTEGRATOR,OPERATOR,SUPERVISOR
    ----

Поля тела запроса

Параметр	Тип	Описание
text	String	Текст сообщения
attachments	List of objects (необязательно)	Список вложений сообщения
applicationDescriptor.channelType	String	Тип канала
applicationDescriptor.clientId	String	Внешний идентификатор авторизованного клиента
applicationDescriptor.unauthorizedClientId	String (необязательно)	Внешний идентификатор неавторизованного клиента
applicationDescriptor.deviceAddress	String	Адрес устройства в данном channelType, куда вы хотите отправить сообщение
applicationDescriptor.appMarker	String (необязательно)	Идентификатор приложения на данном устройстве, куда вы хотите отправить сообщение

Пример curl

$ curl 'http://localhost:8080/api/v1/messages/outgoing-to-device' -i -X POST \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer <integrator_token>' \
    -H 'X-Tenant-Name: local' \
    -d '{
  "text" : "message",
  "attachments" : [ ],
  "clientApplicationDescriptor" : {
    "channelType" : "WHATSAPP",
    "deviceAddress" : "89991234567"
  }
'

Пример HTTP запроса

Пример отправки сообщения в WhatsApp

POST /api/v1/messages/outgoing-to-device HTTP/1.1
Content-Type: application/json
Authorization: Bearer <integrator_token>
X-Tenant-Name: local
Content-Length: 156
Host: localhost:8080

{
  "text" : "message",
  "attachments" : [ ],
  "clientApplicationDescriptor" : {
    "channelType" : "WHATSAPP",
    "deviceAddress" : "89991234567"
  }
}

Пример отправки сообщения на мобильное устройство

POST /api/v1/messages/outgoing-to-device HTTP/1.1
Content-Type: application/json
Authorization: Bearer <integrator_token>
X-Tenant-Name: local
Content-Length: 181
Host: localhost:8080

{
  "text" : "message",
  "attachments" : [ ],
  "clientApplicationDescriptor" : {
    "channelType" : "MOBILE",
    "clientId" : "012-4393-3943-79",
    "appMarker" : "myApp"
  }
}

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

Поля тела ответа

Параметр	Тип	Описание
id	Long	Уникальный идентификатор сообщения в edna
threadId	Long	Уникальный идентификатора нового треда в edna для отправленного сообщения
clientId	Long	Уникальный идентификатор клиента, которому было отправлено сообщение
clientExternalId	String	Уникальный внешний идентификатор клиента, которому было отправлено сообщение
agentId	Long	Уникальный идентификатор агента, отправившего сообщение

HTTP/1.1 200 OK
X-Request-Id: 1d37fe15-e8a2-4d38-86cc-c9844d558195
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY
Content-Length: 110

{
  "id" : 1,
  "threadId" : 2,
  "clientId" : 1,
  "clientExternalId" : "012-4393-3943-79",
  "agentId" : 3
}