Coexistence for WhatsApp — le guide complet

Nécessite Odoo Enterprise 17, 18, 19 ou 20. Il étend l'application WhatsApp native d'Odoo, qui n'existe que dans Enterprise ; il ne s'installe donc pas sur Odoo Community. Odoo.sh et on-premise ; non disponible sur Odoo Online. L'instance doit être accessible depuis Internet en HTTPS, car Meta livre les messages entrants à un webhook sur votre propre domaine.

Gardez votre numéro sur le téléphone. Ajoutez Odoo par-dessus.

La voie habituelle vers la WhatsApp Cloud API vous demande de renoncer à votre numéro : une fois migré, il cesse de fonctionner dans l'application WhatsApp Business du téléphone. Pour une entreprise dont tout l'historique commercial vit dans cette application, c'est rédhibitoire.

La Coexistence est la réponse officielle de Meta, et ce module l'apporte à Odoo. Vous scannez un QR code et, à partir de cet instant, le même numéro fonctionne des deux côtés à la fois : vos équipes continuent de répondre depuis le téléphone, et Odoo voit tout.

Comment ça marche

• Les messages que votre équipe tape sur le téléphone apparaissent dans Odoo comme des messages sortants dans le fil du client, si bien que l'historique de la conversation est complet.
• Les messages que les clients envoient arrivent dans Odoo par le webhook, exactement comme pour un numéro Cloud API dédié.
• Odoo peut aussi envoyer : réponses dans la fenêtre de 24 heures et modèles approuvés.
• Vos contacts et jusqu'à six mois d'historique peuvent être importés une seule fois, au raccordement, grâce à la synchronisation unique de Meta.

Ce que vous obtenez

• Le numéro reste sur le téléphone. Votre équipe continue de répondre depuis l'application WhatsApp Business. Rien n'est migré ailleurs.
• Raccordement par QR code. L'Embedded Signup de Meta directement dans Odoo. Pas de SMS, pas de nouveau numéro, pas d'identifiants à saisir à la main.
• Les réponses du téléphone reprises dans Odoo. Les échos sortants arrivent dans le même fil, dédupliqués par identifiant de message, donc rien n'apparaît deux fois.
• Tout dans Discussion. Entrant et sortant dans des canaux Discussion ordinaires, sur des contacts ordinaires.
• Import unique de l'historique. Contacts et jusqu'à six mois de conversations, importés au raccordement.
• Zéro configuration de webhook. Le compte génère sa propre Callback URL et son Verify Token, et s'abonne tout seul.
• Plusieurs numéros, une seule base. Chaque numéro est son propre compte, avec ses utilisateurs et sa restriction de société.
• Sept langues. Anglais, espagnol, portugais, italien, français, allemand et arabe.

Une visite en trois écrans

Prérequis

Deux façons d'avoir le droit d'utiliser la Coexistence

La Coexistence WhatsApp se met en place via l'Embedded Signup de Meta, qui ne fonctionne qu'à travers une application enregistrée chez Meta comme Tech Provider et approuvée pour la fonctionnalité WhatsApp Business App Onboarding. Une simple application développeur Meta ne peut pas le faire. Il y a deux façons de remplir cette condition :

Avec une licence RC Studio. Vous achetez une clé de licence, vous la collez dans Odoo et vous vous connectez en scannant un QR code. Rien à enregistrer chez Meta, aucune revue d'application, aucun domaine à déclarer. La licence est facturée séparément de ce module et n'est pas comprise dans son achat.

Avec votre propre application Tech Provider, ou celle d'un tiers. Ce module fonctionne avec n'importe laquelle. Vous saisissez l'App ID, l'App Secret et la Login Configuration que votre fournisseur vous remet, et la connexion passe alors par son application Meta plutôt que par celle de RC Studio. Ces identifiants sont émis par ce fournisseur, pas par RC Studio. RC Studio ne peut pas les obtenir à votre place et n'est pas responsable si votre fournisseur ne vous les remet pas, les révoque, les facture en supplément, ou n'a pas été approuvé par Meta pour la fonctionnalité WhatsApp Business App Onboarding. Vérifiez auprès de votre fournisseur que vous recevrez bien un App ID, un App Secret et une Login Configuration de coexistence avant d'acheter ce module.

