Se connecterCommencer l’essai gratuit
Meta Tech Provider

Envoyer automatiquement les conversations WhatsApp vers votre CRM

Pour envoyer automatiquement les conversations WhatsApp vers un CRM, faites livrer les messages entrants sous forme de webhooks signés vers votre backend ou un outil de workflow, retrouvez ou créez le contact à partir de son numéro de téléphone, puis enregistrez le message comme activité sur ce contact. Utilisez l'identifiant du message WhatsApp comme clé unique de l'activité : une livraison relancée met ainsi à jour le même enregistrement au lieu d'en créer un second.

easyCoexistence relie le numéro WhatsApp Business que vous gardez dans l'app à l'API Cloud de Meta via Coexistence.

X-EC-Delivery

En-tête d'un POST transféré contenant l'identifiant de livraison, identique à chaque nouvelle tentative de cette livraison.

About 33 hours

Échelonnement des 7 tentatives de transfert, après environ 1, 5, 30, 120, 360 et 1 440 minutes.

1 attempt

Une étape Call my webhook appelle votre URL une fois ; un délai dépassé ou une erreur fait échouer l'exécution et vous envoie un e-mail.

BSUID

Identifiant utilisateur propre à l'entreprise, comme US.13491208655302741918, envoyé dans user_id et from_user_id à côté du numéro de téléphone ou à sa place.

30 days

Durée de conservation du journal d'exécution de l'automatisation : le message déclencheur, la réponse et chaque étape.

Quels événements doivent parvenir au CRM ?

Trois types de messages composent une conversation sur un numéro Coexistence, et deux routes les acheminent. La Forward URL, définie par numéro, transmet ce que les clients écrivent et ce que votre équipe tape dans l'app WhatsApp Business, sous forme d'événements Meta d'origine, relancés jusqu'à ce que votre CRM réponde. Les réponses envoyées par les automatisations atteignent Meta via l'API, qui ne les signale que par des statuts de livraison, sans texte ; pour en journaliser le contenu, terminez l'automatisation par une étape Call my webhook, dont l'historique inclut la réponse que l'exécution vient d'envoyer. Un seul endpoint peut tout recevoir : l'en-tête X-EC-Event vaut automation.step pour l'étape et le nom de champ Meta pour les transferts.

Customer messagesForward URL, event messages, in value.messages
Replies typed on the phoneForward URL, event smb_message_echoes, in value.message_echoes
Automated repliesCall my webhook as the last step: history entries with direction out
Lead detailsSaved by an agent or an AI saves details step, or extracted by your workflow from the chat; see lead qualification

Comment faire correspondre un expéditeur WhatsApp à un contact du CRM ?

Par numéro de téléphone, normalisé. WhatsApp envoie des chiffres précédés de l'indicatif pays, sans signe plus, comme 5511987654321, dans messages[].from pour les transferts et dans contact.wa_id pour l'étape webhook. Les fiches saisies à la main dans le CRM contiennent par exemple +55 11 98765-4321 ou (11) 98765-4321 : conservez donc une propriété dédiée au format en chiffres seuls et recherchez sur celle-ci. Si rien ne correspond, créez le contact avec le nom de profil WhatsApp et le numéro.

Enregistrez aussi l'identifiant utilisateur propre à l'entreprise. Un utilisateur disposant d'un nom d'utilisateur WhatsApp qui n'a pas écrit à votre numéro depuis 30 jours peut n'arriver qu'avec le BSUID, dans from_user_id et contacts[].user_id. Les transferts le transportent ; l'étape webhook transporte le numéro de téléphone.

Que doit contenir chaque enregistrement du CRM ?

Un contact avec ses identifiants, et une activité par message avec le sens, le texte, l'heure et une clé unique. Le schéma ci-dessous indique où se trouve chaque valeur selon le canal. Sur les transferts, les heures des messages sont des secondes Unix envoyées par Meta ; l'étape webhook envoie des dates ISO. Les médias arrivent sous forme de type et d'identifiant pour les transferts, et sous forme de marqueurs comme [image] avec la légende pour l'étape webhook : journalisez donc un court libellé plutôt que de tenter de stocker le fichier.

