Importer

Un import lit un fichier, crée les nouveaux contacts, met à jour ceux qui existent déjà (par e-mail ou par numéro) et les ajoute à une liste si vous le demandez.

curl -X POST https://api.dexnotify.com/api/v1/contacts/imports \
  -H "x-api-key: $DEXNOTIFY_CLE" \
  -F file=@clients.xlsx \
  -F 'mapping={
    "phone": "Téléphone",
    "name": "Nom",
    "fields": { "email": "E-mail", "firstName": "Prénom", "lastName": "Nom de famille" },
    "attributes": { "ville": "Ville" },
    "hasHeader": true,
    "defaultCountry": "SN",
    "updateExisting": true
  }'

Clé de `mapping`	Description
`phone`, `fields.email`	Les colonnes du numéro et de l’e-mail ; il en faut au moins une.
`name`, `fields.firstName`, `fields.lastName`	Les colonnes du nom.
`attributes`	`{ "nomDeLAttribut": "Colonne" }` pour vos champs libres.
`hasHeader`	La première ligne porte les en-têtes. Sans en-tête, désignez les colonnes par leur rang, à partir de 1.
`defaultCountry`	Le pays des numéros écrits sans indicatif (`SN` par défaut).
`updateExisting`	Met à jour la fiche d’un contact déjà connu, au lieu de l’ignorer.

Pour importer directement dans une liste : POST /api/v1/contact-groups/{id}/imports, même corps.

Suivre l’import

L’import tourne en arrière-plan.

Route	Rend
`GET /api/v1/contacts/imports/{id}`	la progression : lignes lues, importées, en doublon, refusées
`GET /api/v1/contacts/imports/{id}/errors`	un CSV des lignes refusées : ligne, valeur, code, motif
`POST /api/v1/contacts/imports/{id}/cancel`	arrête l’import ; les contacts déjà importés restent

Le dashboard propose le même import avec un aperçu des colonnes et une correspondance assistée : Audience › Contacts › Importer.

Démarrer

SMS

E-mail

Contacts

Campagnes

Notifications push

WhatsApp

Intégrer

Ressources

Suivre l’import

​Suivre l’import

Suivre l’import