Listes

Une liste, c'est un ensemble d'abonnés qui reçoivent la même chose. Elle décide par où partent les messages (un compte, un groupe de SIM, ou le compte des modèles), comment lire un numéro écrit en national, quelle séquence accueille les nouveaux inscrits, et si le marketing exige une preuve de consentement.

Concept

Une liste répond à trois besoins :

1. Segmenter. Les acheteurs d'un pays, les leads d'une offre, les clients d'une boutique : chacun sa liste, chacun sa séquence.
2. Fixer l'expéditeur, et le métier. Les envois d'une liste partent de son compte, ou tournent entre les SIM d'un même groupe (voir le tableau ci-dessous pour les exceptions). Cette cible dit aussi le métier de ses messages : commandes ou marketing.
3. Servir d'adresse stable. Un déclencheur de conversion vise une liste ; une landing ou une campagne y est reliée ; un import remplit une liste ; un agent inscrit dans une liste. La séquence, elle, peut changer derrière.

Créer une liste

WhatsApp Marketing → Listes → Nouvelle liste.

La séquence par défaut doit appartenir à la liste et être active : on crée donc la liste, puis sa séquence, puis on revient la poser par défaut. Une séquence de cible « Commande annulée » ne peut pas l'être (elle démarre seule, à l'annulation) : le menu ne la propose pas.

Une liste par pays. Un numéro écrit en national se lit avec le pays par défaut de la liste. Dans la liste d'un autre pays, il est refusé au mieux ; au pire, il devient le numéro de quelqu'un d'autre : le « 06 12 34 56 78 » d'un client français, dans une liste marocaine, se lit +212 6 12 34 56 78. Donnez donc à chaque pays sa liste, avec son pays par défaut. Et comme la cible d'une liste fixe son métier (ci-dessous), un pays qui a des commandes et des campagnes a deux listes : par exemple « Brésil — Commandes » vers le groupe Commandes, « Brésil — Marketing » vers le groupe Marketing.

Compte, groupe, ou rien

Une liste qui vise un compte n'accepte, dans ses séquences, que des modèles de ce compte — ou, si ce compte est une SIM rangée dans un groupe, les modèles locaux des SIM de ce groupe. Une liste qui vise un groupe accepte les modèles locaux des SIM du groupe.

Le métier d'une liste

Sur les cartes SIM rangées en groupes, la cible d'une liste dit aussi le métier de ses séquences, sans autre réglage :

