Comment fonctionne NN Agent : client, compte, campagne, dialogue

NN Agent opère avec six entités. Elles sont identiques dans le bureau et dans l'API, donc les noms de cette page apparaissent à la fois sur les écrans et dans les adresses des requêtes.

Client et licence#

Client — votre compte dans NN Agent, auquel sont liés les comptes, les campagnes et les contacts. Le client est créé lors de la vérification dans le bot Telegram, et un jeton d'accès à l'API y est également délivré.

Licence définit combien de slots vous avez activés et jusqu'à quelle date. Les licences sont activées par un code et prolongées ; dans l'API, il s'agit d'un groupe d'opérations distinct — GET /v2/client/licenses, POST /v2/client/licenses/activate, POST /v2/client/licenses/renew.

Compte#

Compte — compte de messagerie connecté, au nom duquel NN Agent écrit et lit. Le compte a son propre identifiant au format UUID, un nom et une photo ; pour le client de l'autre côté, c'est une personne ordinaire, et non un bot.

Il peut y avoir plusieurs comptes : ils sont synchronisés en un seul fil, et il n'est pas nécessaire de basculer entre les chats. Plus de détails — Multi-comptes.

Session d'autorisation#

Session d'autorisation — un objet temporaire qui vit exactement aussi longtemps que la connexion au compte est active. Vous la créez, le messager envoie un code, vous envoyez le code dans la session, et si nécessaire, un mot de passe cloud, après quoi le compte devient connecté.

La session a son propre UUID, distinct de l'identifiant du compte. Il existe une option avec un code QR au lieu du code du message.

Campagne#

Campagne — envoi sortant : un ensemble de contacts, un ensemble d'options pour le premier message et des comptes associés qui envoient ces messages. Un compte peut participer à plusieurs campagnes, et vice versa.

La campagne conserve ses contacts séparément, donc la base d'une campagne ne se mélange pas avec la base d'une autre.

Pool de messages#

Pool de messages — liste des options de message initial de la campagne. L'agent NN prend le texte pour le contact suivant à partir de celui-ci, donc toute la base ne reçoit pas le même caractère en caractère texte.

Le pool est rempli un par un ou par téléchargement ; des éléments individuels sont supprimés par identifiant.

Contact et dialogue#

Contact — enregistrement dans la base de données de la campagne : qui doit écrire. Les contacts sont chargés à partir d'un fichier CSV ou XLSX et exportés dans le même format.

Dialogue — correspondance entre votre compte et un interlocuteur spécifique. Le dialogue est adressé par la paire « compte + identifiant de l'interlocuteur », et dans cette même paire, les messages sont lus et de nouveaux sont envoyés.

Comment cela est-il lié#

Le client possède des comptes et des campagnes. Une campagne détient des contacts et un ensemble de messages et s'appuie sur les comptes qui lui sont liés. L'envoi par campagne génère des dialogues que l'IA poursuit selon votre scénario.

Suite#

• Premiers pas — rassembler tout cela dans le bureau.
• Aperçu de l'API — les mêmes entités avec des adresses de requêtes.
• Flux de chat — que se passe-t-il avec le dialogue après le premier contact.