Aperçu

Campagnes et contacts dans l'API

Une campagne se compose de trois parties : contacts, pool d'options pour le premier message et comptes associés. Ci-dessous les opérations de la version v2; l'identifiant du client est substitué par le token.

Campagnes#

GET/v2/campaigns

Liste des campagnes du client.

Autorisation
Autorisationstring

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.

POST/v2/campaigns

Créer une campagne. Le corps de la demande est en JSON.

Autorisation
Autorisationstring

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.

GET/v2/campaigns/{campaign_id}

Fiche de la campagne.

Autorisation
Autorisationstring

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.

Chemin
campaign_idstringrequis

UUID de la campagne

POST/v2/campaigns/{campaign_id}/update

Modifier les paramètres de la campagne. Le corps de la demande est en JSON.

Autorisation
Autorisationstring

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.

Chemin
campaign_idstringrequis

UUID de la campagne

SUPPRIMER/v2/campaigns/{campaign_id}

Supprimer la campagne ainsi que ses contacts et son pool de messages.

Autorisation
Autorisationstring

Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette requête — elle n'est jamais envoyée à Docsbook ni stockée.

Chemin
campaign_idstringrequis

UUID de la campagne

Comptes de campagne#

POST/v2/campaigns/{campaign_id}/accounts

Associer des comptes à la campagne : les sorties proviendront de ceux-ci. Le corps de la requête est en JSON.

Autorisation
Authorizationstring

Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette requête — elle n'est jamais envoyée à Docsbook ni stockée.

Chemin
campaign_idstringrequis

UUID de la campagne

DELETE/v2/campaigns/{campaign_id}/accounts

Dissocier des comptes de la campagne. Le corps de la requête est en JSON.

Autorisation
Authorizationstring

Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette requête — elle n'est jamais envoyée à Docsbook ni stockée.

Chemin
campaign_idstringrequis

UUID de la campagne

Contacts#

Les contacts de la campagne sont téléchargés par fichier et exportés dans le même format. Le paramètre format accepte uniquement csv ou xlsx, par défaut csv.

POST/v2/campaigns/{campaign_id}/contacts/upload

Télécharger la base de contacts par fichier. Le corps de la requête est multipart/form-data avec le champ file.

Autorisation
Authorizationstring

Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette requête — elle n'est jamais envoyée à Docsbook ni stockée.

Chemin
campaign_idstringrequis

UUID de la campagne

Corps
formatstring

csv ou xlsx, par défaut csv

GET/v2/campaigns/{campaign_id}/contacts

Liste des contacts de la campagne.

Autorisation
Authorizationstring

Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette requête — elle n'est jamais envoyée à Docsbook ni stockée.

Chemin
campaign_idstringrequis

UUID de la campagne

GET/v2/campaigns/{campaign_id}/contacts/stats

Résumé des contacts de la campagne.

Autorisation
Authorizationstring

Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette requête — elle n'est jamais envoyée à Docsbook ni stockée.

Chemin
campaign_idstringrequis

UUID de la campagne

GET/v2/campaigns/{campaign_id}/contacts/export

Exporter les contacts de la campagne dans un fichier.

Autorisation
Authorizationstring

Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette requête — elle n'est jamais envoyée à Docsbook ni stockée.

Chemin
campaign_idstringrequis

UUID de la campagne

Requête
formatstring

csv ou xlsx, par défaut csv

DELETE/v2/campaigns/{campaign_id}/contacts

Effacer la base de contacts de la campagne.

Autorisation
Authorizationstring

Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette requête — elle n'est jamais envoyée à Docsbook ni stockée.

Chemin
campaign_idstringrequis

UUID de la campagne

Pool de messages#

Le pool conserve les variantes du message initial. L'agent NN prend le texte de celui-ci pour le contact suivant, donc le même texte n'est pas envoyé à toute la base consécutivement.

GET/v2/campaigns/{campaign_id}/message-pool

Liste des variantes du premier message de la campagne.

Autorisation
Authorizationstring

Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette requête — elle n'est jamais envoyée à Docsbook ni stockée.

Chemin
campaign_idstringrequis

UUID de la campagne

POST/v2/campaigns/{campaign_id}/message-pool

Ajouter une variante de message au pool. Le corps de la requête est en JSON.

Autorisation
Authorizationstring

Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette requête — elle n'est jamais envoyée à Docsbook ni stockée.

Chemin
campaign_idstringrequis

UUID de la campagne

DELETE/v2/campaigns/{campaign_id}/message-pool/{message_id}

Supprimer une variante du pool.

Autorisation
Authorizationstring

Envoyé en tant qu'en-tête d'autorisation. Votre clé est utilisée uniquement par votre navigateur pour cette requête — elle n'est jamais envoyée à Docsbook ni stockée.

Chemin
campaign_idstringrequis

UUID de la campagne

message_idstringrequis

UUID de la variante de message

Suivant#

Updated

Cette page vous a-t-elle été utile ?

Campagnes et contacts dans l'API — NN Agent