Ce métier est revérifié juste avant chaque envoi : un message n'est jamais envoyé par une SIM rangée dans un groupe de l'autre métier (sauf un message peut-être déjà parti d'elle, qui ne change jamais de numéro). Rattachez donc une liste de suivi de commande au groupe Commandes, et une liste de campagne au groupe Marketing. Rien ne relit les modèles de la liste au moment du rattachement : c'est ce geste qui déclare le métier (voir Rotation).

Changer le compte d'une liste

C'est refusé tant que des étapes de ses séquences utilisent des modèles d'un autre compte : elles continueraient de partir de l'ancien numéro, sur ses plafonds et sa note de qualité, pendant que l'écran afficherait le nouveau. Le chemin : mettez le compte de la liste à « Aucun », repointez chaque étape sur un modèle du nouveau compte, puis posez le nouveau compte. Les messages déjà en file gardent leur numéro d'origine — tant que ce numéro peut envoyer et que son groupe, s'il en a un, a le métier que la nouvelle cible donne à la liste. L'écran dit combien de messages restent ainsi derrière, et comment les annuler depuis le Journal des envois (filtre sur la liste, statut « En file »).

Les abonnés

Abonnés sur la ligne d'une liste déplie le panneau des abonnés : recherche par nom ou par numéro, filtre par statut, filtre par commande, sélection et actions en masse.

La colonne Commande dit où en est la commande qui a inscrit l'abonné : Active, Annulée, ou « — » (abonné sans commande, comme un prospect, ou commande supprimée). Elle est lue sur les commandes elles-mêmes à chaque affichage, jamais recopiée : annuler une commande la fait passer à « Annulée » tout de suite — sauf si une autre commande du même client tient dans la liste (un doublon annulé, un rachat en cours dans un funnel à upsells) : l'abonné reste « Active ». Deux cas ne sont pas vus : un rachat par un funnel à upsells pendant les quelques secondes entre la fin du funnel et l'inscription que fait son message (et jamais, si ce message échoue : la colonne reste alors « Annulée »), et, pour les commandes passées avant la mise à jour qui a introduit cette règle, une commande plus ancienne que celle que l'abonné portait à ce moment-là (au plus 30 jours après la mise à jour). Cette lecture ne relit que les commandes de l'abonné, jamais toutes celles de la campagne : le tableau, le filtre et l'export gardent leur vitesse sur une grosse liste (avant le correctif du 2026-09-27, le filtre Commande annulée pouvait prendre une demi-minute). C'est elle qui décide des séquences de relance après annulation.

Comment un numéro entre

Toutes les entrées passent par la même règle — déclencheur, ajout à la main, import, agent :

• Le numéro est converti au format international avec le pays donné, sinon le pays par défaut de la liste. Un doute est un refus, avec sa raison (pays_requis, trop_court, indicatif_inconnu…). En Argentine, où la forme nationale ne se convertit pas mécaniquement, seul le format international est accepté.
• Un numéro bloqué pour tout dans les Suppressions est refusé (supprime).
• La liste doit être active et non archivée (liste_inactive).
• Un abonné désinscrit reste désinscrit. Un client qui a écrit STOP puis remplit un autre formulaire n'a pas retiré son STOP : aucune inscription automatique ne le réactive.
• Une ré-inscription ne relance rien. L'abonné garde sa date d'inscription (les délais des étapes en dépendent) et sa première source ; son nom et ses champs personnalisés sont complétés ; sa preuve de consentement n'est remplacée que par une preuve plus récente, jamais effacée.

Ajouter à la main

Ajouter un abonné : numéro, pays (celui de la liste si vide), nom, source (admin par défaut). Un refus s'affiche avec sa raison, et rien n'est écrit. Une preuve de consentement ne se saisit pas : un champ consentement envoyé à l'API d'ajout est ignoré, l'abonné est ajouté sans.

Importer

Importer : un numéro par ligne, 5 000 lignes au plus par lot. Les numéros sont lus avec le pays par défaut de la liste. Une ligne refusée n'arrête pas le lot : le rapport donne le nombre d'ajoutés, de déjà présents et de refusés, et pour chaque refus le numéro de ligne et la raison. Les deux écritures d'un même mobile brésilien ou argentin comptent pour un ajouté et un déjà présent (voir « Les numéros à deux formes », plus bas). Une liste en pause ou archivée refuse l'import.

Un import ne crée pas de consentement. Un fichier de numéros ne prouve pas que ces gens ont accepté vos messages, et un champ consentement dans une ligne importée est ignoré. Sur une liste qui exige le consentement, ils ne recevront que les modèles UTILITY. Et sur une carte SIM, écrire à des gens qui ne vous connaissent pas est la première cause de bannissement.

Exporter

Exporter CSV télécharge les abonnés de la liste (filtres de recherche, de statut et de commande appliqués ; la colonne statut_commande dit active, annulee ou rien), 50 000 lignes au plus. Le fichier se construit par pages de 500 abonnés, et chaque page ne calcule que ses propres lignes : une liste de 50 000 abonnés s'exporte en quelques secondes (avant ce correctif, plus d'une minute, et le téléchargement pouvait être coupé en route). Le fichier s'ouvre dans un tableur : les cellules qui commencent par +, =, - ou @ sont précédées d'une apostrophe pour qu'aucune formule ne s'exécute — les numéros au format international la portent donc aussi.

Pour le consentement, le fichier donne la source, la date, la version du texte accepté et sa langue (consent_version, consent_language). Pas le texte lui-même (la version l'identifie : deux textes différents ont deux versions), ni l'adresse IP et le navigateur (des données personnelles de plus dans un fichier qui circule) : la chronologie de l'abonné les montre.

Désinscrire, supprimer, bloquer : trois gestes différents

La chronologie d'un abonné

Chronologie montre tous ses envois et tous les événements reçus pour lui — y compris ceux arrivés sous une autre écriture de son numéro (un STOP, un clic sur un bouton).

Elle s'ouvre sur sa preuve de consentement : la date, la source (lead, checkout, funnel_checkout), la version du texte, sa langue, l'adresse IP et le navigateur de la personne qui a coché la case, et le texte exact qu'elle a accepté. Dans le tableau, la colonne Consentement en donne l'essentiel : la date, puis source · langue · version. Un abonné inscrit avant la mise à jour v135 a bien une preuve (date, texte, source), mais ni version, ni langue, ni IP, ni navigateur : l'écran l'écrit « version non gardée ». Ce n'est pas une absence de consentement, et rien ne change pour ses envois.

Le consentement exigé

La case Exiger un consentement ne refuse pas l'inscription : elle agit au moment de l'envoi.

• Un modèle MARKETING ne part qu'aux abonnés qui ont une preuve de consentement. Les autres sont sautés, avec la raison consentement_absent au journal.
• Un modèle UTILITY (ou AUTHENTICATION) part quand même : la suite d'une commande n'est pas du marketing.

La preuve ne vient que de la case cochée par le client — au checkout, dans un formulaire de lead, au checkout d'un funnel ou dans le formulaire d'une étape de funnel qui l'affiche (réglage de l'étape dans le Funnel Builder). Elle atteint une liste par deux chemins : le formulaire d'une landing reliée à cette liste (choix « Liste WhatsApp » de la landing), et la commande payée d'une campagne reliée à cette liste (choix « Liste WhatsApp post-achat »), qui reprend la preuve gardée avec la commande — voir Déclencheurs. Un ajout à la main, un import, une inscription par un agent ou par un déclencheur de conversion n'en portent pas : ces abonnés-là ne reçoivent que les modèles UTILITY tant que la liste l'exige.

