Сообщения (приём входящих)

Входящие от ваших систем. Исходящие агента — в разделе «Диалоги».

Получить vs ответить

	Кто пишет	Метод
Входящее	Клиент, CRM, ваш сервер	`POST /v1/ingest/messages`
Исходящее	Оператор / ваш агент	`POST /v1/conversations/{channel}/messages`

Приём входящих

POST/v1/ingest/messages

Нужно право messages:write. Канал в теле — источник namespace:slug (custom:shop). С identity.external_id или thread_id шлюз пишет тред custom:shop:{uuid}. Виджет на сайте — не приём входящих, а API виджета. Как слушать ленту и отвечать: Входящие и живой канал.

bodyJSON

{
  "channel": "custom:shop",
  "body": "Где заказ #1042?",
  "idempotency_key": "shop:ord_1042:cmt_9",
  "identity": { "email": "ada@example.com", "external_id": "ord_1042" }
}

TypeScript

await client.ingest.send({
  channel: "custom:shop",
  body: "Где заказ #1042?",
  identity: { email: "ada@example.com", external_id: "ord_1042" },
});

Страница полезна?