Connecter WhatsApp

Relier le compte WhatsApp Business de l'entreprise à Cercla par l'API Cloud de Meta, pas à pas, avec le dépannage.

Vérifié le 2026-10-16 · Version Markdown

Cette page explique comment relier le compte WhatsApp de votre entreprise à votre organisation Cercla, en passant par l'API Cloud de Meta. À la fin, vous pourrez envoyer des modèles WhatsApp à vos contacts qui ont donné leur accord, et recevoir dans Cercla leurs réponses et les accusés (envoyé, remis, lu).

Comptez une heure la première fois. Les écrans de Meta décrits ici sont ceux du 16 octobre 2026 : Meta les fait évoluer, et un libellé peut avoir changé.

Vue d'ensemble#

Deux secrets passent de Meta à Cercla : le jeton d'accès et le secret de l'application. Ils se collent directement dans les réglages de Cercla, qui les chiffre. Ne les envoyez ni par email ni par messagerie.

1. Se connecter à Meta Business#

1. Ouvrez business.facebook.com et choisissez « Continuer avec Facebook ».
2. Connectez-vous avec le compte Facebook personnel de la personne qui administrera WhatsApp.

Meta exige un compte Facebook ou Instagram pour créer un portefeuille. Ce compte sert seulement à se connecter : rien n'est publié sur le profil, et les destinataires ne le voient pas. Ne créez pas un second compte Facebook au même nom : les règles de Meta l'interdisent, et le compte risque d'être bloqué. Un « compte Meta géré », sans profil Facebook, ne se crée qu'ensuite, par l'administrateur d'un portefeuille existant. Il sert à donner accès à un collègue.

2. Créer le portefeuille de l'entreprise#

1. Ouvrez le sélecteur de comptes, en haut à gauche, puis « Créer un portefeuille business ».
2. Renseignez le nom de l'entreprise, vos prénom et nom, puis une adresse email professionnelle.
3. Confirmez l'adresse avec le lien que Meta vous envoie.

Si votre compte Facebook administre déjà d'autres portefeuilles (une ancienne activité, une association), n'y rattachez rien. Vérifiez à chaque étape que c'est bien le portefeuille de l'entreprise qui est sélectionné.

Profitez-en pour inviter un second administrateur (Paramètres › Personnes). Ainsi, vous ne dépendez pas d'une seule personne.

3. Créer le compte développeur#

1. Ouvrez developers.facebook.com, puis « Mes apps ».
2. À la première visite, Meta demande de créer un compte développeur : acceptez les conditions, puis validez le code reçu par SMS ou par email.

C'est l'administrateur qui fait ce geste : il accepte les conditions de Meta en son nom.

4. Créer l'application#

1. Dans « Mes apps », choisissez « Créer une app ».
2. Cas d'usage : prenez celui qui mentionne WhatsApp, par exemple « Tisser des liens avec votre clientèle via WhatsApp ».
3. Nom de l'application : n'y mettez pas le mot « WhatsApp », Meta le refuse. Exemple : « Messagerie Exemple SARL ».
4. Portefeuille : celui de l'entreprise.
5. Validez avec « Créer une application ».

Meta signale le portefeuille « Entreprise non vérifiée ». Ça n'empêche pas les essais avec le numéro de test.

5. Obtenir le numéro de test et ajouter vos destinataires#

1. Dans l'application, ouvrez la personnalisation du cas d'usage WhatsApp.
2. Acceptez les conditions de WhatsApp Business et celles de l'hébergement de l'API Cloud.
3. Meta crée un numéro de test et un compte WhatsApp Business de test. Notez :

- l'identifiant du numéro (Phone number ID), par exemple 100000000000001 ; - l'identifiant du compte WhatsApp Business (WhatsApp Business Account ID), par exemple 200000000000002 ; - la version de l'API affichée, par exemple v25.0.

1. Dans « Destinataire », choisissez « Gérer la liste des numéros » et ajoutez les portables qui recevront les essais, au format +33 6 …. Chacun reçoit un code sur WhatsApp, à saisir pour valider.

Le numéro de test n'écrit qu'à cinq destinataires au plus, tous validés de cette façon. N'utilisez pas le jeton proposé sur cette page : il expire au bout d'environ une heure (voir le dépannage).

6. Créer un utilisateur système et son jeton permanent#

Le jeton qui servira à Cercla est celui d'un utilisateur système du portefeuille : il n'expire pas et ne dépend d'aucun compte personnel.

1. Dans Meta Business, ouvrez Paramètres › Utilisateurs › Utilisateurs système, puis « Ajouter ».
2. Nom : par exemple cercla-whatsapp. Rôle : Admin. Le rôle Employé ne suffit pas toujours pour lui attribuer l'application.
3. Choisissez « Affecter des éléments » :

- Applications : votre application, avec le contrôle total ; - Comptes WhatsApp : le compte WhatsApp Business, avec le contrôle total.

1. Choisissez « Générer un token » :

- application : la vôtre ; - expiration : Jamais ; - autorisations : whatsapp_business_messaging et whatsapp_business_management, rien d'autre.

1. Copiez le jeton. Meta ne le réaffiche plus.

7. Relever le secret de l'application#

Dans l'application Meta, ouvrez Paramètres de l'app › Général, ligne « Clé secrète », puis « Afficher ». Meta redemande votre mot de passe.

Ce secret permet à Cercla de vérifier que chaque retour (réponse, accusé) vient bien de Meta. Sans lui, Cercla refuse tous les retours.

8. Renseigner Cercla#

