Vous voulez récupérer automatiquement vos données WAX (contacts, performances de vos campagnes, événements WhatsApp…) dans votre propre système, sans avoir à les télécharger à la main chaque jour ? C'est exactement à ça que sert l'export de données par SFTP.
Qu'est-ce que le SFTP ?
Le SFTP (Secure File Transfer Protocol) est un protocole sécurisé qui permet de transférer des fichiers automatiquement entre deux systèmes, sans intervention manuelle.
Imaginez une boîte aux lettres verrouillée, accessible uniquement avec la bonne clé : chaque jour, WAX y dépose un fichier contenant vos données (par exemple, la liste de vos contacts ou les statistiques de vos campagnes). Votre système vient ensuite récupérer ce fichier automatiquement, en toute sécurité.
C'est une alternative fiable et automatisée à l'export manuel de fichiers CSV : une fois configuré, l'échange se fait tout seul, tous les jours.
Vous pouvez aussi exporter vos données vers un Google Spreadsheet plutôt qu'un serveur SFTP.
Quelques termes que vous allez rencontrer
Lorsque vous configurez une connexion SFTP dans WAX, on vous demande plusieurs informations techniques. Voici ce qu'elles signifient :
Terme | Ce que c'est |
Host (hôte) | L'adresse du serveur qui va recevoir vos fichiers, par exemple |
Port | Le "canal" de communication utilisé par le serveur. Par défaut, |
Username (identifiant) | Le nom d'utilisateur qui permet à WAX de se connecter à votre serveur. |
Password / Clé privée SSH | Le mot de passe est le moyen d'authentification le plus courant ; certains serveurs préfèrent une clé privée SSH, un fichier de sécurité plus robuste qu'un mot de passe (les deux ne sont pas utilisés en même temps). |
Remote directory (dossier distant) | Le chemin exact du dossier, sur votre serveur, où WAX doit déposer les fichiers exportés (par exemple |
Adresses IP à autoriser | Si votre serveur restreint les connexions à certaines adresses, votre équipe technique devra autoriser (whitelister) les adresses IP de WAX, fournies directement dans l'interface. |
Quelles données pouvez-vous exporter depuis WAX ?
WAX permet d'exporter automatiquement plusieurs types de données, au format CSV :
Listes de contacts : une liste ou un segment de contacts (idéal pour synchroniser votre CRM ou votre outil marketing)
Messages WhatsApp : l'historique des messages échangés
Clics (click events) : les clics enregistrés sur vos liens
Performances : les statistiques quotidiennes de vos campagnes et automations (coût, délivrés, lus, clics, conversions…)
Métriques personnalisées : n'importe quel événement standard (delivered, read, opt_in, opt_out…) ou personnalisé que vous suivez dans WAX
Chaque type d'export a ses propres colonnes ; vous trouverez le détail dans la section format des fichiers exportés plus bas.
Prérequis
Pour configurer votre export, il vous faut :
Un accès administrateur à WAX pour accéder aux réglages
Les informations de connexion à votre serveur SFTP : host, port, identifiant, et un mot de passe ou une clé privée SSH, à demander à votre équipe technique ou votre hébergeur si vous ne les avez pas
Le dossier de destination sur votre serveur, où les fichiers doivent être déposés
De savoir si votre serveur restreint les connexions par IP, si oui, prévoyez que votre équipe technique whiteliste les adresses IP de WAX
De définir quoi exporter, et à quel rythme (une fois par jour, à quelle heure en UTC)
Configurer votre export SFTP, pas à pas
Accédez aux exports de données
Rendez-vous dans Settings > Data Export, puis choisissez la catégorie correspondant à la donnée que vous souhaitez exporter : Contact lists (listes de contacts), WhatsApp sent, RCS ou SMS undeliverable par exemple.Définissez le moment de l’envoi
Choisissez l'heure quotidienne (en UTC) à laquelle WAX doit générer et envoyer le fichier.Choisissez la destination : SFTP
Dans le menu déroulant Destination, sélectionnez SFTP (les options Google Spreadsheet et, pour les métriques, Webhook sont aussi disponibles).Autorisez les adresses IP de WAX, si nécessaire
Si votre serveur restreint les connexions par IP, activez l'option correspondante pour afficher la liste des adresses IP de WAX à transmettre à votre équipe technique.Créez votre connexion SFTP
Cliquez sur "Create Secure File Transfer Protocol Connection" et renseignez :Protocol :
SFTPouFTPS(le port se pré-remplit automatiquement : 22 pour SFTP, 990 pour FTPS)Host : l'adresse de votre serveur
Port : à ajuster si votre serveur utilise un port non standard
Username : votre identifiant de connexion
Authentification : mot de passe, ou activez "Authenticate with an SSH private key" pour utiliser une clé privée à la place
<callout icon="🔑" color="gray_bg">Si vous utilisez une clé privée, elle doit être au format OpenSSH, en incluant bien les lignes-----BEGIN OPENSSH PRIVATE KEY-----et-----END OPENSSH PRIVATE KEY-----.</callout>
Indiquez le nom du fichier et le dossier de destination
Renseignez le "File name" souhaité et le "Remote directory" (dossier distant) où WAX doit déposer le fichier sur votre serveur.Choisissez les données à inclure
Selon le type d'export, vous pouvez sélectionner les attributs de contact à inclure ("Include Contact Attributes"), le nom des campagnes/automations à l'origine de l'événement ("Include Campaign and Automation names"), ou les propriétés détaillées de l'événement ("Include Event Properties").Activez et enregistrez
Basculez le statut sur Active, puis cliquez sur "Save". Votre export est prêt.
Un bouton "Backfill" est disponible : il permet de lancer un premier envoi immédiatement, sans attendre le prochain horaire programmé. Pratique pour vérifier que tout fonctionne correctement. |
Que se passe-t-il ensuite ?
Chaque jour, à l'heure que vous avez choisie (en UTC), WAX génère automatiquement le fichier CSV correspondant et le dépose dans le dossier configuré sur votre serveur SFTP.
Aucune action supplémentaire n'est nécessaire de votre côté tant que l'export reste actif.
Vous pouvez à tout moment revenir dans Réglages > Exports de données pour modifier la configuration, mettre l'export en pause (statut Inactive), ou en créer un nouveau pour un autre type de données.
Format des fichiers exportés
Tous les exports WAX sont générés au format CSV, encodé en UTF-8, avec une virgule comme séparateur de colonnes.
Contact list exports
Vous pouvez spécifier quelle liste de contacts WAX sera exportée vers votre serveur SFTP. Cela fonctionne aussi bien sur les segments que sur les listes de contacts statiques.
Header | Type | Description | Example |
phone_number | String | Phone number of the contact, prefixed with its country code | 33612345678 |
CUSTOM* | String | Any custom attribute you want to add, first_name for instance. | Alice |
Cet export permet d'ajouter tout attribut personnalisé dont vous auriez besoin.
Opt out exports
Vous pouvez exporter les désinscriptions (opt-outs) survenues la veille.
Header | Type | Description | Example |
phone_number | String | Phone number of the contact, prefixed with its country code | 33612345678 |
message | String | The message that lead to the opt out event | I want to unsubscribe |
reference_name | String | Name of the entity that lead to the opt out. Could be name of the Campaign / Automation or Agent that opted out the contact. | WAX_CAMPAIGN_SUMMER |
updated_at | String (ISO 8601 formatted Time) | Time at which the opt out happened | Tue, 08 Apr 2025 08:42:25.015735000 UTC +00:00 |
CUSTOM* | String | Any custom attribute you want to add, first_name for instance. | Alice |
Cet export permet d'ajouter tout attribut personnalisé dont vous auriez besoin.
Opt in exports
Vous pouvez exporter les inscriptions (opt-ins) survenues la veille.
Header | Type | Description | Example |
phone_number | String | Phone number of the contact, prefixed with its country code | 33612345678 |
message | String | The message that lead to the opt in event | I want to unsubscribe |
reference_name | String | Name of the entity that lead to the opt in. Could be name of the Campaign / Automation or Agent that opted in the contact. | WAX_CAMPAIGN_SUMMER |
updated_at | String (ISO 8601 formatted Time) | Time at which the opt out happened | Tue, 08 Apr 2025 08:42:25.015735000 UTC +00:00 |
CUSTOM* | String | Any custom attribute you want to add, first_name for instance. | Alice |
Cet export permet d'ajouter tout attribut personnalisé dont vous auriez besoin.
Performance exports
Vous pouvez exporter la performance de vos automatisations et campagnes avec 1 ligne par jour et par entité (Automatisation ou Campagne)
Header | Type | Description | Example |
date | String (ISO 8601 formatted Time) | Date of the performance summary | Tue, 08 Apr 2025 08:42:25.015735000 UTC +00:00 |
reference_name | String | Name of the entity that is being reported. | WAX_CAMPAIGN_SUMMER |
reference_type | String (Automation / Broadcast) | Type of the entity. Automation or Broadcast for a Campaign. | Automation |
reference_id | Integer | Id of the entity. | 1234 |
cost_eur | Integer | Total cost of the conversations (including META and WAX markups) in euros and cents. 10 euros in the example. | 100.00 |
delivered | Integer | Count of conversations that have been delivered this day. | 10000 |
read | Integer | Count of conversations that have been read this day. | 9000 |
interacted | Integer | Count of conversations that received replies or clicks on urls | 7500 |
quick_reply | Integer | Count of conversations that received replies from quick replies buttons | 6500 |
clicked | Integer | Count of conversations that received clicks on URLS | 6000 |
converted_read | Integer | Count of conversions that happened within the read attribution window. | 200 |
revenue_read_eur | Integer | Sum of revenues from conversions that happened within the read attribution window. In Euros. | 200.00 |
converted_interacted | Integer | Count of conversions that happened within the interacted attribution window. | 400 |
revenue_interacted_eur | Integer | Sum of revenues from conversions that happened within the interacted attribution window. In Euros. | 400.00 |
converted_clicked | Integer | Count of conversions that happened within the clicked attribution window. | 600 |
revenue_clicked_eur | Integer | Sum of revenues from conversions that happened within the clicked attribution window. In Euros. | 600.00 |
opt_in | Integer | Count of contacts that opted in. | 800 |
opt_out | Integer | Count of contacts that opted out. | 80000 |
billed_messages | Integer | Count of billed messages. | 10000 |
Vous ne pourrez pas ajouter d’attributs dans cet export.
Metric Exports
Vous pouvez exporter n'importe quel type de métrique souhaité, qu'il s'agisse d'une métrique personnalisée ou des métriques standards fournies par WAX :
delivered
read
clicked
failed
quick_reply
opt_in
opt_out
billed_message
interacted
Header | Type | Description | Example |
metric_name | String | Name of the metric like delivered, read, clicked, … | delivered |
unique_id | String | The ID of the metric event, provided by WAX when it is a WAX internal metric such as delivered, or by your system in the case of a custom metric | 12345 |
occurred_at | String (ISO 8601 formatted Time) | The time at which the metric event occurred. | Tue, 08 Apr 2025 08:42:25.015735000 UTC +00:00 |
phone_number | String | The phone number of the contact for which that metric event occurred. | 33612345678 |
CUSTOM* | String | Any custom attribute you want to add, first_name for instance. | Alice |
En cas de problème
L'enregistrement de la connexion SFTP échoue
Vérifiez que le host, le port et le username sont bien renseignés, et qu'un mot de passe ou une clé privée est fourni (pas les deux, pas aucun des deux). Le FTPS nécessite obligatoirement un mot de passe (la clé privée n'est disponible qu'en SFTP).
L'enregistrement de l'export échoue
Si la destination est SFTP, le "File name" et le "Remote directory" sont obligatoires : assurez-vous qu'ils sont bien renseignés.
Les fichiers n'arrivent pas sur votre serveur
Vérifiez dans l'ordre : que l'export est bien sur Active ; que l'heure programmée correspond bien à un horaire UTC (attention au décalage avec votre fuseau horaire local) ; que le dossier distant indiqué existe et que votre utilisateur SFTP a les droits d'écriture dessus ; et, si votre serveur filtre par IP, que les adresses IP de WAX ont bien été whitelistées par votre équipe technique.
Votre clé privée SSH est refusée
Vérifiez qu'elle est bien au format OpenSSH complet, avec ses lignes d'en-tête et de pied (BEGIN/END OPENSSH PRIVATE KEY), copiée sans caractères ajoutés ni tronquée.
Questions fréquentes
Dans quel format sont les fichiers exportés ?
Uniquement en CSV pour le moment.
À quelle fréquence les exports sont-ils envoyés ?
Une fois par jour, à l'heure UTC que vous choisissez lors de la configuration.
Le SFTP est-il sécurisé ?
Oui : les échanges via SFTP sont chiffrés de bout en bout, et si vous utilisez une clé privée SSH, celle-ci est stockée chiffrée dans WAX.
Puis-je créer plusieurs exports (contacts, performances, métriques…) vers la même connexion SFTP ?
Oui, une même connexion SFTP peut être réutilisée pour plusieurs exports, vers des dossiers différents si besoin.
Qui contacter si je suis bloqué ?
Votre Customer Success Manager ou notre support technique pourra vous accompagner dans la configuration.