WhatsApp

Les messages partent de votre numéro, par votre compte Meta. Sans l’intégration, l’app n’envoie rien par WhatsApp : l’écran peut avoir le bouton, mais l’envoi est refusé avec l’avertissement que WhatsApp n’est pas configuré dans cette app.

Avant de commencer

• Plan : Builder. Le plan est vérifié à chaque envoi : si le compte quitte le Builder, l’app cesse d’envoyer ;
• Compte Meta for Developers et, pour la production, un compte professionnel Meta avec un numéro de téléphone dédié à WhatsApp ;
• Coût : Meta facture les messages selon sa propre grille, sur votre compte. En plus, chaque message envoyé par l’app consomme des crédits d’intégration de la plateforme, et seulement quand Meta accepte l’envoi.

Ce que l’app fait avec l’intégration

• envoyer un message texte à un numéro ;
• envoyer un message modèle (template) approuvé par Meta, dans la langue du modèle ;
• recevoir des messages et déclencher des automatisations quand quelqu’un écrit au numéro. C’est à cela que servent les deux derniers champs de la carte (voir la fin de ce guide).

Les numéros s’écrivent au format international, avec l’indicatif du pays : +33612345678.

Pas à pas

Champs de la carte : Phone Number ID, Access Token, Verify Token (webhook) et App Secret (signature du webhook).

1. sur developers.facebook.com, créez une app de type Business ;
2. ajoutez le produit WhatsApp à l’app. Meta fournit déjà un numéro de test ;
3. dans WhatsApp → API Setup, copiez le Phone number ID et le jeton d’accès ;
4. dans Paramètres → Général, affichez et copiez l’App Secret ;
5. inventez un Verify Token : n’importe quel texte secret, que vous réutiliserez dans le tableau de bord Meta si vous recevez des messages ;
6. dans l’éditeur de l’app, onglet Intégrations, catégorie Notifications, ouvrez la carte WhatsApp ;
7. remplissez les quatre champs et cliquez sur Enregistrer et activer.

Jeton de test et jeton permanent

Le jeton affiché dans API Setup est temporaire et expire au bout d’environ 24 heures. Il sert pour le premier test, et c’est tout. Pour l’app en service, générez un jeton permanent avec un utilisateur système, dans Paramètres de l’entreprise → Utilisateurs système, en lui donnant accès à l’app et à WhatsApp. Ouvrez ensuite la carte, collez le nouveau jeton dans son champ et enregistrez. Les autres champs peuvent rester vides : la valeur enregistrée est conservée.

Numéros de destination en mode test

Tant que l’app Meta est en mode test, elle n’envoie qu’aux numéros enregistrés comme destinataires autorisés dans API Setup lui-même, et Meta limite cette liste à quelques numéros. Enregistrez le vôtre pour tester.

Modèles de message (templates)

La règle vient de Meta, pas de la plateforme : l’entreprise ne peut envoyer du texte libre qu’aux personnes qui ont écrit au numéro dans les dernières 24 heures. En dehors de cette fenêtre, le premier message doit être un modèle approuvé.

En pratique, les rappels et notifications que l’app envoie d’elle-même (un rappel de rendez-vous, une confirmation de commande) ont presque toujours besoin d’un modèle. La marche à suivre :

1. dans le Gestionnaire WhatsApp de votre compte professionnel, créez le modèle, avec le texte et les variables ;
2. soumettez-le à approbation et attendez que Meta l’approuve ;
3. demandez dans le chat que l’app utilise ce modèle, en donnant le nom exact du modèle et la langue. Si aucune langue n’est indiquée, l’app utilise pt_BR.

Savoir que cela a fonctionné

La carte WhatsApp ne teste pas l’identifiant à l’enregistrement : Connectée veut dire que les champs ont été enregistrés, pas que le jeton est valide. La preuve est un envoi réel :

1. demandez dans le chat un bouton de test qui envoie un message à votre numéro (cela consomme des crédits d’IA, comme toute construction) ;
2. utilisez le bouton et vérifiez que le message est arrivé ;
3. s’il n’est pas arrivé, l’erreur affichée contient le message de Meta lui-même.

Recevoir des messages

Les champs Verify Token (webhook) et App Secret (signature du webhook) servent à recevoir des messages dans l’app : le Verify Token confirme à Meta que l’adresse vous appartient, et l’App Secret prouve que chaque message reçu vient bien de Meta. Sans l’App Secret, tout message reçu est refusé.

L’adresse de retour que Meta demande d’enregistrer à cette étape n’apparaît pas sur la carte aujourd’hui. Si votre app doit recevoir des messages, contactez le support pour obtenir l’adresse de votre projet.

Problèmes courants

• Cela marchait hier et aujourd’hui rien ne part. C’est le jeton temporaire, qui a expiré. Générez le jeton permanent (voir plus haut) ;
• Erreur de destinataire non autorisé. L’app Meta est en mode test et le numéro de destination n’est pas dans la liste des autorisés ;
• Le rappel n’arrive pas, mais la réponse à un client arrive. C’est la fenêtre de 24 heures : en dehors, seul un modèle approuvé passe ;
• Erreur sur le modèle. Le nom ou la langue ne correspondent pas au modèle approuvé, ou il n’a pas encore été approuvé ;
• L’envoi est refusé faute de crédits. Le solde de crédits d’intégration est épuisé. Consultez le panneau, sous Facturation.