# Coexistence : l'API WhatsApp et l'app Business URL: https://wa.genuka.com/docs/guides/coexistence Language: French > Gardez l'application WhatsApp Business sur votre numéro tout en utilisant l'API : prérequis (2.24.17+), étapes, ce qui est synchronisé, limites. 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers)) ; la coexistence est l'exception prévue pour l'application WhatsApp Business ([Meta, Onboard WhatsApp Business app users](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)). | Votre numéro aujourd'hui | Ce qu'il faut faire | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Sur l'application **WhatsApp Business** | Rien à supprimer. Mettez l'application à jour et connectez le numéro : Meta propose la coexistence pendant la connexion, l'application continue de fonctionner et vos conversations sont conservées. | | Sur **WhatsApp** (l'application classique, pas Business) | Il faut le libérer avant : supprimez le compte WhatsApp de ce numéro, ou connectez un autre numéro. La coexistence ne concerne que l'application WhatsApp Business. | | Sur aucune application WhatsApp | Rien à libérer : il est enregistré directement sur la Cloud API, sans application. | > [!WARNING] > **Ne supprimez jamais un compte WhatsApp Business pour vous connecter** > > Supprimer le compte de l'application Business détruit son historique, et c'est inutile : la > coexistence existe précisément pour garder ce numéro tel quel. ## 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)), 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/overview)). ## Comment connecter un numéro en coexistence avec Genuka WA ? 1. ### Ouvrez le lien de connexion Depuis votre tableau de bord, page **Numéros** (ou **Lien de connexion** si vous gérez des clients), ou depuis votre lien public `/connect/{votre-slug}` — voir [Connecter un numéro](https://wa.genuka.com/docs/onboarding). Genuka affiche d'abord une courte liste : compte Facebook, numéro sur WhatsApp Business (pas WhatsApp classique), téléphone en main avec l'application à jour. Cochez les trois cases, puis cliquez **Je suis prêt — ouvrir Meta**. 2. ### Choisissez votre application WhatsApp Business existante Dans la fenêtre Meta, connectez-vous avec Facebook et choisissez ou créez le portefeuille Business. Genuka ouvre l'Embedded Signup avec l'option de connexion d'une application WhatsApp Business : Meta vous propose donc de connecter votre compte existant plutôt que d'en créer un. Saisissez le numéro : la fenêtre Meta attend alors un code de vérification. 3. ### Validez depuis le téléphone Dans l'application WhatsApp Business, un message du compte officiel « Facebook Business » arrive. Touchez **Connect**, puis **Connect to the Business Platform**, puis **Confirm** — c'est à cette étape que Meta vous propose de partager l'historique de vos conversations (Genuka WA ne l'importe pas encore, voir plus bas). Copiez le code de vérification. 4. ### Terminez dans la fenêtre Meta Collez le code et terminez le parcours. De retour chez Genuka, la connexion est finalisée : le compte et le numéro apparaissent dans votre espace, le compte WhatsApp est abonné aux webhooks, et le numéro n'est pas réenregistré sur la Cloud API — Meta l'enregistre lui-même en coexistence. 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é. ```bash title="GET /api/v1/numbers?refresh=true" curl "https://wa.genuka.com/api/v1/numbers?refresh=true" \ -H "Authorization: Bearer $GENUKA_WA_API_KEY" ``` ```json title="Réponse (extrait)" { "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](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)). 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](https://wa.genuka.com/docs/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 : | Fonctionnalité | Dans l'application après la connexion | Par l'API | | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | Conversations individuelles | Continuent ; modifier ou retirer un message est pris en charge | Nouveaux messages reflétés dans les deux sens ; l'historique antérieur n'est pas encore importé | | Contacts | Inchangés | Pas d'import initial ; les ajouts et modifications ultérieurs sont annoncés par Meta | | Groupes | Inchangés | Non synchronisés | | Messages éphémères | Désactivés dans les conversations individuelles | Non | | Messages à vue unique | Désactivés dans les conversations individuelles | Non | | Position en direct | Désactivée dans les conversations individuelles | Non | | Listes de diffusion | Désactivées ; les listes existantes passent en lecture seule | Non | | Appels vocaux et vidéo | Inchangés | Non | | Catalogue, commandes, statut | Inchangés | Non | | Réponses rapides, étiquettes, messages d'absence et d'accueil | Inchangés | Non | | Appareils connectés (WhatsApp Web, etc.) | Déconnectés à la connexion, à reconnecter ensuite ; WhatsApp pour Windows et pour WearOS ne sont pas pris en charge | — | ## 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/), [Meta, Throughput](https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput)). Genuka cadence vos [campagnes](https://wa.genuka.com/docs/guides/campaigns-api) 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)). * **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](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)). 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/) * Meta — [Business phone numbers](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers) * Meta — [Throughput](https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput) * Meta — [Partners (Tech Providers et Solution Partners)](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/overview) * Genuka — [Guide SDK de la coexistence](https://wa.genuka.com/sdk/coexistence) (en anglais)