Setup

Connecter WhatsApp via l'API Cloud de Meta

Envoyez et recevez des WhatsApp directement depuis Meta (Cloud API), avec votre propre numéro et application, comme alternative à Twilio. Modèle BYO : le numéro, le compte WhatsApp Business et l'application sont les vôtres.

Modèles de message

Passées 24 heures sans réponse du client, WhatsApp n'autorise plus le texte libre : relancer la conversation exige un modèle approuvé. Vous créez et gérez les modèles dans le CRM, sur la carte WhatsApp dans Paramètres → Intégrations — inutile de passer par le Business Manager de Meta.

Cliquez sur Nouveau modèle et indiquez à quoi il sert. Le nom technique se remplit tout seul (Meta n'accepte que minuscules, chiffres et tiret bas).
Choisissez la langue et la catégorie. Utilitaire pour un message attendu par le client, commande ou rendez-vous ; Marketing pour une offre. Meta examine aussi la catégorie, et se tromper est un motif fréquent de refus.
Rédigez le message. Utilisez {{1}}, {{2}} pour ce qui change selon la personne, numérotés dans l'ordre et sans trou.
Renseignez un exemple pour chaque variable. Meta l'exige et refuse le modèle sans eux — personne ne reçoit ces valeurs, elles ne servent qu'à l'examen.
Envoyez pour examen. Le modèle arrive en attente et Meta l'approuve en général en quelques minutes ; le statut apparaît dans la liste.

💡 Le CRM vérifie le nom, la numérotation des variables et les exemples manquants avant d'envoyer quoi que ce soit à Meta. Ce sont les trois refus les plus courants, et le message de Meta pour ceux-ci ne dit pas quoi corriger.

Connecter en un clic

Si le bouton « Connecter WhatsApp » apparaît en haut de la carte, utilisez-le : c'est le chemin court. Une fenêtre Meta s'ouvre, vous choisissez (ou créez) le compte WhatsApp Business et le numéro, et c'est fait. Aucune app à créer, aucun jeton à générer, rien à coller. Cela fonctionne parce que SellioCRM est un Tech Provider approuvé par Meta : la connexion se fait sous notre app plutôt que sous une app que vous devriez construire.

Le numéro et le compte restent les vôtres. Vous pouvez déconnecter depuis Meta à tout moment et nous perdons l'accès immédiatement.
Nous ne voyons jamais votre mot de passe Facebook, et aucun de nos secrets n'atteint votre navigateur.
Les messages restent facturés par Meta sur votre propre compte.

💡 Si le bouton n'apparaît pas, le chemin en un clic n'est pas activé pour votre espace et la configuration manuelle ci-dessous est la voie. Les deux aboutissent au même endroit : même envoi, même boîte de réception, mêmes modèles.

Configuration manuelle (votre propre app Meta)

En plus de Twilio, vous pouvez envoyer et recevoir des WhatsApp directement depuis Meta, en utilisant l'API Cloud officielle. C'est une alternative : lorsque cette intégration est active, WhatsApp passe par Meta ; le SMS continue d'utiliser Twilio. Modèle BYO (vous apportez votre propre compte) : le numéro, le compte WhatsApp Business (WABA) et l'application Meta sont les vôtres, et les messages sont facturés sur votre compte Meta, sans aucun coût, marge ou intermédiation de notre côté.

L'intégration démarre inerte : rien n'est envoyé tant que vous n'avez pas rempli les champs et activé la fonctionnalité. Le jeton d'accès et le secret de l'application sont stockés chiffrés dans le CRM et ne sont jamais réaffichés.

Prérequis

Une application Meta (developers.facebook.com) avec le produit WhatsApp ajouté et un compte WhatsApp Business (WABA).
Un numéro WhatsApp enregistré sur votre WABA et son Phone Number ID (sous WhatsApp > API Setup).
Un jeton d'accès permanent (recommandé : un System User dans Business Manager) et l'App secret de l'application (sous Settings > Basic).
Dans Sellio, un accès administrateur pour enregistrer les identifiants et activer l'intégration dans Paramètres → Intégrations.

Ce que vous devez renseigner

Phone Number ID : l'identifiant de votre numéro WhatsApp chez Meta (c'est un ID, pas le numéro de téléphone lui-même).
WABA ID (facultatif) : l'ID de votre compte WhatsApp Business, utile pour la gestion et les modèles.
Version Graph : la version de l'API Graph à appeler (par ex. v21.0). Vide utilise la version par défaut.
Verify token : une chaîne que vous choisissez. Elle doit être identique dans le CRM et dans le panneau Meta lors de l'abonnement au webhook.
Jeton d'accès : le jeton permanent qui autorise l'envoi (stocké chiffré dans le CRM).
App secret : le secret de l'application, utilisé pour vérifier la signature des webhooks reçus (stocké chiffré dans le CRM).

Comment configurer

