Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Comment ajouter WhatsApp à votre SaaS avec Embedded Signup et Coexistence

Un SaaS ajoute WhatsApp en connectant le numéro existant de chaque client via Embedded Signup de Meta avec Coexistence, de sorte que le numéro continue de fonctionner dans l'application WhatsApp Business. Avec la Partner API d'easyCoexistence, une session de connexion par client exécute ce parcours sur une page hébergée : Meta livre les messages du numéro à votre webhook_url, et votre backend répond via la Cloud API avec le token propre au client.

20 mps

Débit fixe d'un numéro utilisé à la fois avec l'application WhatsApp Business et la Cloud API.

2.24.17

La version la plus ancienne de l'application WhatsApp Business avec laquelle le numéro d'un client peut se connecter via Coexistence.

180 days

Profondeur de l'historique de discussions que Meta peut partager à l'intégration ; il doit être synchronisé dans les 24 heures.

24 hours

La fenêtre de service client de WhatsApp après un message ou un appel de l'utilisateur ; chaque nouveau message la réinitialise.

October 15, 2026

La date à laquelle Meta a déprécié Embedded Signup v2 et v3, les intégrations étant passées à la v4.

Quelles sont les parties d'une intégration WhatsApp ?

Cinq, et easyCoexistence prend en charge la première et la dernière. Votre produit garde la logique de conversation, la boîte de réception et ce que votre modèle ou le personnel de vos clients écrit, tandis que Meta achemine les messages entre le numéro et votre serveur :

1ConnectEmbedded Signup with Coexistence on a hosted page
2Routewebhook_url set on the number as it connects
3ReceiveMeta posts messages and echoes to your server
4ReplyCloud API calls with the customer's token
5WatchStatus events when the number drops or returns

Qu'est-ce que Coexistence change pour vos clients ?

Ils gardent leur numéro et leur téléphone. L'application WhatsApp Business continue de fonctionner à côté de la Cloud API : le personnel répond depuis le téléphone pendant que votre produit répond via l'API, et ce qu'il envoie depuis l'application parvient à votre webhook sous forme de smb_message_echoes. Trois limites l'accompagnent : le numéro envoie à un débit fixe de 20 messages par seconde, seule l'API peut envoyer des templates, et Meta déconnecte le numéro lorsque le téléphone reste inactif pendant environ 14 jours.

À quoi ressemble l'étape de connexion dans votre produit ?

Un bouton Connect WhatsApp qui appelle POST /connect-sessions depuis votre backend avec un redirect_url, l'identifiant de votre client comme external_ref, et webhook_url avec webhook_verify_token, afin que Meta achemine le numéro vers vous dès la première minute. Le client valide une courte liste de contrôle sur la page hébergée, ouvre la fenêtre contextuelle de Meta, scanne un QR code avec l'application WhatsApp Business et revient chez vous avec un connection_id. Pour savoir s'il vaut mieux lancer Embedded Signup depuis votre propre application Tech Provider, consultez le guide Embedded Signup.

Comment les messages parviennent-ils à votre backend ?

Directement depuis Meta vers le webhook_url, sans passer par easyCoexistence et sans copie conservée. Le champ messages transporte ce que les clients envoient et le statut de ce que vous envoyez, et smb_message_echoes transporte ce que le personnel envoie depuis l'application. Meta signe chaque livraison avec le secret d'application d'easyCoexistence, qui n'est jamais partagé ; un secret long et aléatoire dans le chemin de l'URL authentifie donc la livraison. Deux numéros d'un même WhatsApp Business Account partagent une destination : routez selon value.metadata.phone_number_id.

Comment votre backend répond-il et envoie-t-il des templates ?

Avec la Graph API de Meta et le token du client obtenu via GET /connections/{id}?credentials=1, qui renvoie aussi le send_endpoint. Le texte libre part dans les 24 heures suivant le dernier message de la personne ; au-delà, seul un template approuvé par Meta peut être envoyé :

  • Réponse : POST /<PHONE_NUMBER_ID>/messages avec type text, dans la fenêtre.
  • Template : le même appel avec type template, un nom de template et son code langue.
  • Créer un template : POST /<WABA_ID>/message_templates, puis interroger son statut, car les résultats de la validation n'arrivent pas à votre webhook_url.
  • Médias : POST /<PHONE_NUMBER_ID>/media pour l'envoi ; les médias entrants arrivent sous forme d'ID à récupérer avec le même token.
