# Connecter WhatsApp

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

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

| Où | Quoi | Qui |
| --- | --- | --- |
| Meta Business | Le portefeuille de l'entreprise, puis un utilisateur système et son jeton permanent | Un administrateur du portefeuille |
| Meta for Developers | L'application, son cas d'usage WhatsApp, le numéro, l'adresse de rappel, la publication | Le même administrateur, avec un compte développeur |
| Cercla | Réglages › Marketing › WhatsApp : identifiants, secrets, adresse de rappel, modèles, envoi de test | Un administrateur de l'organisation, module Marketing actif |
| Fiche contact | Le numéro mobile et l'accord WhatsApp de chaque destinataire | Un utilisateur qui a les droits sur le contact |

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](https://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](https://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`.
4. 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.
4. Choisissez « Générer un token » :
   - application : la vôtre ;
   - expiration : **Jamais** ;
   - autorisations : `whatsapp_business_messaging` et `whatsapp_business_management`, rien d'autre.
5. 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 ».

| Champ | Valeur |
| --- | --- |
| Fournisseur | API Cloud de Meta |
| Identifiant du numéro | le Phone number ID de l'étape 5 |
| Compte WhatsApp Business | l'identifiant du compte de l'étape 5 |
| Version de l'API | celle affichée par Meta, par exemple `v25.0` |
| Jeton d'accès | le jeton permanent de l'étape 6 |
| Secret de l'application | la clé secrète de l'étape 7 |

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 ».
3. 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](https://whatsappbusiness.com/fr/products/platform-pricing/), 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

| Ce qu'on voit | Cause | Que faire |
| --- | --- | --- |
| Meta refuse le nom de l'application | Le nom contient « WhatsApp » | Choisir un nom sans ce mot |
| « Session has expired » à la lecture des modèles, une heure après la configuration | Le jeton de la page d'essai de Meta est temporaire | Utiliser le jeton permanent d'un utilisateur système (étape 6) |
| L'utilisateur système ne peut pas recevoir l'application | Rôle Employé | Lui donner le rôle Admin |
| « Vérifier et enregistrer » échoue chez Meta | Le jeton de vérification est incomplet, souvent sans son début `wa_` | Coller tout ce qui suit le dernier `/` de l'adresse, `wa_` compris |
| Le bouton « Test » de Meta sur le champ `messages` donne une erreur 403 | L'exemple de Meta porte un numéro fictif, que Cercla refuse comme « Compte inattendu » | Rien à faire : la signature a été acceptée, c'est le résultat attendu |
| Le message part mais reste « accepté », sans accusé ni réponse | Le compte WhatsApp Business n'est pas abonné à l'application, ou l'application n'est pas publiée | Choisir « Lire les modèles » (étape 11), vérifier la publication (étape 10) |
| Les champs secrets sont vides avec « (vide : inchangé) » après l'enregistrement | Cercla ne réaffiche jamais un secret | Normal : ne rien saisir pour garder la valeur |
| « Envoi bloqué : pas d'accord WhatsApp prouvé » | Aucun accord sur la fiche du contact | Étape 12 |
| Le destinataire ne reçoit rien depuis le numéro de test | Son numéro n'est pas dans la liste des destinataires validés | L'ajouter à l'étape 5 (cinq au plus) |
| « Dernière lecture chez Meta en échec » dans « Coûts et budget » | Jeton expiré ou autorisation `whatsapp_business_management` manquante | Vérifier le jeton de l'utilisateur système (étape 6), puis « Lire les coûts » |
| Un message envoyé avant l'abonnement n'aura jamais d'accusé | Meta ne renvoie pas les retours passés | Envoyer un nouveau test |

Voir aussi [Campagnes et audiences](/documentation/marketing/) et [Séquences, formulaires, pages et invitations](/documentation/marketing-parcours/).