Dialogues dans l'API : lecture et envoi
Le dialogue est adressé par une paire « compte et interlocuteur » : account_id au format UUID et peer_user_id — identifiant numérique de l'interlocuteur dans le messager. Dans cette même paire, l'historique est lu et de nouveaux messages sont envoyés.
/v2/accounts/{account_id}/dialogsListe des dialogues du compte.
Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette demande — elle n'est jamais envoyée à Docsbook ni stockée.
UUID du compte
/v2/accounts/{account_id}/dialogs/{peer_user_id}/messagesHistorique des échanges avec un interlocuteur spécifique.
Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette demande — elle n'est jamais envoyée à Docsbook ni stockée.
UUID du compte
Identifiant numérique de l'interlocuteur
/v2/accounts/{account_id}/dialogs/{peer_user_id}/messagesEnvoyer un message à l'interlocuteur au nom du compte. Le corps de la demande est en JSON.
Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette demande — elle n'est jamais envoyée à Docsbook ni stockée.
UUID du compte
Identifiant numérique de l'interlocuteur
Dialogues non lus#
Une opération distincte pour les non lus a été publiée uniquement dans la version v1: GET /v1/accounts/{account_id}/dialogs/unread. La liste complète — Référence v1.
Analyse des échanges#
Les dialogues sont une source de métriques de votre côté : conversion d'étape, taux de rebond, qualité d'un scénario spécifique. NN Agent fournit les échanges, vous pouvez en tirer n'importe quelle donnée.
Suite#
- Comptes — où obtenir
account_id. - Campagnes et contacts — comment ces dialogues apparaissent.
- Erreurs — ce qui sera renvoyé en cas d'identifiant incorrect.