Coexistence : l'API WhatsApp et l'app Business

Oui, vous pouvez utiliser l'API WhatsApp sans quitter l'application WhatsApp Business : c'est la coexistence de Meta. Avec l'application en version 2.24.17 ou plus récente, vous connectez le même numéro à Genuka WA, vous continuez à répondre à la main depuis le téléphone et vous envoyez en volume par l'API. Les nouveaux messages des conversations individuelles apparaissent des deux côtés.

Mis à jour le 8 octobre 2026

Mon numéro peut-il passer en coexistence ?

Tout dépend de l'application qui utilise le numéro aujourd'hui. Meta n'enregistre pas sur la Cloud API un numéro déjà utilisé sur WhatsApp sans qu'il soit supprimé d'abord (Meta, Business phone numbers) ; la coexistence est l'exception prévue pour l'application WhatsApp Business (Meta, Onboard WhatsApp Business app users).

Ce qu'il vous faut avant de commencer

• Un compte Facebook. Meta demande de s'y connecter ; un compte personnel suffit.
• L'application WhatsApp Business en version 2.24.17 ou plus récente (Meta), sur le téléphone qui porte le numéro, à portée de main : la connexion se valide depuis l'application.
• Pour envoyer des templates ensuite, un moyen de paiement sur votre compte WhatsApp Business : Genuka est Tech Provider, Meta facture donc votre compte directement (Meta, Partners).

Comment connecter un numéro en coexistence avec Genuka WA ?

Une fois la connexion faite, appelez une fois GET /api/v1/numbers?refresh=true. Genuka lit alors le numéro chez Meta et enregistre son mode coexistence ; sans cet appel, la liste par défaut ("source": "database") affiche encore coexistence: false pour un numéro tout juste connecté.

curl "https://wa.genuka.com/api/v1/numbers?refresh=true" \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY"

{
  "data": [
    {
      "id": "con_1",
      "displayPhoneNumber": "+237 6 90 00 00 01",
      "platformType": "SMB_APP",
      "coexistence": true,
      "messagesPerSecond": 20,
      "status": "connected",
      "metaStatus": "CONNECTED",
      "refreshed": true
    }
  ],
  "source": "meta"
}

La réponse complète porte aussi, pour chaque numéro, les alerts de santé détectées pendant la lecture, et un objet limits avec les débits de référence. Le rafraîchissement interroge Meta numéro par numéro et s'arrête à 25 numéros par appel : au-delà, filtrez avec ?companyId=.

L'historique de l'application est-il importé ?

Pas pour l'instant. Meta ne transmet les contacts et l'historique de l'application que si le fournisseur en fait la demande, dans les 24 heures qui suivent la connexion ; passé ce délai, le numéro doit être déconnecté et le parcours refait (Meta). Genuka WA ne fait pas encore cette demande. Concrètement :

• Vos anciennes conversations restent dans l'application, intactes, mais n'apparaissent pas dans Genuka WA. Meta permet d'importer les conversations individuelles des 180 derniers jours, sans les groupes (même page) ; Genuka WA ne le fait pas aujourd'hui.
• Ce qui se passe après la connexion arrive bien : les messages reçus sur message.received, ceux envoyés par l'API, et ceux que vous tapez dans l'application (voir plus bas).
• Les contacts ajoutés ou modifiés ensuite dans l'application sont annoncés par Meta par webhook (même page) ; Genuka les relaie sur coexistence.contacts_synced — voir Webhooks.

Qu'est-ce qui est synchronisé, et qu'est-ce qui ne l'est pas ?

D'après la page de Meta sur la coexistence, avec ce que Genuka WA en fait aujourd'hui :

Qu'est-ce qui change pour vos envois par l'API ?

• Le débit est fixé à 20 messages par seconde sur un numéro en coexistence, contre 80 par défaut sur la Cloud API (Meta, coexistence, Meta, Throughput). Genuka cadence vos campagnes sur ce débit dès que le numéro est enregistré comme coexistence (l'appel ?refresh=true ci-dessus). Un lancement reste par ailleurs borné dans le temps : gardez des campagnes de quelques centaines de destinataires (voir les limites du guide des campagnes).
• Les messages envoyés depuis l'application restent gratuits ; ceux envoyés par l'API suivent la tarification de la Cloud API (Meta).
• Ce que vous tapez sur le téléphone remonte dans Genuka. Meta transmet ces messages (les « echoes ») ; Genuka les range sur la conversation avec la mention « Envoyé depuis l'application WhatsApp Business ». Ils ne consomment rien de votre forfait et sont exclus des statistiques de livraison, qui ne comptent que ce que l'API a envoyé : aucun accusé de livraison ne les suit. Abonnement webhook : coexistence.message_echoed.
• Les plafonds de Meta s'appliquent comme ailleurs : templates approuvés hors de la fenêtre de 24 heures, plafond d'envoi du portefeuille Business, plafond marketing par utilisateur.

Comment déconnecter l'API de l'application ?

La déconnexion se fait depuis l'application, pas par l'API : Settings > Account > Business Platform, puis Disconnect Account (libellés de la documentation Meta). Meta envoie alors un webhook account_update portant l'événement PARTNER_REMOVED (Meta).

Chez Genuka, le numéro passe alors en disconnected et l'API ne peut plus envoyer depuis lui. Rien n'est supprimé : messages, templates et statistiques restent attachés au numéro. Repasser par le même lien de connexion le remet en service sur la même fiche, sans consommer de nouvelle place dans votre forfait.

FAQ

Dois-je supprimer mon compte WhatsApp Business pour utiliser l'API ?

Non. C'est tout l'objet de la coexistence : l'application continue de fonctionner sur le même numéro. Seul un numéro utilisé sur WhatsApp classique doit être libéré avant la connexion.

Les messages envoyés depuis le téléphone comptent-ils dans mon forfait Genuka ?

Non. Seuls les envois faits par l'API ou par une campagne consomment le quota de messages de votre forfait. Les messages tapés dans l'application sont synchronisés pour que la conversation soit complète, sans être décomptés.

Que faire si mon application est plus ancienne que 2.24.17 ?

Mettez-la à jour avant d'ouvrir la fenêtre Meta. Meta exige la version 2.24.17 ou plus récente pour proposer la coexistence.

Puis-je continuer à utiliser WhatsApp Web ?

Oui, après l'avoir reconnecté : les appareils connectés sont déconnectés au moment de la connexion et peuvent être reliés à nouveau, sauf WhatsApp pour Windows et pour WearOS.

Combien de messages par seconde puis-je envoyer en coexistence ?

20, quel que soit votre palier chez Genuka ou chez Meta. C'est un plafond fixé par Meta pour les numéros partagés avec l'application.

Sources

• Meta — Onboard WhatsApp Business app users
• Meta — Business phone numbers
• Meta — Throughput
• Meta — Partners (Tech Providers et Solution Partners)
• Genuka — Guide SDK de la coexistence (en anglais)