NN Agent
Aperçu

Comment lancer la première campagne via l'API

Une campagne dans NN Agent se compose de trois parties : contacts, pool de variantes du premier message et comptes liés. Ci-dessous l'ordre des appels de la version v2.

Avant de commencer, connectez au moins un compte — voir Connecter un compte via l'API.

1
Créez une campagne
curl -X POST https://api.nexifyneo.com/v2/campaigns \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d 'YOUR_JSON_BODY'

La réponse renverra l'identifiant de la campagne au format UUID. Ensuite, il est utilisé dans le chemin de toutes les autres requêtes.

2
Téléchargez la base de contacts

Les contacts sont chargés par fichier, et non ligne par ligne. Les formats CSV et XLSX sont pris en charge ; le format est spécifié par le paramètre de requête format, par défaut csv.

curl -X POST "https://api.nexifyneo.com/v2/campaigns/CAMPAIGN_ID/contacts/upload?format=csv" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "file=@contacts.csv"

Vous pouvez vérifier que la base a été chargée avec le résumé : GET /v2/campaigns/{campaign_id}/contacts/stats.

3
Remplissez le pool des premiers messages
curl -X POST https://api.nexifyneo.com/v2/campaigns/CAMPAIGN_ID/message-pool \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d 'YOUR_JSON_BODY'

Ajoutez plusieurs variantes, pas une seule. NN Agent prend dans le pool le texte pour le contact suivant, et c'est le seul moyen d'éviter d'envoyer à toute la base le même texte caractère par caractère.

4
Liez les comptes
curl -X POST https://api.nexifyneo.com/v2/campaigns/CAMPAIGN_ID/accounts \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d 'YOUR_JSON_BODY'

Les messages sortants seront envoyés depuis les comptes liés. La dissociation se fait avec la même adresse par la méthode DELETE.

5
Vérifiez la composition de la campagne
curl https://api.nexifyneo.com/v2/campaigns/CAMPAIGN_ID \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Vérifiez que la campagne a des contacts, un pool de messages et au moins un compte. Une campagne sans pool ou sans compte n'a rien à envoyer.

Comment le lancement est-il effectué#

Aucune opération distincte «lancer la campagne» n'est déclarée dans la spécification publiée. Le lancement s'effectue par la mise à jour de la campagne (POST /v2/campaigns/{campaign_id}/update) soit depuis le bureau ; pour savoir quels champs sont modifiés lors du lancement, veuillez consulter les responsables dans le bot @NN_official_bot.

Que se passe-t-il ensuite avec les dialogues#

Après le premier contact, la conversation est dirigée par l'IA selon votre scénario — voir Chat-flow. La correspondance peut être lue et poursuivie manuellement via les opérations de dialogue.

Exporter la base avec les résultats : GET /v2/campaigns/{campaign_id}/contacts/export?format=xlsx.

Suite#

Updated

Propulsé par Docsbook
Comment lancer la première campagne via l'API — NN Agent