WhatsApp : connecter un numéro et envoyer des messages

Branchez un ou plusieurs numéros WhatsApp (API officielle de Meta, WaSender ou WaChap) puis écrivez à vos clients depuis Xperience, un message à la fois ou en masse, avec un aperçu de ce que le client verra.

Disponible à partir du plan Pro

Comment faire

1Choisissez le type de numéro : Meta (officiel, conseillé), WaSender ou WaChap (session WhatsApp Web, plus simple mais plus risqué).
2Ouvrez Paramètres > Intégrations > WhatsApp puis Ajouter un numéro.
3Choisissez le fournisseur, donnez un nom au numéro (Support, Ventes…), collez les identifiants et la clé, puis Connecter.
4Envoyez un test vers votre propre numéro avant de contacter un client.
5Dans Xperience, cliquez sur l'avion d'une ligne : choisissez le numéro, le message (ou un modèle Meta), vérifiez l'aperçu et Envoyer.
6Pour plusieurs clients, utilisez Envoi en masse : destinataires, message, délai en minutes entre chaque envoi, puis Lancer l'envoi.
7Avec plusieurs numéros, définissez celui par défaut ; chaque envoi permet de choisir Envoyer depuis.

Quel type de numéro choisir ?

Divitrack envoie les messages avec votre propre numéro, par l'un de trois fournisseurs. Vous pouvez en mélanger plusieurs.

	Meta (API officielle)	WaSender	WaChap
Statut	Officiel	Non officiel (WhatsApp Web)	Non officiel (WhatsApp Web)
Risque pour le numéro	Faible, mais des règles strictes	Plus élevé en cas d'abus	Plus élevé en cas d'abus
Texte libre	Seulement dans les 24 h après un message du client	Toujours	Toujours
Modèles approuvés	Oui (obligatoires hors fenêtre de 24 h)	Non	Non
Mise en route	Plus longue (compte Meta, jeton)	Rapide (QR code)	Rapide (QR code)
Identifiants demandés	Phone number ID, ID du compte WhatsApp Business, jeton	Clé API de la session	Instance ID et Access token

Numéro dédié

Quel que soit le fournisseur, utilisez de préférence un numéro dédié à Divitrack plutôt que votre numéro personnel.

Connecter un numéro WaSender

WaSender relie une session WhatsApp Web à votre numéro. Divitrack n'a besoin que de la clé API de la session.

1Dans WaSender, créez une session et scannez le QR code avec le téléphone du numéro à utiliser. Attendez que la session soit connectée.
2Copiez la clé API de la session (pas la clé de votre compte).
3Dans Divitrack, ouvrez Paramètres > Intégrations > WhatsApp puis Ajouter un numéro.
4Choisissez WaSender, donnez un nom au numéro, collez la clé, puis Connecter.
5Saisissez votre propre numéro dans le bloc de test et cliquez sur Envoyer le test.

Si le test échoue avec « Clé WaSender refusée », vérifiez que vous avez copié la clé de la session et que la session est toujours connectée.

Connecter un numéro WaChap

WaChap fonctionne par instance : Divitrack a besoin de l'Instance ID et de l'Access token de l'instance connectée.

1Dans WaChap, créez une instance, scannez le QR code et vérifiez qu'elle est connectée.
2Copiez l'Instance ID et l'Access token.
3Dans Divitrack, Ajouter un numéro, choisissez WaChap, nommez le numéro.
4Collez l'Instance ID et l'Access token, puis Connecter.
5Envoyez un test vers votre propre numéro.

Connecter l'API officielle de Meta

C'est l'option la plus sûre pour votre numéro, mais la mise en route est plus longue. Vous aurez besoin d'un compte Meta Business vérifié.