Dans Cercla, ouvrez Réglages › Marketing › WhatsApp, carte « Fournisseur WhatsApp ».

Puis choisissez « Enregistrer ». Après l'enregistrement, les deux champs secrets réapparaissent vides, avec la mention « (vide : inchangé) ». C'est normal : Cercla ne réaffiche jamais un secret. Un champ laissé vide garde la valeur enregistrée, et un champ rempli la remplace.

9. Créer l'adresse de rappel et la déclarer chez Meta#

1. Dans Cercla, carte « Adresse de rappel », choisissez « Créer », puis « Copier l'adresse ». L'adresse se termine par un jeton qui commence par wa_, par exemple https://votre-instance.example/api/webhooks/whatsapp/wa_3f9c….
2. Chez Meta, dans la configuration du cas d'usage WhatsApp, section des webhooks :

- URL de rappel : collez l'adresse complète ; - Vérifier le token : collez le dernier morceau de l'adresse, wa_ compris (tout ce qui suit le dernier /) ; - choisissez « Vérifier et enregistrer ».

1. Dans la liste des champs du webhook, abonnez-vous à :

- messages (réponses et accusés) ; - message_template_status_update (approbation et pause des modèles) ; - user_preferences (un contact qui arrête le marketing depuis WhatsApp).

« Renouveler » dans Cercla change le jeton et invalide l'ancienne adresse. Il faut alors redéclarer l'URL et le jeton chez Meta.

10. Publier l'application#

Chez Meta, renseignez dans les paramètres de l'application l'adresse de votre politique de confidentialité et une catégorie, puis choisissez « Publier ». Tant qu'une application n'est pas publiée, Meta ne lui envoie que des événements d'essai, et aucun vrai retour.

11. Lire les modèles#

Dans Cercla, carte « Modèles du fournisseur », choisissez « Lire les modèles ».

Ce bouton fait deux choses :

• il abonne le compte WhatsApp Business à votre application, sans quoi Meta n'envoie aucun retour à Cercla ;
• il lit les modèles et leur statut. Sur un compte de test, Meta fournit au moins hello_world.

Seul un modèle « Approuvé » peut partir. Les modèles se créent et se font approuver chez Meta, dans WhatsApp Manager. Leur statut se met ensuite à jour tout seul dans Cercla. Relancez « Lire les modèles » après avoir créé un modèle.

12. Enregistrer l'accord du destinataire#

Sur la fiche du contact :

1. Ajoutez son numéro mobile au format international.
2. Dans la carte « Canaux et accords », ligne WhatsApp, choisissez « Saisir un accord WhatsApp » et décrivez où, quand et comment la personne a accepté. Cette note fait preuve.

Sans accord prouvé, Cercla bloque tout envoi WhatsApp vers ce contact. Si la personne demande l'arrêt, sur WhatsApp ou ailleurs, l'accord est retiré.

13. Faire l'essai complet#

1. Dans Réglages › Marketing › WhatsApp, carte « Envoyer un test », choisissez le contact et le modèle, puis « Envoyer le test ». Le message « Message de test accepté par le fournisseur » confirme que Meta l'a pris.
2. Sur le téléphone, le message arrive. Dans « Derniers retours », les accusés « envoyé » puis « remis » apparaissent en quelques secondes, puis « lu » quand le message est ouvert.
3. Répondez depuis le téléphone. Le retour « Réponse · réponse reliée » apparaît, et la fiche du contact affiche « Fenêtre de réponse ouverte jusqu'au … », 24 heures après la réponse.

Si ces trois points sont vrais, la connexion est complète.

Passer à un vrai numéro#

Le numéro de test sert aux essais. Pour écrire à vos clients, Meta demande un vrai numéro, la vérification de l'entreprise et un moyen de paiement, qui se règlent dans Meta Business et WhatsApp Manager. Ensuite, remplacez dans Cercla l'identifiant du numéro (et celui du compte, s'il change), puis relancez « Lire les modèles ». L'adresse de rappel et le jeton de l'utilisateur système restent valables, à condition d'affecter le nouveau compte WhatsApp à l'utilisateur système.

Coûts et budget#

Meta facture chaque message modèle remis, selon sa catégorie (marketing, utility, authentification), le pays du destinataire et le volume du mois. Le paiement se fait chez Meta, pas dans Cercla. Les prix sont publiés sur la page des tarifs de WhatsApp Business, et le numéro de test ne coûte rien.

Cercla lit votre dépense chez Meta chaque matin. Vous pouvez aussi la relire à la demande avec « Lire les coûts », dans la carte « Coûts et budget ». Vous n'avez aucun tarif à saisir :

• Dépense du mois : ce que Meta a compté jusqu'à la veille, plus l'estimation des messages partis depuis. La carte dit jusqu'à quand Meta a compté.
• Prix moyen payé : par catégorie, sur les 30 derniers jours. Il sert à estimer le coût de chaque nouveau message.
• Budget du mois : il bloque un envoi avant que la dépense le dépasse.

Les prix estimés de la carte sont facultatifs. Ils ne servent que pour une catégorie que Meta n'a encore jamais facturée, par exemple avant votre premier message marketing. Saisissez-les en euros par message, comme 0,0712. Sans prix payé ni prix estimé, le coût d'un message s'affiche « inconnu ».

Si Meta facture votre compte dans une autre devise que l'euro, sa dépense s'affiche telle quelle, mais elle n'entre pas dans le budget en euros.

Dépannage#

Voir aussi Campagnes et audiences et Séquences, formulaires, pages et invitations.