Décochée, la liste laisse partir le marketing sans preuve. Laissez-la cochée, sauf raison documentée.

Les numéros à deux formes

Au Brésil, en Argentine et au Mexique, un même mobile s'écrit de deux façons (le compte WhatsApp du client peut garder l'ancienne). Trackily les traite comme un seul contact : un STOP reçu sous une forme bloque l'autre, une recherche sous une forme trouve les messages partis sous l'autre, et le client n'a qu'une seule SIM habituelle par métier.

Un contact, un abonné par liste. Un client déjà dans la liste sous une écriture, qui revient sous l'autre (un lead avec le 9, puis une commande sans), retombe sur son abonné : « déjà présent », rien n'est créé. Il garde sa date d'inscription, sa séquence n'est pas relancée, et s'il s'était désinscrit, il le reste. Sa fiche garde la première écriture reçue, et c'est à elle que partent les messages. Avant la mise à jour du 2026-09-26, les deux écritures faisaient deux abonnés, et le client recevait chaque étape deux fois.

Les doublons créés avant cette date ne sont pas fusionnés : c'est à vous de choisir quelle fiche garder (sa chronologie, sa preuve de consentement). Pour les trouver, cherchez le numéro dans le panneau Abonnés de la liste : la recherche couvre les deux écritures, les deux fiches sortent ensemble. Supprimez ou désinscrivez celle que vous ne gardez pas.

Le même client dans deux listes reste deux abonnés, un par liste : ce n'est pas un doublon.

Un numéro que WhatsApp déclare inexistant ne change pas de statut dans la liste : il est bloqué dans les Suppressions (cause « Numéro invalide »), ce qui suffit à ce que plus rien ne lui parte.

Les mesures

Mesures sur la ligne d'une liste : les 30 derniers jours. Envois créés, partis, taux de livraison, de lecture et d'échec, répartition par statut. Les taux se calculent sur les messages partis, jamais sur la file : mille messages en attente ne doivent pas faire croire que personne ne lit.

Archiver une liste

Archiver est définitif : une liste archivée garde son histoire (abonnés, séquences, journal) mais ne se modifie plus et ne revient pas. Rien n'est annulé : les messages déjà programmés partent. Pour les arrêter, désinscrivez d'abord les abonnés concernés, ou annulez les messages depuis le journal.

Via l'agent IA

{
  "name": "create_whatsapp_list",
  "arguments": {
    "name": "Acheteurs — relance",
    "default_country": "FR",
    "require_consent": true
  }
}

Puis enroll_whatsapp_subscriber (list_id, telephone, pays, nom) pour inscrire un numéro : un numéro illisible, un contact bloqué ou un désinscrit reviennent comme des refus lisibles, pas comme des erreurs. L'agent ne peut pas fabriquer une preuve de consentement. archive_whatsapp_list demande une confirmation en deux temps.

Erreurs courantes

• « Raison : pays_requis » — le numéro est écrit en national et la liste n'a pas de pays par défaut. Renseignez-le, ou tapez le numéro au format international.
• « Raison : supprime » — le numéro est bloqué pour tout dans les Suppressions.
• « Raison : abonne_unsubscribed » — ce numéro s'est désinscrit de cette liste ; il n'y revient pas par une inscription.
• Les abonnés importés ne reçoivent rien — la liste exige le consentement et la séquence utilise des modèles MARKETING : un import n'apporte pas de preuve.
• « Cette liste viserait à la fois le groupe de SIM … et le compte … » — une liste vise l'un ou l'autre : videz l'un des deux champs.
• La séquence ne démarre pas pour les abonnés déjà présents — normal : seuls les nouveaux inscrits entrent dans la séquence par défaut.
• Les messages de la liste attendent (aucune_sim_disponible), puis échouent en vocation_sans_sim — le métier de la liste n'est pas celui du groupe des SIM qui portent ses modèles : par exemple une liste sans cible (donc Marketing) dont les modèles appartiennent à une SIM du groupe Commandes. Rattachez la liste au groupe qui correspond à ce qu'elle envoie, ou changez les modèles de ses étapes.

Voir aussi

• Séquences — ce que la liste envoie
• Déclencheurs — ce qui remplit la liste tout seul
• Suppressions — bloquer un numéro partout
• Rotation — faire viser un groupe de SIM