1Allez sur developers.facebook.com > Mes applications > Créer une application (type Entreprise), rattachée à votre portefeuille d'entreprise vérifié.
2Dans l'application, ouvrez Cas d'utilisation et ajoutez Se connecter avec WhatsApp : un menu WhatsApp apparaît.
3Ouvrez Étape 2 : configuration de la production et ajoutez votre numéro. Il ne doit pas être déjà enregistré dans un autre compte WhatsApp Business ; il sera retiré de l'application WhatsApp Business du téléphone.
4Ajoutez aussi un moyen de paiement dans les paramètres du compte WhatsApp (les messages initiés par l'entreprise sont facturés par Meta).
5Relevez le Phone number ID : dans le Gestionnaire WhatsApp > Outils du compte > Numéros de téléphone, cliquez sur le numéro. C'est un nombre d'environ 15 chiffres.
6Relevez l'ID du compte WhatsApp Business : dans Business Suite > Paramètres > Comptes > Comptes WhatsApp, il s'affiche sous le nom du compte.
7Créez un jeton permanent : Business Suite > Paramètres > Utilisateurs > Utilisateur(ice)s système > Ajouter (rôle Admin), assignez-lui l'application et le compte WhatsApp avec le contrôle total, puis Générer un token.
8Choisissez l'application, mettez l'expiration sur Jamais et cochez whatsapp_business_messaging et whatsapp_business_management. Copiez le jeton tout de suite : il ne s'affiche qu'une fois.
9Dans Divitrack : Ajouter un numéro > Meta, collez le Phone number ID, l'ID du compte WhatsApp Business et le jeton, puis Connecter.
10Écrivez d'abord, depuis votre téléphone, un message vers le numéro d'entreprise (cela ouvre la fenêtre de 24 h), puis cliquez sur Envoyer le test vers votre téléphone.

Vérification d'identité

Avant de générer un jeton, Meta peut demander de confirmer votre identité par e-mail. Vérifiez qu'une adresse e-mail confirmée est liée au compte Facebook, puis réessayez.

Trois identifiants différents

L'ID du compte (WABA), le Phone number ID de votre numéro et celui du numéro de test de Meta sont trois valeurs distinctes. Une erreur « Object with ID … does not exist » vient presque toujours d'un mauvais Phone number ID.

Ajouter plusieurs numéros

Le plan Pro inclut 1 numéro ; le plan Business permet de connecter jusqu'à 5 numéros par boutique, de fournisseurs différents (par exemple un Meta pour les ventes et un WaSender pour le support).

Ajouter un numéro depuis Paramètres > Intégrations > WhatsApp : répétez les étapes du fournisseur choisi.
Le premier numéro devient Par défaut. Cliquez sur Définir par défaut pour changer.
Modifier remplace la clé d'un numéro : la clé n'est jamais réaffichée, collez-la à nouveau.
La corbeille déconnecte un numéro et supprime sa clé ; si c'était le numéro par défaut, un autre prend le relais.
Le bloc de test permet de choisir Envoyer depuis quand il y a plusieurs numéros.

Les limites (6 secondes entre deux messages, 200 par jour) comptent numéro par numéro : répartir sur deux numéros double la capacité du jour.

Recevoir les réponses de vos clients

Pour voir ce que vos clients vous répondent dans la Boîte de réception de Divitrack, collez l'adresse de réception de chaque numéro dans le tableau de bord de son fournisseur. Elle se trouve dans Paramètres > Intégrations > WhatsApp > Recevoir les réponses de vos clients.

1Meta : sur developers.facebook.com, ouvrez l'application liée à votre numéro (celle dont vous avez copié le jeton), puis WhatsApp > Configuration > Webhook > Modifier. Collez l'adresse comme URL de rappel et le jeton de vérification affiché par Divitrack, puis Vérifier et enregistrer. Cliquez sur Gérer et abonnez-vous au champ messages.
2WaSender : dans votre session, Webhook : collez l'adresse et activez les événements messages.received et messages.upsert (le second fait aussi apparaître dans la boîte ce que vous écrivez depuis votre propre WhatsApp : téléphone ou WhatsApp Web). Facultatif : copiez le Webhook Secret de WaSender dans Divitrack pour vérifier chaque appel.
3WaChap : collez l'adresse dans le webhook de votre instance. Le format n'étant pas documenté, envoyez-vous un message test depuis un autre numéro et vérifiez qu'il apparaît.
4Sécurité (Meta) : collez le Secret de l'application (Paramètres de l'application > De base) dans Divitrack pour que chaque appel soit vérifié par signature.

Application Meta en mode Développement

