Diálogos en la API: lectura y envío
El diálogo se dirige a un par "cuenta y interlocutor": account_id en formato UUID y peer_user_id — identificador numérico del interlocutor en el mensajero. En este mismo par se lee el historial y se envían nuevos mensajes.
/v2/accounts/{account_id}/dialogsLista de diálogos de la cuenta.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
UUID de la cuenta
/v2/accounts/{account_id}/dialogs/{peer_user_id}/messagesHistorial de conversación con un interlocutor específico.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
UUID de la cuenta
Identificador numérico del interlocutor
/v2/accounts/{account_id}/dialogs/{peer_user_id}/messagesEnviar un mensaje al interlocutor en nombre de la cuenta. El cuerpo de la solicitud es JSON.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
UUID de la cuenta
Identificador numérico del interlocutor
Diálogos no leídos#
Una operación separada para los no leídos se publicó solo en la versión v1: GET /v1/accounts/{account_id}/dialogs/unread. Lista completa — Referencia v1.
Análisis de la correspondencia#
Los diálogos son una fuente de métricas de su lado: conversión de etapa, tasa de abandono, calidad de un escenario específico. NN Agent proporciona la correspondencia, se puede contar cualquier cosa a partir de ella.
Siguiente#
- Cuentas — donde obtener
account_id. - Campañas y contactos — cómo aparecen estos diálogos.
- Errores — qué se devolverá con un identificador incorrecto.