Mode A · Coexistence avec une licence RC Studio (recommandé)

Toute la mise en place tient en trois gestes : coller la clé, cliquer sur Connecter, scanner le QR code. Rien à enregistrer chez Meta, aucune revue d'application et aucun domaine à déclarer, car la fenêtre Facebook s'ouvre depuis la page de RC Studio.

Les trois étapes que vous voyez réellement, en mode licence

Meta n'autorise qu'une seule synchronisation des contacts et une seule de l'historique par raccordement. Si elles échouent, le seul moyen de les refaire est de délier le numéro et de le reconnecter.

Mode B · Coexistence avec votre propre application Tech Provider

Cela fonctionne avec votre propre application ou avec celle de n'importe quel autre fournisseur. Dans les deux cas, l'application doit être approuvée par Meta pour la fonctionnalité WhatsApp Business App Onboarding, et l'App ID, l'App Secret et la Login Configuration vous sont remis par ce fournisseur. RC Studio ne peut pas les obtenir et n'est pas responsable si le fournisseur ne les fournit pas.

• Laissez la licence RC Studio vide.
• Renseignez App ID et App Secret de votre application.
• Renseignez Meta Login Configuration avec l'identifiant de votre configuration « Facebook Login for Business ».
• Ajoutez votre domaine Odoo à l'application Meta, dans App domains et Allowed domains for the JavaScript SDK. Cette étape n'a pas d'API et doit être faite à la main pour chaque domaine.
• Cliquez sur Se connecter via Coexistence et poursuivez avec le QR code.

En mode B il n'y a pas de fenêtre RC Studio : la fenêtre Facebook s'ouvre directement depuis votre propre page Odoo, sur votre propre application.

Webhook

Il n'y a rien à coller dans Meta, quel que soit le mode. Le compte génère sa propre Callback URL et son Webhook Verify Token et les enregistre auprès de Meta lors du raccordement du numéro, en s'abonnant au champ messages et à smb_message_echoes. Si l'URL de votre Odoo change un jour, le bouton Réabonner le webhook du formulaire de compte indique la nouvelle à Meta, et Retirer l'override du webhook annule l'opération.

Rôles

Où vivent les conversations

Dans Discussion, exactement là où l'application WhatsApp d'Odoo les place : un canal par client sur le numéro qui a reçu le message. Vous répondez depuis Discussion avec pièces jointes, emoji, citations et réactions. Ce module change la façon dont le numéro se connecte, pas l'endroit où vous répondez.

Une liste de conversations avec recherche, filtre non lus et sélecteur par numéro ne fait pas partie de ce module. Elle vient de WhatsApp: Single Thread and Inbox, vendu et installé séparément ; WhatsApp: Account Icon on Threads ajoute l'icône de couleur par numéro. La Coexistence fonctionne sans l'un ni l'autre.

Répondre depuis Discussion

Les mêmes conversations apparaissent dans Discussion, sous la catégorie WhatsApp — pratique pour ceux qui vivent déjà dans Discussion et préfèrent ne pas changer d'écran. Quand un collègue répond depuis le téléphone, la Coexistence reprend ce message dans le même canal comme message sortant.

Envoyer un modèle depuis un document

Chaque devis, facture, bon de livraison et contact a un bouton WhatsApp dans le chatter. Choisissez le modèle, vérifiez l'aperçu avec les données déjà substituées, et envoyez. Le message est conservé dans le chatter du document et dans le fil du client.

Envois automatisés

Paramètres → Technique → Actions serveur → Nouveau, type Envoyer WhatsApp, choisissez le modèle. Déclenchez-la depuis une règle d'automatisation — à la confirmation d'une commande, par exemple — ou depuis le menu d'action d'une vue liste pour envoyer à plusieurs fiches d'un coup.

États et nouvelles tentatives

WhatsApp → Messages conserve chaque message avec son état : en file, envoyé, remis, lu, répondu, erreur ou rejeté, avec le code d'erreur de Meta le cas échéant. Ceux qui ont échoué peuvent être renvoyés en les sélectionnant et en lançant WhatsApp : renvoyer les messages en échec. Un cron retente la file toutes les heures.

