Passer au contenu principal

Comment importer des contacts via un fichier CSV dans WAX ?

Importez vos listes de contacts par lot dans WAX pour les cibler dans vos campagnes WhatsApp, RCS ou SMS.

Aperçu

Vous pouvez importer des contacts depuis un fichier .csv directement dans WAX. Au moment de l'import, vous créez une audience list (avec un nom et, si besoin, des tags), dans laquelle vos contacts importés sont regroupés. Une fois leur statut opt-in mis à jour via une campagne silencieuse de tagging (voir plus bas), vous pouvez les cibler dans une campagne, par exemple pour un message de bienvenue sur WhatsApp, RCS ou SMS.

Avant de commencer

  • Familiarisez-vous avec les notions d'audience list et de segment dans WAX : c'est dans une audience list que vos contacts importés seront regroupés, avant d'être utilisés pour cibler une campagne.

  • Votre fichier doit être au format .csv.

Comment importer votre fichier de contacts ?

1. Préparer votre fichier

Créez votre fichier en suivant le modèle ci-dessous :

phone_number

first_name

email

33XXXXXXXXX

Oumayma

33XXXXXXXXX

Enora

À noter :

  • Renommez la colonne du numéro de téléphone en phone_number, et placez-la en colonne A.

  • Renommez la colonne du prénom en first_name.

  • Pour toute variable personnalisée supplémentaire (Custom Field dans WAX), utilisez des underscores à la place des espaces et évitez les majuscules, par exemple date_naissance plutôt que Date Naissance.

2. Télécharger le fichier au format CSV

Une fois votre liste prête, exportez-la au format .csv depuis votre tableur.

3. Importer le fichier dans WAX

  1. Rendez-vous dans Audience > List et Segment dans WAX.

  2. Cliquez sur Create > List form CSV.

  3. Uploadez votre fichier .csv.

  4. Créez votre audience list : donnez-lui un nom.
    Important : choisissez bien ce nom, il sera ensuite utilisé comme source opt-in pour vos contacts.

  5. Choisissez le séparateur de valeurs utilisé dans votre fichier (virgule, point-virgule…), ou laissez l'option Autodetect sélectionnée : WAX détecte alors automatiquement le bon séparateur.

  6. Faites correspondre chaque colonne de votre CSV à un attribut WAX : pour les colonnes reconnues, WAX propose automatiquement l'attribut correspondant (badge Auto) ; pour les autres, choisissez un attribut déjà existant dans la liste, créez-en un nouveau en tapant son nom.

L'import passe en statut 🟣 In Progress le temps du traitement. Dans l'Import History, vous retrouvez pour chaque import son statut (Completed ou Failure), ainsi que le détail du traitement : nombre total de lignes, lignes traitées, contacts créés, mis à jour et doublons détectés.

Cliquez sur View dans la colonne Errors pour voir le détail des erreurs rencontrées. Si l'import est en Failure, vérifiez que le format de vos colonnes correspond exactement aux consignes ci-dessus. Si besoin d'aide, contactez-nous via le chat en bas à droite de votre écran.

Une fois l'import terminé, votre liste apparaît directement dans Audience > Lists.

Lancer une campagne silencieuse de tagging (opt-in)

Vos contacts nouvellement importés ont un statut opt-in unknown (attribut whatsapp_opt_in_status pour WhatsApp, sms_optin_status pour RCS et SMS) s'ils n'ont jamais été identifiés comme opt-in dans WAX auparavant. Avant de pouvoir les cibler dans une campagne classique, mettez à jour ce statut en lançant une campagne silencieuse : une campagne qui ne contient aucun message, uniquement un bloc Opt-In qui tague vos contacts comme opt-in sur le canal choisi. Cet envoi n'est pas facturé.

1. Construire le flow de la campagne

  1. Créez une nouvelle campagne, puis dans l'éditeur de flow, ajoutez un bloc Opt-In relié directement au Start node.

  2. Configurez le bloc : Opt-in contact on, puis choisissez le canal concerné (WhatsApp ou RCS/SMS), cela met à jour respectivement l'attribut whatsapp_opt_in_status ou sms_optin_status du contact.

  3. Si vous devez opt-in vos contacts sur plusieurs canaux, ajoutez un bloc Opt-In distinct pour chacun (par exemple un bloc WhatsApp et un bloc RCS/SMS, tous deux reliés au Start node).

2. Définir l'audience de la campagne

  1. À l'étape Audience, sélectionnez dans Select your audience la liste que vous venez de créer via l'import.

3. Vérifier et programmer l'envoi

  1. À l'étape Review & Schedule, vérifiez le nombre de contacts déjà disponibles dans l'audience sélectionnée. N'envoyez votre campagne qu'une fois l'import totalement terminé (100 % des contacts importés), pour vous assurez qu'aucun contact ne manque à l'envoi.

  2. Choisissez Send Now ou Schedule for later, puis cliquez sur Submit campaign.

Résultat attendu

Une fois l'import terminé et la campagne silencieuse de tagging envoyée, vous retrouverez tous vos contacts dans Contacts. Vous pouvez les filtrer par statut opt-in, et en ouvrant la fiche d'un contact, vous verrez son WhatsApp Opt-in Status (ou SMS Opt-in Status pour RCS/SMS), la date de dernière mise à jour, ainsi que la source de cette mise à jour (le nom de votre campagne de tagging, ou de la personne à l'origine d'une mise à jour manuelle).

Pourquoi mon import est-il refusé ?

Un import CSV peut échouer à trois moments différents :

  • Au moment de l'upload, le fichier est rejeté immédiatement si : il n'est pas au format .csv, deux colonnes portent le même nom, aucune colonne n'est mappée sur le numéro de téléphone, ou une colonne citée dans le mapping est absente du fichier.

  • Pendant le traitement, c'est tout l'import qui échoue si : le fichier est vide, corrompu ou dans un encodage de texte non reconnu, le séparateur (virgule, point-virgule, tabulation) est incohérent ou non détecté, ou si l'import reste bloqué en "in progress" plus d'une heure (le système le marque alors automatiquement en échec).

Si le problème persiste, contactez-nous via le chat en bas à droite.

Avez-vous trouvé la réponse à votre question ?