Ouvrez Paramètres → Intégrations et repérez la carte « WhatsApp (Meta Cloud API) ».
Renseignez le Phone Number ID, le Verify token (choisissez une chaîne), le jeton d'accès et l'App secret ; WABA ID et version Graph sont facultatifs. Cliquez sur « Enregistrer les identifiants ».
Copiez l'« URL du webhook (Meta) » qui apparaît. Dans le panneau Meta, sous WhatsApp → Configuration → Webhooks, collez cette URL dans Callback URL et le même Verify token dans le champ Verify token.
Toujours chez Meta, abonnez-vous au champ « messages » pour recevoir les messages et les statuts.
Retournez dans le CRM et cliquez sur « Activer ». À partir de là, les envois WhatsApp passent par Meta.

Comment envoyer un message

Ouvrez un Contact ou un Prospect ayant un téléphone (champ Téléphone ou Mobile).
Dans le panneau « Messages (SMS/WhatsApp) », cliquez sur « Envoyer SMS/WhatsApp » et choisissez le canal WhatsApp.
Vérifiez le numéro, rédigez le message et cliquez sur « Envoyer ».
Le message est enregistré dans l'historique de l'enregistrement. Les réponses du client arrivent via le webhook et apparaissent dans le même historique.

💡 Fenêtre de 24h et modèles : en dehors de la fenêtre de 24 heures depuis le dernier message du client, Meta n'accepte que les messages de type MODÈLE (template) approuvé. À l'intérieur de la fenêtre, le texte libre fonctionne. Créez et faites approuver vos modèles dans le panneau Meta.

Sécurité : le CRM vérifie le X-Hub-Signature-256 de chaque webhook reçu à l'aide de votre App secret (un appel non signé ou avec une signature invalide est rejeté). Traitez le jeton d'accès et l'app secret comme des secrets : ils sont stockés chiffrés et jamais réaffichés.

Plusieurs numéros dans la même app

Vous pouvez avoir plusieurs numéros WhatsApp dans la même intégration (par ex. un numéro américain par défaut et un numéro brésilien pour les conversations locales). Dans la carte de l'intégration, ajoutez-les sous « Numéros supplémentaires » (Phone Number ID, WABA ID facultatif et un libellé) puis enregistrez. Au démarrage d'une conversation, choisissez l'expéditeur sous « Envoyer depuis » ; les réponses de la boîte de réception partent automatiquement par le numéro sur lequel chaque conversation est arrivée. Le numéro principal reste celui par défaut.

Comment tester

Ouvrez un Contact ou un Prospect avec un téléphone et envoyez un court message WhatsApp à l'un de vos numéros.
Confirmez que le message est bien arrivé sur le téléphone et qu'il a été enregistré dans l'historique de l'enregistrement.
Répondez depuis le téléphone et vérifiez que la réponse apparaît dans le même historique (cela valide le webhook entrant).

Dépannage

La vérification du webhook échoue chez Meta : le Verify token dans le CRM et dans le panneau Meta doivent être identiques. Vérifiez que la Callback URL est bien l'« URL du webhook (Meta) » affichée sur la carte.
Erreur d'envoi : vérifiez le Phone Number ID et le jeton d'accès. Un jeton expiré ou sans permission WhatsApp fait refuser l'envoi par Meta.
WhatsApp n'envoie pas en dehors de la fenêtre : utilisez un modèle approuvé. Le texte libre fonctionne uniquement dans la fenêtre de 24h.
Je ne reçois pas les réponses : dans le panneau Meta, abonnez-vous au champ « messages » et vérifiez la Callback URL + le Verify token.
Webhook rejeté (403) : le X-Hub-Signature-256 ne correspond pas. Ressaisissez le même App secret dans le CRM (il ne revient pas depuis le serveur).
Ça continue à sortir via Twilio : l'intégration Meta doit être « Activée ». Sans activation, WhatsApp continue d'utiliser Twilio.

Utiliser le MÊME numéro déjà présent dans l'app WhatsApp Business

Vous pouvez garder le numéro actif dans l'application mobile et connecté au CRM en même temps — Meta appelle cela la coexistence. Le commercial continue de répondre depuis le téléphone, et chaque message envoyé apparaît automatiquement dans la conversation du CRM. Jusqu'à six mois de conversations antérieures sont importés à l'activation.

Ce n'est pas vous qui l'activez dans le Business Manager : cela passe par l'assistant de connexion du CRM et se confirme avec un code reçu sur votre WhatsApp.
L'application continue de fonctionner normalement : ce qui change, c'est que la conversation est aussi enregistrée ici, sur le bon contact.
L'import de l'historique a un délai : Meta donne 24 heures après l'activation. Laissez l'application ouverte pendant l'opération — l'écran affiche la progression.
Si vous changez de téléphone ou réenregistrez le numéro, la connexion tombe et doit être refaite. Le CRM vous prévient.

💡 Ce qui cesse de fonctionner dans l'application avec la coexistence : groupes, appels audio et vidéo, catalogue et commandes, messages marketing et réponses rapides de l'app. Les listes de diffusion existantes passent en lecture seule. Si l'un de ces points vous est essentiel, préférez un numéro dédié au CRM et laissez l'application intacte.

Open this article inside the system →