Dialoge in der API: Lesen und Senden
Ein Dialog wird durch das Paar „Konto und Gesprächspartner“ adressiert: account_id im UUID-Format und peer_user_id — die numerische ID des Gesprächspartners im Messenger. In diesem Paar wird die Historie gelesen und neue Nachrichten gesendet.
/v2/accounts/{account_id}/dialogsListe der Dialoge des Kontos.
Wird als Autorisierungsheader gesendet. Ihr Schlüssel wird nur von Ihrem Browser für diese Anfrage verwendet — er wird niemals an Docsbook gesendet oder gespeichert.
UUID des Kontos
/v2/accounts/{account_id}/dialogs/{peer_user_id}/messagesHistorie der Korrespondenz mit einem bestimmten Gesprächspartner.
Wird als Autorisierungsheader gesendet. Ihr Schlüssel wird nur von Ihrem Browser für diese Anfrage verwendet — er wird niemals an Docsbook gesendet oder gespeichert.
UUID des Kontos
Numerische ID des Gesprächspartners
/v2/accounts/{account_id}/dialogs/{peer_user_id}/messagesEine Nachricht an den Gesprächspartner im Namen des Kontos senden. Der Anfrageinhalt ist JSON.
Wird als Autorisierungsheader gesendet. Ihr Schlüssel wird nur von Ihrem Browser für diese Anfrage verwendet — er wird niemals an Docsbook gesendet oder gespeichert.
UUID des Kontos
Numerische ID des Gesprächspartners
Ungelesene Dialoge#
Eine separate Operation für ungelesene wurde nur in Version v1: GET /v1/accounts/{account_id}/dialogs/unread veröffentlicht. Die vollständige Liste — Handbuch v1.
Analytik der Korrespondenz#
Dialoge sind eine Quelle für Metriken auf Ihrer Seite: Konversionsrate, Absprungrate, Qualität eines bestimmten Szenarios. NN Agent gibt die Korrespondenz aus, anhand derer alles Mögliche berechnet werden kann.
Weiter#
- Konten — wo man
account_idbekommt. - Kampagnen und Kontakte — wie diese Dialoge erscheinen.
- Fehler — was bei einer falschen ID zurückgegeben wird.