Tant que l'application est en mode Développement, Meta n'envoie que les messages de ses administrateurs et testeurs. Passez-la en mode Actif pour recevoir ceux de vos vrais clients.

Un client qui répond « STOP » (ou « arrêt », « désabonner ») est ajouté automatiquement à la liste des désinscrits. Dans la Boîte de réception, votre réponse part par défaut du numéro sur lequel la conversation a lieu, et vous pouvez en choisir un autre avec Depuis.

Envoyer un message à un client

1Ouvrez Xperience et choisissez l'onglet (Relances, Suivi, Upsell ou Anniversaires), ou ouvrez la fiche d'un client et cliquez sur Écrire sur WhatsApp. L'agenda (menu Période) propose aussi l'envoi.
2Cliquez sur l'avion de la ligne du client. Une grande fenêtre s'ouvre, avec l'aperçu de ce que le client verra à droite.
3S'il y a plusieurs numéros, choisissez Envoyer depuis.
4En Texte libre, modifiez le message préparé (offre du tunnel de vente ou relance) ; l'aperçu se met à jour.
5Cliquez sur Envoyer. Un message accepté coche la relance comme faite.

L'icône verte (bulle) à côté de l'avion ouvre simplement WhatsApp avec le message préparé : elle n'envoie rien depuis Divitrack.

Utiliser un modèle Meta

