Se connecterCommencer l’essai gratuit
Meta Tech Provider

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.

Commencer l’essai gratuit3 jours gratuits. Rien n’est facturé avant la fin de l’essai.
+1 415 555 0188
Application WhatsApp BusinessL’équipe répond depuis le téléphone, comme avant
Cloud APIVos systèmes, ou un assistant IA, sur la même ligne
Les deux surfaces voient le même fil. Ce que l’API envoie apparaît dans l’application, et ce que l’équipe tape dans l’application arrive sous forme d’événement smb_message_echoes, de sorte qu’un logiciel ne répond jamais par-dessus un humain qui a déjà répondu.
Messages non stockés par défautApplication Business + Cloud APIMCP pour Claude et ChatGPTOpérationnel en 2 minutes

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.

AvantUn numéro, un choix
Garder l’application

L’équipe répond depuis le téléphone. Rien ne peut être automatisé, connecté ni mesuré.

Pas d’API
Migrer vers l’API

Les logiciels peuvent joindre le numéro. L’application Business cesse de fonctionner dessus et l’équipe change d’outil.

Pas d’application
MaintenantUn numéro, les deux
Un seul numéro
Application WhatsApp BusinessCloud API

Meta 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.

Garde le téléphoneUne entreprise avec un seul numéro

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.

Plusieurs numéros, un compteUne agence, un cabinet de conseil ou un développeur

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.

  1. 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.

    Prérequis
    Un endpoint HTTPS qui renvoie hub.challenge au GET de Meta
    Durée
    Environ une minute
    Vous obtenez
    Une destination que Meta peut vérifier dès que le numéro se connecte
    Rien n’est encore connecté. C’est ici que se décide où les messages arriveront.
    Un fournisseur sur le cheminStockés sur ses serveurs
    Meta
    Sa plateformeReçoit et stocke les messages
    VousUne copie, à son rythme
    EasyCoexistenceConfiguration uniquement
    Meta
    Votre endpointPas encore vérifié
    NousNous définissons la route, nous ne sommes pas dessus
  2. Lancer 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é.

    Prérequis
    L’accès au Business Portfolio, et le téléphone avec le numéro
    Durée
    Deux à trois minutes
    Vous obtenez
    La Cloud API reliée à un numéro que l’application utilise toujours
    La seconde surface apparaît. La première n’est pas supprimée.
    Après une migrationUne seule surface
    Le numéro
    Cloud API uniquementApplication Business morte sur ce numéro
    Après la CoexistenceDeux surfaces
    Le numéro
    Application WhatsApp BusinessMêmes discussions et même historique
    Cloud APISur la même ligne
  3. Diriger 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.

    Prérequis
    L’endpoint de l’étape un, désormais vérifié par Meta
    Durée
    Appliqué dès la fin de l’onboarding
    Vous obtenez
    Des messages livrés de Meta à vous, sans nous sur le chemin des messages
    Quels événements vont où une fois l’override actif.
    Événements opérationnelsLivrés chez nous
    account_updateChangements d’état de la connexion
    phone_number_quality_updateQualité et débit
    account_review_updateRésultats des examens
    Chemin des messagesLivrés chez vous
    messagesTout ce qu’un client envoie
    smb_message_echoesCe que l’équipe envoie depuis l’application
    Votre serveurDirectement, jamais par nous
  4. Garder 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.

    Prérequis
    L’application ouverte de temps en temps sur l’appareil principal
    Durée
    En continu
    Vous obtenez
    Une connexion surveillée, et une route qui survit à une reconnexion
    Ce qu’une reconnexion rétablit d’elle-même, et ce qui doit être remis en place.
    Rétabli par MetaAutomatique
    EnvoiLa Cloud API fonctionne à nouveau
    Événements opérationnelsLa surveillance reprend
    Perdu avec l’applicationÀ réappliquer
    Votre override de webhookDésinstallé avec l’application
    Livraison des messages chez vousS’arrête sans bruit
    Nous 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.
Texte librede 0 à 24 heures après son dernier messageTemplates uniquementensuite, jusqu’à ce qu’il écrive à nouveau
Le compteur repart à zéro chaque fois que le client envoie quelque chose. C’est la règle qui casse les intégrations en production, car les tests ont toujours lieu quelques secondes après un message, quand le texte libre fonctionne encore.

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.

Livrés directement à votre endpointLe chemin des messages. Par défaut, il ne passe jamais par nous.
  • messagesTout ce qu’un client envoie au numéro
  • smb_message_echoesCe que votre équipe envoie depuis l’application WhatsApp Business
Livrés chez nousLe chemin opérationnel. C’est la matière de la surveillance.
  • account_updateÉtat de la connexion : supprimée, retirée, reconnectée, restreinte
  • phone_number_quality_updateChangements de note de qualité et de débit
  • account_alertsAlertes émises par Meta sur le compte
  • account_review_updateRésultats d’un examen par Meta
  • business_capability_updateChangements de limite de messages et de fonctionnalités
  • phone_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.

Le numéro a été déconnectéWebhook, source de référence

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 connexion est restée inactive quatorze joursUn état à part

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.

Votre route de webhook a disparu lors d’une reconnexionRéappliqué automatiquement

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.

Le token d’accès ne fonctionne plusDeux tokens, une réponse

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.

La qualité a baisséInterrogé

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.

2 minutes

Temps habituel pour connecter un numéro en scannant un code depuis l’application WhatsApp Business.

24 hours

Durée pendant laquelle une réponse client maintient la session ouverte pour les réponses en texte libre.

20 msg/s

Débit d’envoi d’un numéro Coexistence, fixé par Meta et impossible à augmenter.

6 months

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.

Poursuivre la lecture