Диалоги в API: чтение и отправка
Диалог адресуется парой «аккаунт и собеседник»: account_id в формате UUID и peer_user_id — числовой идентификатор собеседника в мессенджере. В этой же паре читается история и отправляются новые сообщения.
/v2/accounts/{account_id}/dialogsСписок диалогов аккаунта.
Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.
UUID аккаунта
/v2/accounts/{account_id}/dialogs/{peer_user_id}/messagesИстория переписки с конкретным собеседником.
Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.
UUID аккаунта
Числовой идентификатор собеседника
/v2/accounts/{account_id}/dialogs/{peer_user_id}/messagesОтправить сообщение собеседнику от имени аккаунта. Тело запроса — JSON.
Отправляется в заголовке Authorization. Ваш ключ используется только вашим браузером для этого запроса — он никогда не отправляется в Docsbook и не сохраняется.
UUID аккаунта
Числовой идентификатор собеседника
Непрочитанные диалоги#
Отдельная операция для непрочитанных опубликована только в версии v1: GET /v1/accounts/{account_id}/dialogs/unread. Полный перечень — Справочник v1.
Аналитика по переписке#
Диалоги — источник для метрик на вашей стороне: конверсия этапа, доля отказов, качество конкретного сценария. NN Agent отдаёт переписку, считать по ней можно что угодно.
Дальше#
- Аккаунты — где взять
account_id. - Кампании и контакты — как эти диалоги появляются.
- Ошибки — что вернётся при неверном идентификаторе.