Avec un numéro Meta, le sélecteur Texte libre / Modèle Meta apparaît. Divitrack lit vos modèles approuvés chez Meta (l'ID du compte WhatsApp Business doit être renseigné).

1Passez sur Modèle Meta (ou laissez Divitrack basculer seul quand le texte libre est refusé).
2Choisissez un modèle dans la liste de cartes : nom, catégorie, extrait. Le dernier modèle utilisé est présélectionné.
3Renseignez les variables : le champ du prénom est prérempli, les autres se tapent.
4Si le modèle a une image ou vidéo en en-tête, collez le lien public (https) du fichier : Meta le télécharge à l'envoi.
5Contrôlez l'aperçu : variables remplies surlignées, boutons du modèle, pied de page. Puis Envoyer.

Cas du modèle	Envoi à l'unité	Envoi en masse
Variables numérotées {{1}}, {{2}}	Oui	Oui ({{1}} = prénom du client)
Variables nommées {{prenom}}	Oui	Non
Image / vidéo / document en en-tête	Oui (lien public)	Non
Bouton avec lien variable	Oui	Non
Variable dans le texte de l'en-tête, en-tête localisation	Non pris en charge	Non pris en charge

Un modèle de catégorie Marketing est facturé par Meta à chaque envoi. N'écrivez qu'à des clients qui attendent de vos nouvelles.

Envoyer en masse

Le bouton Envoi en masse (au-dessus de la liste Xperience) écrit à plusieurs clients en arrière-plan : vous pouvez fermer la page, l'envoi continue.

1Cliquez sur Envoi en masse : tous les clients de l'onglet (toutes pages) sont proposés, 200 maximum par envoi. Décochez ceux à ignorer.
2Choisissez le ou les numéros utilisés : avec plusieurs, les messages partent tour à tour.
3Choisissez le message : le message préparé de chaque client, un message commun ({name} = prénom) ou un modèle Meta. Le sélecteur Aperçu pour montre le message de n'importe quel client.
4Réglez le rythme d'envoi (voir le tableau ci-dessous) et lisez l'estimation de fin.
5Cliquez sur Lancer l'envoi. La barre de progression indique envoyés, échecs, ignorés et en attente, avec Pause, Reprendre et Annuler.

Réglage	À quoi ça sert	Valeurs
Délai entre deux messages	Espace les envois pour protéger le numéro	De 0,1 minute (6 s) à 60 minutes ; raccourcis 0,5 / 1 / 2 / 5 / 10 min
Varier le délai (± 20 %)	Des intervalles réguliers ressemblent à un robot	Activé ou non
Maximum par jour	Étale un gros lot sur plusieurs jours	De 1 à 200
Plage horaire	N'écrit pas la nuit ; hors plage, l'envoi attend	Ex. de 08:00 à 20:00 (heure de votre appareil)
Démarrage	Tout de suite ou programmé	Jusqu'à 30 jours à l'avance

Ce que l'envoi en masse ne fait pas encore

Il ne marque pas automatiquement les clients comme contactés et ne lit pas leurs réponses ni les « STOP ». Surveillez les retours dans WhatsApp.

Les messages automatiques

Désactivé en production

Les envois automatiques et programmés sont retirés : tout part à la main, par le propriétaire ou la chargée de clientèle. Cette section décrit la fonction, mise de côté et réactivable.

Dans Paramètres > Intégrations > WhatsApp > WhatsApp automatique, chaque règle écrit toute seule aux personnes d'un jour de cadence, avec le bon numéro et au bon rythme. Les jours sont ceux de Paramètres > CRM (les mêmes personnes que dans Xperience, le jour exact).

1Activez une règle avec son interrupteur et ouvrez-la.
2Choisissez le mode : À valider (conseillé : les messages attendent votre clic) ou Envoi direct (ils partent seuls).
3Choisissez le ou les numéros d'envoi : sans choix, le numéro par défaut ; avec plusieurs, les messages partent tour à tour.
4Pour relance, suivi et upsell, ouvrez Un message par jour : donnez à chaque jour de cadence (J-1, J-3, J-7…) son propre message, ou désactivez un jour. Les jours viennent de Paramètres > CRM et chaque utilisateur règle les siens.
5Écrivez le texte (variables {name}, {bought}, {offer}, {price}) ou, avec des numéros Meta d'un même compte, choisissez un modèle approuvé et donnez la valeur de chaque variable.
6Réglez le rythme : délai en minutes, variation, maximum par jour, plage horaire. Cliquez sur Enregistrer.
7Chaque matin, Divitrack prépare les messages. En mode À valider, un bandeau « N message(s) WhatsApp à valider » apparaît dans Xperience : relisez, modifiez le texte au besoin, puis Envoyer la sélection ou Ignorer.

Règle	Qui reçoit un message	Texte utilisé (dans cet ordre)
Relance des prospects	Ceux qui ont commencé un achat sans le finir, aux jours de relance du CRM	Texte de la règle, puis message de relance de Paramètres > CRM, puis texte par défaut
Suivi après achat	Les acheteurs, aux jours de suivi du CRM	Texte de la règle, puis texte du produit proposé dans le tunnel, puis texte par défaut
Offre du tunnel (upsell)	Les acheteurs qui ont une offre, aux jours d'upsell	Texte de la règle, puis texte du produit dans le tunnel, puis message d'offre du CRM, puis par défaut
Anniversaire 6 mois / 1 an	Les clients dont le premier achat a 6 mois / 1 an	Texte de la règle, puis texte par défaut

Avant de passer en Envoi direct

Un message automatique est initié par vous : avec Meta, il faut un modèle approuvé (le texte libre n'est accepté que dans les 24 h). Testez le texte en mode À valider quelques jours, et n'écrivez qu'à des clients qui attendent de vos nouvelles. Ajoutez à la liste des numéros désinscrits toute personne qui vous demande d'arrêter : Divitrack ne lui écrira plus jamais (automatique, masse ou à l'unité).

Les protections de votre numéro

Protection	Comportement
Espacement	6 secondes minimum entre deux messages d'un même numéro
Plafond du jour	200 messages par numéro et par jour (le maximum de l'envoi en masse peut être plus bas)
Client déjà contacté	Moins de 24 h : ignoré en masse ; demande une confirmation à l'unité
Échecs répétés	5 échecs d'affilée : l'envoi en masse se met en pause avec la dernière erreur
Numéro déconnecté	L'envoi en masse se met en pause jusqu'à la reconnexion
Longueur	1 000 caractères maximum par message

La clé de chaque numéro est stockée chiffrée et n'est jamais renvoyée au navigateur : seule la fin de la clé s'affiche.

Dépannage

Ce que vous voyez	Cause probable	Que faire
« Clé API invalide »	Clé ou jeton incomplet, avec des espaces ou un retour à la ligne	Recollez-le en une seule ligne, tel que copié
« Object with ID … does not exist »	Phone number ID erroné (souvent l'ID du compte)	Utilisez le Phone number ID du numéro, dans le Gestionnaire WhatsApp
« (#100) Invalid parameter »	Destinataire identique au numéro d'envoi, ou numéro mal formé	Envoyez vers un autre numéro WhatsApp, avec l'indicatif
Texte libre refusé (24 h)	Le client n'a pas écrit depuis plus de 24 h	Passez sur Modèle Meta
« Jeton Meta refusé ou expiré »	Jeton temporaire de 24 h ou révoqué	Générez un jeton permanent et recollez-le via Modifier
Aucun modèle proposé	ID du compte WhatsApp Business manquant, ou jeton sans `whatsapp_business_management`	Modifier le numéro : ajoutez l'ID du compte et recollez un jeton complet
Un modèle est grisé	En-tête non pris en charge, ou réservé à l'envoi à l'unité	Lisez la raison sous le nom ; choisissez un autre modèle
« Numéro déjà utilisé dans un autre compte »	Il est déjà rattaché à un autre compte WhatsApp Business	Vérifiez qu'il n'est pas déjà dans votre compte, ou retirez-le de l'autre
« Envois trop rapprochés »	Moins de 6 secondes depuis le dernier envoi de ce numéro	Attendez quelques secondes, ou choisissez un autre numéro
Envoi en masse en pause	Plafond atteint, 5 échecs d'affilée ou numéro déconnecté	Lisez le message sous la barre de progression, corrigez, puis Reprendre

À bien comprendre

Fenêtre de 24 heures (Meta): Avec l'API officielle, vous pouvez écrire un texte libre uniquement dans les 24 h qui suivent le dernier message du client. Au-delà, Meta n'accepte qu'un modèle approuvé. Divitrack bascule seul sur « Modèle Meta » quand le texte libre est refusé.
Modèle de message (template): Un message écrit à l'avance dans le Gestionnaire WhatsApp de Meta et approuvé par Meta. Seules ses variables ({{1}}, {{prenom}}…) changent à l'envoi. C'est la seule façon de relancer un client qui ne vous a pas écrit depuis plus de 24 h.
Numéro par défaut: Le numéro utilisé quand vous ne choisissez pas : le plan Pro inclut 1 numéro, le plan Business jusqu'à 5 par boutique. Chaque numéro a ses propres limites d'envoi (6 secondes entre deux messages, 200 par jour).
Rythme d'un envoi en masse: Vous fixez le délai en minutes entre deux messages, une variation aléatoire (± 20 %, plus naturelle), un maximum par jour, une plage horaire et un démarrage immédiat ou programmé. Une estimation de l'heure de fin s'affiche avant de lancer.
Règle automatique: Une règle écrit chaque jour aux personnes d'une cadence du CRM (relance, suivi, upsell, anniversaires), depuis le numéro choisi et au rythme réglé. En mode À valider, rien ne part sans votre clic.

Pièges à éviter

Avec WaSender et WaChap, l'usage est non officiel : trop de messages trop vite peut faire restreindre le numéro. Utilisez un numéro dédié et gardez des volumes raisonnables.

Chez Meta, ne confondez pas les trois identifiants : l'ID du compte (WABA), le Phone number ID du numéro et celui du numéro de test. Seul le Phone number ID va dans « Phone number ID ».

Un numéro ne peut pas s'écrire à lui-même : pour tester, envoyez vers un autre numéro WhatsApp que vous possédez.

Le jeton temporaire de Meta expire au bout de 24 h : créez un jeton permanent (utilisateur système) pour un usage réel.

Un client déjà contacté depuis moins de 24 h est ignoré en masse, et demande une confirmation à l'unité.

Astuces

Commencez avec un petit lot (2 ou 3 clients dont vous) avant un grand envoi, et gardez au moins 1 minute entre deux messages.

Le message préparé d'une ligne (offre du tunnel, relance) est repris tel quel en masse ; le message commun ne sert qu'aux clients sans message préparé.

Avec Meta, surveillez la note de qualité du numéro : trop de blocages ou de signalements la fait baisser.

Voir aussi

Xpérience : vos relances du jour Intégrations Clients

Une question sans réponse ? Écrivez-nous