Wie der NN Agent funktioniert: Kunde, Konto, Kampagne, Dialog

Der NN Agent arbeitet mit sechs Entitäten. Sie sind sowohl im Dashboard als auch in der API identisch, daher kommen die Namen auf dieser Seite sowohl auf den Bildschirmen als auch in den Anfrage-URLs vor.

Kunde und Lizenz#

Kunde — Ihr Konto in NN Agent, an das Konten, Kampagnen und Kontakte gebunden sind. Der Kunde wird bei der Verifizierung im Telegram-Bot erstellt, und ein Zugriffstoken für die API wird ebenfalls ausgegeben.

Lizenz bestimmt, wie viele Slots Sie aktiv haben und bis wann. Lizenzen werden mit einem Code aktiviert und verlängert; in der API ist dies eine separate Gruppe von Operationen — GET /v2/client/licenses, POST /v2/client/licenses/activate, POST /v2/client/licenses/renew.

Konto#

Konto — ein verbundenes Messenger-Konto, von dem aus der NN Agent schreibt und liest. Das Konto hat eine eigene ID im UUID-Format, einen Namen und ein Foto; für den Client auf der anderen Seite ist es eine gewöhnliche Person und kein Bot.

Es kann viele Konten geben: Sie werden in einem Feed synchronisiert, und ein Wechsel zwischen den Chats ist nicht erforderlich. Weitere Informationen — Multi-Accounting.

Autorisierungssitzung#

Autorisierungssitzung — ein temporäres Objekt, das genau so lange lebt, wie die Verbindung des Kontos besteht. Sie erstellen es, der Messenger sendet einen Code, Sie senden den Code in die Sitzung, falls erforderlich auch das Cloud-Passwort, wonach das Konto verbunden wird.

Die Sitzung hat ihre eigene UUID, die von der Kontonummer getrennt ist. Es gibt eine Option mit einem QR-Code anstelle des Codes aus der Nachricht.

Kampagne#

Kampagne — ausgehende Nachricht: eine Sammlung von Kontakten, eine Sammlung von Optionen für die erste Nachricht und verbundene Konten, die diese Nachrichten senden. Ein Konto kann an mehreren Kampagnen teilnehmen und umgekehrt.

Die Kampagne speichert ihre Kontakte separat, daher vermischt sich die Datenbank einer Kampagne nicht mit der einer anderen.

Nachrichtenspeicher#

Nachrichtenspeicher — eine Liste von Optionen für die primäre Nachricht der Kampagne. Der NN-Agent entnimmt daraus den Text für den nächsten Kontakt, weshalb die gesamte Datenbank nicht denselben Zeichen für Zeichen Text erhält.

Der Speicher wird einzeln oder durch Hochladen gefüllt; einzelne Elemente werden anhand ihrer ID entfernt.

Kontakt und Dialog#

Kontakt — Eintrag in der Kampagnendatenbank: wer geschrieben werden soll. Kontakte werden als CSV- oder XLSX-Datei hochgeladen und im gleichen Format exportiert.

Dialog — Korrespondenz zwischen Ihrem Konto und einem bestimmten Gesprächspartner. Der Dialog wird durch das Paar „Konto + Identifikator des Gesprächspartners“ adressiert, und in diesem Paar werden Nachrichten gelesen und neue gesendet.

Wie hängt das zusammen#

Der Kunde besitzt Konten und Kampagnen. Eine Kampagne hält Kontakte und einen Pool von Nachrichten und stützt sich auf die damit verbundenen Konten. Der Versand über die Kampagne erzeugt Dialoge, die dann von der KI gemäß Ihrem Szenario weitergeführt werden.

Weiter#

• Erste Schritte — alles im Dashboard zusammenstellen.
• API-Übersicht — dieselben Entitäten mit den Anfrageadressen.
• Chat-Flow — was mit dem Dialog nach der ersten Berührung passiert.