La fenêtre de 24 heures et la désinscription

Vingt-quatre heures après le dernier message du client, WhatsApp n'autorise plus que les modèles. Le champ de saisie se verrouille et propose un bouton pour rouvrir la conversation avec un modèle. Si un client répond STOP, UNSUBSCRIBE ou STOP PROMOTIONS, Odoo met le numéro en liste noire et cesse de lui envoyer quoi que ce soit. Ce sont les mots que reconnaît l'application WhatsApp d'Odoo.

Questions fréquentes

Suis-je obligé de passer par RC Studio comme Tech Provider ? Non. Vous avez trois possibilités et le module les prend toutes en charge. Un : utiliser votre propre application — vous vous enregistrez chez Meta, vous la faites approuver pour la fonctionnalité WhatsApp Business App Onboarding, et vous devenez vous-même Tech Provider. Deux : passer par n'importe quel Tech Provider tiers ; le module fonctionne avec tous. Trois : utiliser le service Tech Provider de RC Studio, facturé séparément de ce module. Ce qui compte dans les cas un et deux, c'est que le fournisseur doit vous remettre un App ID, un App Secret et une Login Configuration de coexistence. Sans ces trois valeurs, l'Embedded Signup ne peut pas s'exécuter. RC Studio ne peut pas les obtenir pour vous et n'est pas responsable si un fournisseur tiers les refuse, les révoque ou les facture en supplément.

Est-ce que ça marche sur Odoo Online (SaaS) ? Non. Odoo Online n'accepte pas les modules tiers. Enterprise tourne sur Odoo.sh et on-premise. Votre instance doit être accessible en HTTPS public, car Meta livre les messages à un webhook sur votre domaine.

Puis-je continuer à utiliser le numéro sur le téléphone ? Oui — c'est tout l'intérêt de la Coexistence. Le même numéro vit dans l'application WhatsApp Business et dans la Cloud API en même temps. Votre équipe continue de répondre depuis le téléphone et Odoo voit tout : les messages entrants et les réponses tapées sur le téléphone, qui arrivent sous forme d'échos et apparaissent dans le fil comme messages sortants. Avec le mode Cloud API dédié, le numéro cesse de fonctionner sur le téléphone.

Est-ce que je perds mon historique en me connectant ? Avec la Coexistence, Meta vous laisse importer vos contacts et jusqu'à six mois d'historique une seule fois, pendant le raccordement. Meta n'autorise qu'une synchronisation des contacts et une de l'historique par raccordement ; si elles échouent, le seul moyen de les refaire est de délier le numéro et de le reconnecter.

Y a-t-il une limite à connaître avant d'acheter ? Oui, et elle vient de Meta, pas du module. Les messages que votre équipe tape sur le téléphone partent tels quels et ne peuvent être ni interceptés ni réécrits ; l'API les reçoit après coup, sous forme d'échos. Si vous devez contrôler 100 % du trafic sortant, c'est la Cloud API dédiée qu'il vous faut, pas la Coexistence. L'application Meta a par ailleurs un quota d'appels horaire : s'il est épuisé, il faut attendre, et réessayer aussitôt ne fait que prolonger la fenêtre.

Combien Meta facture-t-il les messages ? Meta facture par message remis. Les messages modèles sont facturés à un tarif qui dépend de la catégorie (marketing, utilitaire, authentification) et du pays du client. À partir du 1er octobre 2026, Meta facture aussi les réponses libres envoyées dans la fenêtre de 24 heures (les messages de service), au même tarif que les messages utilitaires et d'authentification ; jusque-là elles sont gratuites. La réception reste gratuite. Les détails et les grilles tarifaires sont sur la page tarifaire de Meta. RC Studio ne facture pas au message.

