Si vous avez mis en place un export Google Sheets or SFTP, cet article explique ce que signifie réellement chaque colonne de votre fichier.
Les exports WAX existent en plusieurs types :
Un export par événement WhatsApp (ou RCS ou SMS) : Sent, Delivered, Clicked, Quick Reply, Failed, Undeliverable, Manual Inbound Message, Interacted, Billed Message, Opt In, Opt Out (ils apparaîtront comme “Metric exports” dans le tableau ci-dessous)
Plus des exports dédiés pour
Les performance,
Messages WhatsApp,
Click Events, et
Contact Lists
Toutes les colonnes n’apparaissent pas dans tous les exports. Utilisez le tableau ci-dessous pour trouver la colonne que vous cherchez, voir dans quel(s) export(s) elle apparaît, et comprendre exactement ce qu’elle mesure.
Metric exports
Column name | Definition | Expected value type |
unique_id | Identifiant reliant la ligne à son message/interaction source ; utilisé pour dédupliquer et corréler un événement à travers l’entonnoir de délivrabilité | String/identifier |
phone_number | Numéro WhatsApp du contact (colonne built-in, obligatoire) | String (phone number) |
occurred_at | Horodatage auquel l’événement s’est réellement produit | Timestamp |
metric_name | Nom interne du type d’événement correspondant à cette métrique — ex. whatsapp_sent, whatsapp_delivered ; c’est ce champ qui distingue “Sent” de “Delivered”, etc. | String (enum-like) |
reference_name (optional — org toggle "include reference name") | Nom de l’Automation ou du Broadcast auquel l’événement est rattaché | String |
reference_type (optional — same toggle) | Automation ou Broadcast | String (enum) |
reference_id (optional — same toggle) | Identifiant DB de l’Automation/Broadcast | Number (integer) |
properties (optional — org toggle "include properties") | JSON brut des données additionnelles spécifiques à l’événement ; le contenu varie selon le type de métrique (ex. Billed Message → category/currency/channel, jamais une valeur de coût — la plupart des autres types de métriques exportent un objet vide) | JSON/text |
phone_number (attribute) (optional) | Même numéro de téléphone, ajouté une seconde fois comme attribut de contact sélectionnable (peut dupliquer la colonne built-in) | String |
first_name (optional) | Prénom du contact | String |
last_name (optional) | Nom de famille du contact | String |
email (optional) | Email du contact | String (email) |
language (optional) | Langue du contact | String |
whatsapp_valid (optional) | Indique si ce numéro est confirmé joignable sur WhatsApp — TRUE après une délivrabilité confirmée, FALSE après un échec d’envoi confirmé, vide = jamais confirmé à ce stade | Boolean (nullable) |
whatsapp_opt_in_status (optional) | Statut de consentement sur le canal WhatsApp : opted_in, opted_out, ou unknown (par défaut) | String (enum) |
sms_opt_in_status (optional) | Idem, pour le consentement sur le canal SMS | String (enum) |
external_id (optional) | Identifiant du contact dans un système externe (ex. via une intégration) | String |
created_at (contact) (optional) | Date de création de la fiche contact | Date |
(any custom attribute) (optional) | N’importe quel attribut custom défini par l’org (tags, champs personnalisés) | Varies by attribute type |
WhatsApp Messages
Column name | Definition | Expected value type |
id | Identifiant interne DB de l’enregistrement (WhatsappMessage id) | Number (integer) |
phone_number | Numéro WhatsApp du contact (colonne built-in, obligatoire) | String (phone number) |
timestamp | Date/heure de création du message | Timestamp |
kind | Type de message — template, temporary_template, etc. | String |
category | Catégorie de template WhatsApp Business — marketing / utility / authentication ; vide si non applicable | String |
inbound | Indique si le message provient du contact (TRUE) ou s’il a été envoyé par WAX (FALSE) | Boolean |
whatsapp_error_code | Code d’erreur Meta/360Dialog si le message n’a pas pu être envoyé ; vide s’il n’y a pas d’erreur | String/code |
message_payload | Contenu brut du message — body/params d’un template, ou texte libre | Text (JSON-like string) |
agent_email | Email de l’agent humain ayant envoyé le message ; vide pour les envois automatisés / templates | String (email) |
reference_name (optional — org toggle "include reference name") | Nom de l’Automation ou du Broadcast auquel le message est rattaché | String |
reference_type (optional — same toggle) | Automation ou Broadcast | String (enum) |
reference_id (optional — same toggle) | Identifiant DB de l’Automation/Broadcast | Number (integer) |
phone_number (attribute) (optional) | Même numéro de téléphone, ajouté une seconde fois comme attribut de contact sélectionnable | String |
first_name (optional) | Prénom du contact | String |
last_name (optional) | Nom de famille du contact | String |
email (optional) | Email du contact | String (email) |
language (optional) | Langue du contact | String |
whatsapp_valid (optional) | Indique si ce numéro est confirmé joignable sur WhatsApp — TRUE après une délivrabilité confirmée, FALSE après un échec d’envoi confirmé, vide = jamais confirmé à ce stade | Boolean (nullable) |
whatsapp_opt_in_status (optional) | Statut de consentement sur le canal WhatsApp : opted_in, opted_out, ou unknown (par défaut) | String (enum) |
sms_opt_in_status (optional) | Idem, pour le consentement sur le canal SMS | String (enum) |
external_id (optional) | Identifiant du contact dans un système externe (ex. via une intégration) | String |
created_at (contact) (optional) | Date de création de la fiche contact | Date |
(any custom attribute) (optional) | N’importe quel attribut custom défini par l’org (tags, champs personnalisés) | Varies by attribute type |
Click Events
Column name | Definition | Expected value type |
id | Identifiant interne DB de l’enregistrement (ClickEvent id) | Number (integer) |
phone_number | Numéro WhatsApp du contact (colonne built-in, obligatoire) | String (phone number) |
timestamp | Date/heure du clic | Timestamp |
kind | Type de clic — url, quick_reply, list_option, flow, dial_phone, ou ctwa (Click-to-WhatsApp ad touchpoint) | String (enum) |
button_text | Texte du bouton cliqué ; renseigné pour les clics quick-reply/list/dial-phone, vide pour les clics URL simples | String |
url | URL de destination pour un clic de type : url ; vide sinon | String (URL) |
reference_name (optional — org toggle "include reference name") | Nom de l’Automation ou du Broadcast auquel le clic est rattaché | String |
reference_type (optional — same toggle) | Automation ou Broadcast | String (enum) |
reference_id (optional — same toggle) | Identifiant DB de l’Automation/Broadcast | Number (integer) |
phone_number (attribute) (optional) | Même numéro de téléphone, ajouté une seconde fois comme attribut de contact sélectionnable | String |
first_name (optional) | Prénom du contact | String |
last_name (optional) | Nom de famille du contact | String |
email (optional) | Email du contact | String (email) |
language (optional) | Langue du contact | String |
whatsapp_valid (optional) | Indique si ce numéro est confirmé joignable sur WhatsApp — TRUE après une délivrabilité confirmée, FALSE après un échec d’envoi confirmé, vide = jamais confirmé à ce stade | Boolean (nullable) |
whatsapp_opt_in_status (optional) | Statut de consentement sur le canal WhatsApp : opted_in, opted_out, ou unknown (par défaut) | String (enum) |
sms_opt_in_status (optional) | Idem, pour le consentement sur le canal SMS | String (enum) |
external_id (optional) | Identifiant du contact dans un système externe (ex. via une intégration) | String |
created_at (contact) (optional) | Date de création de la fiche contact | Date |
(any custom attribute) (optional) | N’importe quel attribut custom défini par l’org (tags, champs personnalisés) | Varies by attribute type |
Performances
One row per day per Automation/Broadcast. No contact-level or optional columns.
Column name | Definition | Expected value type |
date | Jour calendaire de la ligne | Date |
reference_name | Nom de l’Automation ou du Broadcast auquel l’agrégat est rattaché (obligatoire ici) | String |
reference_type | Automation ou Broadcast | String (enum) |
reference_id | Identifiant DB de l’Automation/Broadcast | Number (integer) |
cost_eur | Coût de messagerie WhatsApp/RCS/SMS facturé par Meta/BSP pour ce jour + cette référence (hors ad spend) | Currency, EUR (decimal) |
delivered | Nombre d’événements “delivered” ce jour-là pour cette référence | Number (integer count) |
read | Nombre d’événements “read” | Number (integer count) |
interacted | Nombre d’événements “interacted” — inclut tous les types de clic sauf ctwa | Number (integer count) |
quick_reply | Nombre de clics sur des boutons quick-reply | Number (integer count) |
clicked | Nombre de clics sur des liens/URL spécifiquement | Number (integer count) |
converted_read | Nombre de commandes (Shopify/PrestaShop/etc.) attribuées à un touchpoint “read” antérieur, dans la fenêtre d’attribution “read” configurable de l’org | Number (integer count) |
converted_interacted | Idem, attribué à un touchpoint “interacted” | Number (integer count) |
converted_clicked | Idem, attribué à un touchpoint “clicked” | Number (integer count) |
revenue_read_eur | Revenu de sous-total de commande (EUR) attribué à “read” | Currency, EUR (decimal) |
revenue_interacted_eur | Idem, attribué à “interacted” | Currency, EUR (decimal) |
revenue_clicked_eur | Idem, attribué à “clicked” | Currency, EUR (decimal) |
whatsapp_opt_in | Nombre d’événements opt-in ce jour-là | Number (integer count) |
whatsapp_opt_out | Nombre d’événements opt-out ce jour-là | Number (integer count) |
billed_message | Nombre de messages facturés (WhatsApp + RCS + SMS combinés) ce jour-là — uniquement un compte, aucune valeur de coût n’existe au niveau message | Number (integer count) |