Forwarded event (value is Meta's)Call my webhook step
Contact phonemessages[].fromcontact.wa_id
Contact namecontacts[].profile.namecontact.name
BSUIDcontacts[].user_id, messages[].from_user_idNot sent
Activity texttext.body, or the media typemessage.text and history[].text
Directionmessages = in, smb_message_echoes = outhistory[].direction: in, out or echo
Timetimestamp, Unix secondsmessage.at and history[].at, ISO 8601
Unique keymessages[].id (wamid)message.id; run_id for history entries

Comment éviter que les nouvelles tentatives créent des doublons ?

Répondez vite, puis identifiez chaque événement par une clé. Un transfert qui ne reçoit pas de réponse 2xx dans les 10 secondes est relancé avec le même identifiant X-EC-Delivery, jusqu'à 7 tentatives ; un appel au CRM qui dure 12 secondes s'exécute donc deux fois, à moins que l'activité ne soit traitée en upsert sur le wamid. Répondez 200 d'abord, puis effectuez le travail côté CRM dans une file d'attente ou une tâche en arrière-plan.

L'étape webhook n'est pas relancée, et les envois répétés de Meta sont filtrés avant qu'une automatisation ne s'exécute : elle n'est donc appelée qu'au plus une fois par message. Ses entrées d'historique ne portent aucun identifiant de message : identifiez les réponses automatisées par run_id plus leur position. Les tests lancés depuis « Try it » arrivent avec dry_run à true et le contact d'exemple 15550000000 ; ignorez-les pour que les tests ne créent jamais d'enregistrements dans le CRM.

Comment se présente le récepteur en Node.js ?

Une seule route Express reçoit les deux types d'événements. Elle lit le corps brut, choisit le secret selon l'en-tête X-EC-Event, vérifie X-EC-Signature, répond 200 immédiatement et confie le travail à une fonction en arrière-plan. L'objet crm représente le client API de votre CRM : un upsert du contact sur le numéro en chiffres seuls, et un upsert de l'activité sur sa clé unique. La même structure fonctionne pour un workflow n8n, avec un nœud Code pour la signature, suivi des nœuds de votre CRM.

Express receiver: forwards and Call my webhook steps into a CRM
import express from "express";
import crypto from "node:crypto";

const FORWARD_SECRET = process.env.EC_FORWARD_SECRET; // the number's, shown once with the Forward URL
const STEP_SECRET = process.env.EC_STEP_SECRET;       // the automation's Signing secret

function signed(req, secret) {
  const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(req.get("X-EC-Signature") || "");
  if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
  const mac = crypto.createHmac("sha256", secret).update(m[1] + "." + req.body).digest();
  return crypto.timingSafeEqual(mac, Buffer.from(m[2], "hex"));
}

const app = express();
app.post("/whatsapp/crm", express.text({ type: "application/json" }), (req, res) => {
  const kind = req.get("X-EC-Event"); // automation.step, or Meta's field name for a forward
  if (!signed(req, kind === "automation.step" ? STEP_SECRET : FORWARD_SECRET)) return res.status(401).end();
  res.json({}); // no reply field: nothing is sent to the customer
  handle(kind, JSON.parse(req.body)).catch(console.error);
});

async function handle(kind, body) {
  if (kind === "messages") {
    for (const m of body.value.messages ?? []) { // statuses are skipped
      const c = (body.value.contacts ?? []).find((x) => x.wa_id === m.from);
      const contact = await crm.upsertContact({ phone: m.from, bsuid: m.from_user_id, name: c?.profile?.name });
      await crm.upsertActivity({ key: m.id, contact, direction: "in", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
    }
  } else if (kind === "smb_message_echoes") {
    for (const m of body.value.message_echoes ?? []) {
      const contact = await crm.upsertContact({ phone: m.to, bsuid: m.to_user_id });
      await crm.upsertActivity({ key: m.id, contact, direction: "out", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
    }
  } else if (kind === "automation.step" && !body.dry_run) {
    const contact = await crm.upsertContact({ phone: body.contact.wa_id, name: body.contact.name });
    const sentAfter = body.history.filter((h) => h.direction === "out" && h.at >= body.message.at);
    for (const [i, h] of sentAfter.entries()) {
      await crm.upsertActivity({ key: body.run_id + ":" + i, contact, direction: "out", text: h.text, at: new Date(h.at) });
    }
  }
}

app.listen(3000);

Le CRM peut-il mettre à jour le lead à partir de ce que l'IA a appris ?

Oui, dans votre workflow. La conversation transmise par une étape Call my webhook contient les questions posées par votre IA et les réponses du client ; un nœud de modèle dans n8n ou un appel dans votre backend peut donc extraire le besoin, le budget, le délai ou la localisation, les écrire dans les champs du lead, puis faire évoluer son étape. Ne renvoyez aucune réponse, car le client a déjà reçu le message de l'IA. Lorsque le workflow juge un lead digne d'un appel, il peut créer une tâche pour un commercial ou alerter l'équipe. Vous pouvez aussi laisser easyCoexistence faire l'extraction : un agent ou une étape « an AI saves details » écrit le besoin, le budget et le délai dans les champs du contact, et une étape Call an API peut les envoyer à votre CRM avec des tokens du style {{contact.budget}} dans son corps. La page sur la qualification des leads contient les instructions d'entretien et le payload de cette configuration.

Comment le configurer

  1. Send the number's messages through easyCoexistenceOn the number's page, the Where incoming messages go card must be set to Through easyCoexistence; choose it if it shows Straight to your system.
  2. Deploy the receiverPublish the endpoint or n8n workflow on public HTTPS, with the CRM upserts keyed on the phone and the message id.
  3. Save the Forward URLPaste the receiver's URL into Forward URL (optional), click Save forward URL and store the signing secret shown once.
  4. Log automated repliesIn each automation that replies, add Call my webhook as the last step with the same URL, save, and copy that automation's Signing secret.
  5. Check one real conversationWrite to the number from another phone, let the automation answer, reply from the app, and confirm three activities on the contact: in, automated out and phone out.

Erreurs courantes

  • Chercher dans le CRM sur le champ téléphone en texte libre. Le format en chiffres seuls de WhatsApp correspond rarement à ce qu'une personne a saisi, et chaque échec crée un contact en double ; recherchez sur une propriété normalisée en chiffres seuls.
  • Appeler le CRM avant d'avoir répondu au transfert. Un CRM qui met plus de 10 secondes fait relancer easyCoexistence, et sans upsert sur le wamid, l'activité est journalisée deux fois.
  • Ne journaliser que le transfert en attendant les réponses automatisées. Les envois via l'API reviennent sous forme de statuts sans texte ; une étape Call my webhook placée après la réponse en transporte le contenu.
  • Laisser les tests atteindre le CRM. « Try it » appelle réellement votre URL avec dry_run à true et le contact d'exemple 15550000000 ; écartez ces événements avant tout upsert.
Faire cela avec EasyCoexistence

Sa Forward URL transmet les messages clients et les réponses téléphoniques à votre CRM sous forme d'événements Meta d'origine, signés par numéro et relancés pendant environ 33 heures si le CRM est indisponible ; une étape Call my webhook ajoute les réponses automatisées. Les transferts et les automatisations sont inclus dans le forfait. De US$ 9 à US$ 0,75 par numéro et par mois, dégressif à mesure que vous ajoutez des numéros, avec 3 jours d'essai gratuit.

Questions fréquemment posées

Avec quels CRM cela fonctionne-t-il ?

Avec n'importe quel CRM disposant d'une API, soit via votre propre backend, soit via un outil de workflow comme n8n, Make ou Zapier qui propose des nœuds pour celui-ci. HubSpot dispose d'un objet Communications avec un type de canal WhatsApp conçu pour journaliser ces messages ; la page dédiée à HubSpot montre l'appel.

Mon équipe peut-elle répondre aux clients depuis le CRM ?

Uniquement si le CRM envoie via l'API Cloud de Meta, avec l'endpoint d'envoi et le token du numéro issus de get_api_credentials : du texte libre dans les 24 heures suivant le dernier message du client, puis un template approuvé. Ces messages apparaissent aussi dans le fil de discussion de l'app sur le téléphone.

Peut-on charger les conversations passées dans le CRM ?

Uniquement par l'import d'historique de Meta, qui envoie jusqu'à 6 mois de discussions individuelles vers une destination webhook directe enregistrée dans les 24 heures suivant la connexion, une seule fois par connexion. Un numéro réglé sur « Through easyCoexistence » journalise dès que le transfert démarre.

Que conserve easyCoexistence en chemin ?

Les changements transférés sont mis en file d'attente pour les nouvelles tentatives, puis supprimés après 7 jours. Sur un numéro qui passe par easyCoexistence, le texte des messages reste aussi disponible pour Conversations et comme contexte pour l'IA pendant la durée que vous choisissez, 30, 90 ou 365 jours, et les journaux d'exécution sont conservés 30 jours. Le CRM conserve l'archive définitive.

Poursuivre la lecture

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 gratuit

Vérifié le