Un seul numéro.L’application et l’API, en même temps.
La Coexistence est le mode officiel de Meta pour faire fonctionner l’application WhatsApp Business et la Cloud API sur un même numéro, en même temps. L’équipe continue de répondre depuis le téléphone, avec les mêmes discussions et le même historique, tandis que les logiciels envoient et reçoivent sur cette même ligne.
EasyCoexistence connecte le numéro, puis surveille la connexion.
Le choix qui existait, et qui n’existe plus
La Coexistence n’est pas une nouvelle API. C’est la disparition d’une bifurcation qui empêchait presque toutes les petites entreprises d’automatiser quoi que ce soit.
L’équipe répond depuis le téléphone. Rien ne peut être automatisé, connecté ni mesuré.
Pas d’APILes logiciels peuvent joindre le numéro. L’application Business cesse de fonctionner dessus et l’équipe change d’outil.
Pas d’applicationMeta connecte la Cloud API à un numéro que l’application WhatsApp Business utilise toujours. Les deux surfaces sont actives sur la même ligne, et chacune voit ce que l’autre envoie.
Qui utilise un numéro de cette façon
Deux groupes, qui attendent l’inverse l’un de l’autre de la même fonctionnalité. C’est pourquoi la connexion compte plus que n’importe quel tableau de bord posé dessus.
Une petite équipe, un numéro imprimé sur une camionnette ou une vitrine, et des soirées passées à répondre aux quatre mêmes questions. Il ne s’agit de remplacer personne. Elle veut que les confirmations, les rappels et la première réponse hors horaires se fassent sans intervention humaine, pendant que le téléphone continue de servir pour tout le reste.
De nombreux clients, chacun avec un numéro que personne n’a le droit de migrer ni de toucher. Ces numéros doivent être joignables par les systèmes qu’ils construisent, et le suivant doit pouvoir être ajouté sans appel commercial. La Coexistence est la seule voie officielle vers un numéro auquel le personnel du client répond encore à la main.
Comment un numéro se retrouve sur les deux, et où vont les événements de message
Quatre étapes. La seule qui touche le téléphone est un scan, et celle qui décide de votre architecture est la première.
Préparer l’endpoint avant le début de l’onboarding
Meta vérifie une destination avant d’y livrer quoi que ce soit. Meta appelle votre URL avec un GET contenant hub.mode=subscribe, votre hub.verify_token et un hub.challenge, et votre endpoint doit renvoyer le challenge brut tel quel.
La destination doit être en HTTPS, et un verify token est obligatoire. Nous vérifions les deux avant que l’appel ne soit fait, de sorte qu’une URL mal formée échoue chez nous au lieu de paraître connectée sans rien livrer.
Rien n’est encore connecté. C’est ici que se décide où les messages arriveront. Un fournisseur sur le cheminStockés sur ses serveursSa plateformeReçoit et stocke les messagesVousUne copie, à son rythmeEasyCoexistenceConfiguration uniquementVotre endpointPas encore vérifiéNousNous définissons la route, nous ne sommes pas dessusLancer l’Embedded Signup de Meta et scanner dans l’application
La fenêtre de Meta elle-même s’ouvre. Vous choisissez le Business Portfolio, le WhatsApp Business Account et le numéro déjà enregistré dans l’application WhatsApp Business, puis vous approuvez la connexion sur le téléphone en scannant un code.
C’est aussi à ce moment que vous choisissez de partager ou non l’historique de discussion existant. C’est un choix unique fait pendant l’onboarding, qui ne peut pas être modifié ensuite. L’application Business continue de fonctionner dès que le scan est terminé.
La seconde surface apparaît. La première n’est pas supprimée. Après une migrationUne seule surfaceCloud API uniquementApplication Business morte sur ce numéroAprès la CoexistenceDeux surfacesApplication WhatsApp BusinessMêmes discussions et même historiqueCloud APISur la même ligneDiriger les événements de message vers votre propre système
Meta permet à une application de remplacer l’adresse à laquelle les webhooks d’un WhatsApp Business Account donné sont livrés. Nous faisons pointer cet override vers votre URL, ce qui envoie les deux champs du chemin des messages, messages et smb_message_echoes, directement de Meta vers vous.
Nous gardons les champs opérationnels, car c’est la matière de la surveillance : account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update et phone_number_name_update. Le tableau de bord reste ainsi utile, sans que le contenu des conversations ne passe jamais par nous.
Quels événements vont où une fois l’override actif. Événements opérationnelsLivrés chez nousChemin des messagesLivrés chez vousmessagesTout ce qu’un client envoiesmb_message_echoesCe que l’équipe envoie depuis l’applicationVotre serveurDirectement, jamais par nousGarder la connexion active, et survivre à une reconnexion
Meta déconnecte un numéro en Coexistence après environ quatorze jours sans activité sur l’appareil principal. Cette déconnexion peut être reconnectée, et nous l’enregistrons comme un état à part au lieu de la traiter comme un client parti.
Ce qui surprend, c’est l’effet d’une déconnexion sur la route. Meta stocke la destination sous forme d’override sur l’abonnement de notre application au compte, donc un PARTNER_REMOVED désinstalle l’application et emporte l’override avec elle. La reconnexion rétablit l’envoi et la surveillance, mais pas votre destination. Nous la remettons en place automatiquement, car le premier numéro touché par cette règle s’est reconnecté proprement puis a cessé sans bruit de livrer au serveur du client.
Ce qu’une reconnexion rétablit d’elle-même, et ce qui doit être remis en place. Rétabli par MetaAutomatiqueEnvoiLa Cloud API fonctionne à nouveauÉvénements opérationnelsLa surveillance reprendPerdu avec l’applicationÀ réappliquerVotre override de webhookDésinstallé avec l’applicationLivraison des messages chez vousS’arrête sans bruitNous le réappliquonsÀ chaque reconnexion
Pourquoi des équipes utilisent un numéro de cette façon
- Garder le numéro déjà imprimé sur les camionnettes, les reçus et le site web, ainsi que le travail sur mobile organisé autour.
- Ajouter l’envoi par API, le traitement des webhooks et les templates sans faire passer qui que ce soit sur un nouvel outil.
- Garder le trafic de messages hors de la boîte de réception partagée d’un fournisseur, pour que les conversations ne reposent pas sur la plateforme de quelqu’un d’autre.
- Permettre à une agence de gérer les numéros de nombreux clients sur un seul compte, chacun connecté dans le Business Portfolio du client.
Éligibilité et limites pratiques
- Le numéro doit déjà être actif dans l’application WhatsApp Business. Un numéro utilisé dans l’application WhatsApp grand public doit d’abord y être transféré.
- Le partage de l’historique de discussion existant est un choix unique fait pendant l’onboarding, qui ne peut pas être modifié ensuite.
- Les discussions de groupe sont exclues de l’API sur les numéros en Coexistence, chez tous les fournisseurs.
- L’appareil principal a besoin d’une activité régulière. Meta déconnecte la connexion après environ quatorze jours sans activité.
- Les parcours de vérification et de badge de Meta diffèrent pour les numéros en Coexistence, et la disponibilité selon les régions évolue avec la politique de Meta.
Ce que nous vous transmettons, et ce que nous gardons
Meta permet à une application de remplacer l’adresse à laquelle un WhatsApp Business Account livre ses webhooks. Nous faisons pointer cet override vers votre URL, ce qui sépare les événements en deux.
messagesTout ce qu’un client envoie au numérosmb_message_echoesCe que votre équipe envoie depuis l’application WhatsApp Business
account_updateÉtat de la connexion : supprimée, retirée, reconnectée, restreintephone_number_quality_updateChangements de note de qualité et de débitaccount_alertsAlertes émises par Meta sur le compteaccount_review_updateRésultats d’un examen par Metabusiness_capability_updateChangements de limite de messages et de fonctionnalitésphone_number_name_updateApprobations et refus du nom d’affichage
Si aucun override n’est défini pour un numéro, ses événements de message retombent sur notre callback par défaut, où le handler les écarte sans les enregistrer. C’est imposé dans le code et non promis dans une politique : il n’existe aucun chemin de stockage que le contenu des conversations pourrait emprunter.
La règle des quatorze jours, et ce qu’elle casse sans que personne n’en parle
Meta déconnecte une connexion Coexistence après environ quatorze jours sans activité sur l’appareil principal. Elle peut être reconnectée, nous l’enregistrons donc comme un état à part au lieu de la compter comme un client parti.
La conséquence qui coûte cher vient ensuite. La destination de vos messages n’est pas un réglage du numéro, c’est un override sur l’abonnement de notre application au WhatsApp Business Account. Une déconnexion désinstalle l’application, et l’override disparaît avec elle. Vous reconnectez, l’envoi fonctionne, la surveillance fonctionne, et les messages cessent d’arriver sur votre serveur sans que rien ne signale d’erreur.
Nous réappliquons l’override à chaque reconnexion. Ce comportement existe parce que c’est arrivé : un numéro a été touché par cette règle, s’est reconnecté proprement, puis a cessé de livrer sans bruit.
Si le handshake échoue à ce moment-là, parce que votre serveur était hors ligne ou que le token a changé, l’échec est inscrit dans l’historique de la connexion et la destination est conservée au lieu d’être supprimée. L’enregistrer à nouveau suffit à corriger le problème.
Ce qui casse sans bruit, et comment nous le détectons
L’application WhatsApp Business continue de fonctionner pendant presque toutes les pannes ci-dessous, c’est pourquoi personne ne les remarque. Voici celles que nous vérifions, et comment.
Détecté par le webhook account_update de Meta, précisément PARTNER_REMOVED, plutôt que déduit d’un champ qui passe à false. Nous ne lisons volontairement pas is_on_biz_app pour cela, car il vaut légitimement false sur les numéros qui ne sont pas en Coexistence et provoquait de fausses déconnexions.
La règle d’inactivité de l’appareil principal de Meta. Elle peut être reconnectée, elle est donc enregistrée comme un état à part et non comme un client parti, et la reconnexion rétablit l’envoi et la surveillance.
La destination existe sous forme d’override sur l’abonnement de notre application au compte, donc une déconnexion la désinstalle. L’envoi revient à la reconnexion, la livraison vers votre serveur non. Nous réappliquons l’override à chaque fois, car un numéro à qui c’est arrivé s’est reconnecté proprement puis a cessé de livrer sans bruit.
Nous détenons le token du client et notre propre System User token sur le même compte. Quand l’un est refusé, l’autre lit le compte et détermine lequel des deux est réellement en panne, si bien qu’un token révoqué ne ressemble plus à un numéro perdu.
Interrogée auprès de Meta à intervalles réguliers. Une note RED marque la connexion comme dégradée, et la qualité, le palier de messagerie et le niveau de débit sont enregistrés à chaque vérification, pour qu’une baisse soit visible avant de coûter un envoi.
Connecter un numéro et surveiller un numéro sont deux produits différents. Le second est la raison d’être de celui-ci.
Temps habituel pour connecter un numéro en scannant un code depuis l’application WhatsApp Business.
Durée pendant laquelle une réponse client maintient la session ouverte pour les réponses en texte libre.
Débit d’envoi d’un numéro Coexistence, fixé par Meta et impossible à augmenter.
Quantité d’historique des discussions que Meta synchronise avec l’API lors de la première connexion d’un numéro.
Questions fréquemment posées
Mon équipe doit-elle arrêter d’utiliser le téléphone ?
Non. C’est tout le principe de la Coexistence. L’application WhatsApp Business continue de fonctionner avec le même numéro et les mêmes conversations, tandis que l’API fonctionne en parallèle.
Vais-je perdre mes conversations existantes ?
Non. Elles restent dans l’application et Meta synchronise environ six mois d’historique avec l’API lorsque le numéro se connecte. Les logiciels disposent ainsi d’un contexte au lieu de partir de zéro.
Puis-je annuler la connexion ?
Oui. Un numéro peut être déconnecté et l’application continue comme avant. La connexion ne modifie pas définitivement le numéro lui-même.
Est-ce la même chose que les API WhatsApp non officielles ?
Non, et cette différence détermine si le numéro restera actif. La Coexistence est la fonctionnalité officielle de Meta sur la Cloud API. Les passerelles non officielles utilisent WhatsApp Web comme appareil lié, ce qui enfreint les conditions et entraîne le bannissement des numéros.
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l’essai gratuit3 jours gratuits. Rien n’est facturé avant la fin de l’essai.