Reply inside the customer service window
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $CUSTOMER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511987654321",
    "type": "text",
    "text": { "body": "Your table for 4 is booked for 8 pm." }
  }'

Votre produit peut-il importer les discussions existantes du client ?

Une seule fois, à la connexion. Lorsqu'un webhook_url est défini sur la session, easyCoexistence demande à Meta d'envoyer les contacts du numéro et, si le client l'accepte dans l'application, jusqu'à 180 jours de discussions, qui arrivent sous forme de webhooks smb_app_state_sync et history. Meta ne l'autorise que dans les 24 heures suivant la connexion ; faites donc répondre l'endpoint avant d'envoyer le lien. Le guide de l'historique des discussions détaille les payloads.

Qui paie Meta pour les messages ?

Votre client. Meta facture les messages que votre backend envoie via l'API au WhatsApp Business Account de votre client, sur un moyen de paiement qu'il ajoute lui-même, et une entreprise sans moyen de paiement ne peut pas envoyer de templates marketing. easyCoexistence facture votre compte par numéro connecté et ne facture jamais les messages ni n'applique de marge sur les tarifs de Meta.

Que se passe-t-il quand un numéro se déconnecte ?

Votre URL d'événements reçoit connection.disconnected avec la raison donnée par Meta lorsqu'elle est connue. PRIMARY_INACTIVITY correspond à la règle des 14 jours, et une nouvelle session de connexion pour ce client rétablit le même numéro. connection.token_missing signifie que le numéro a été connecté sans le token du client : il reçoit les messages mais ne peut pas en envoyer tant qu'une nouvelle session ne l'a pas reconnecté.

Erreurs courantes

  • Envoyer le lien de connexion avant que votre endpoint webhook réponde. L'import de l'historique n'a lieu qu'une fois, dans les 24 heures suivant la connexion, et le contenu envoyé avant que votre URL fonctionne est perdu.
  • Répondre en texte libre après la fermeture de la fenêtre. Passé 24 heures depuis le dernier message de la personne, seul un template approuvé passe.
  • Lancer une campagne depuis un numéro à pleine vitesse. Un numéro Coexistence envoie à 20 messages par seconde : mettez donc en file d'attente les envois de chaque numéro à ce débit.
  • Compter sur le personnel pour envoyer des templates depuis le téléphone. En Coexistence, seule l'API les envoie : intégrez donc l'envoi des templates à votre produit.
Faire cela avec EasyCoexistence

easyCoexistence ajoute WhatsApp à votre SaaS avec Embedded Signup de Meta et Coexistence, sur une page hébergée qui affiche votre nom : vos clients gardent leur numéro et l'application WhatsApp Business, Meta livre les messages à votre serveur et vous les remonte sous forme d'événements signés. La même API connecte Instagram, Facebook, TikTok, YouTube, LinkedIn et d'autres canaux. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours en essai gratuit.

Questions fréquemment posées

Un client peut-il connecter un numéro déjà utilisé chez un autre fournisseur d'API WhatsApp ?

Pas tant qu'il y est. La liste de contrôle hébergée demande un numéro sans autre fournisseur d'API ni outil d'automatisation ; le client doit donc d'abord le déconnecter de ce fournisseur.

Mon SaaS peut-il envoyer des templates WhatsApp pour ses clients ?

Oui, via la Cloud API avec le token de chaque client : créez le template sur son WhatsApp Business Account, attendez la validation de Meta, puis envoyez-le.

easyCoexistence consulte-t-il les messages WhatsApp de mes clients ?

Non. Meta livre les messages d'un numéro directement au webhook_url que vous définissez. Un numéro sans webhook_url repasse par le callback d'easyCoexistence, où les messages sont supprimés sans être conservés.

Combien coûte easyCoexistence par numéro WhatsApp ?

De US$ 9 à US$ 0,75 par numéro et par mois, selon la tranche de votre total de connexions, avec les 3 premiers jours en essai gratuit. Les frais de messages de Meta sont facturés au WhatsApp Business Account de chaque client.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le