Le module envoie-t-il mes données à un serveur de RC Studio ? Uniquement au raccordement, et seulement le minimum. Les messages ne passent jamais par nous, ni ceux que vous envoyez ni ceux que vous recevez. Le jeton d'entreprise vit dans votre propre base, donc votre Odoo parle directement à Meta, et lors du raccordement du numéro notre service déclare l'adresse de votre Odoo auprès de Meta comme destination des livraisons : Meta livre directement à votre instance, sur une URL secrète que seuls Meta et votre Odoo connaissent. Notre service n'expose même pas de point d'entrée pour envoyer ou recevoir des messages. Ce qui passe par nous, c'est le raccordement : l'app secret de Meta est le nôtre et n'est jamais copié dans votre base, c'est donc nous qui échangeons l'autorisation de Meta contre votre jeton d'accès et vous le remettons. C'est tout. Si vous préférez que RC Studio n'intervienne même pas au raccordement, le module fonctionne exactement pareil avec votre propre application Meta.

Quelles données RC Studio conserve-t-il ? Trois choses, et uniquement tant que le numéro est connecté : l'app secret de Meta (que nous détenons précisément pour qu'il n'ait jamais à être copié dans votre base), la clé de licence que nous vous délivrons, et une copie chiffrée de votre jeton WABA, nécessaire pour réabonner le webhook quand l'URL de votre Odoo change et pour déclencher la synchronisation initiale. Quand vous nous demandez de désaffecter le numéro, l'abonnement de notre application est retiré de votre WABA et l'enregistrement entier est supprimé, jeton chiffré compris. Vous pouvez aussi retirer vous-même l'override du webhook à tout moment, avec le bouton Retirer l'override du webhook du formulaire de compte. Votre jeton d'entreprise reste par ailleurs dans votre propre Odoo, et c'est ce qui rend l'envoi de messages direct et indépendant de notre service.

Notre numéro et notre WABA restent-ils sous notre propre Business Portfolio ? Oui, toujours. Le numéro et la WABA sont à vous et restent dans votre Business Portfolio. Un Tech Provider ne fait office que de pont entre votre WABA et les services de Meta ; il ne prend jamais possession de quoi que ce soit. Meta Business Suite continue également de fonctionner normalement — la Coexistence ajoute la Cloud API à côté des outils de Meta, elle ne les remplace pas.

Peut-on tester d'abord sur un environnement de préproduction, puis passer en production ? Oui, et c'est l'ordre recommandé. Côté téléphone, il n'y a aucune interruption. Côté Odoo, le passage en production change l'URL de votre instance et donc l'adresse où Meta livre les événements : la licence doit être renouvelée et le webhook réabonné à la nouvelle URL — le module a un bouton pour cela. Pendant les quelques minutes que cela prend, Odoo cesse d'envoyer et de recevoir ; le téléphone, non. Notez que l'import unique de l'historique ne se refait pas lors du déplacement du numéro.

Puis-je utiliser des modèles déjà approuvés chez Meta ? Oui. Utilisez le bouton Synchroniser les modèles du formulaire de compte.

Et si Meta refuse la synchronisation avec l'erreur 133010 ? Cela signifie que le numéro n'a pas été lié en coexistence. Le bouton Diagnostiquer le numéro du formulaire de compte le vérifie en un seul appel et vous dit si la connexion doit être refaite.

Quelles versions d'Odoo sont prises en charge, et en quelles langues parle l'interface ? Odoo 17.0, 18.0, 19.0 et 20.0 — chaque version s'achète séparément sur la boutique Odoo. L'interface est livrée en anglais, espagnol, portugais, italien, français, allemand et arabe.

Support

Le support est inclus pour toute personne qui achète le module. L'installation et la configuration côté Meta peuvent être contractées séparément. Utilisez la page de support de ce module sur Odoo Apps pour tout ce qui concerne votre achat : elle nous parvient directement et garde l'échange rattaché à votre licence.

Transit des données : les messages et les fichiers circulent directement entre votre instance Odoo et la Cloud API de Meta, quel que soit le mode de connexion. Avec une licence RC Studio, le service Tech Provider de RC Studio n'intervient qu'au raccordement du numéro : il émet le jeton d'accès Meta et déclare l'adresse de votre Odoo comme destination des livraisons. RC Studio ne reçoit ni ne conserve le contenu des messages. Politique de confidentialité.

WhatsApp est une marque de Meta Platforms, Inc. RC Studio n'est ni affilié à Meta, ni approuvé ou sponsorisé par Meta. Ce module est publié sous la licence Odoo Proprietary License v1.0 (OPL-1).