InloggenGratis proefperiode starten
Meta Tech Provider

WhatsApp-gesprekken automatisch naar je CRM sturen

Om WhatsApp-gesprekken automatisch naar een CRM te sturen, laat je binnenkomende berichten als ondertekende webhooks naar je backend of een workflowtool gaan, zoek of maak je het contact aan op basis van het telefoonnummer en registreer je het bericht als activiteit bij dat contact. Gebruik de bericht-id van WhatsApp als unieke sleutel van de activiteit, zodat een opnieuw verstuurde levering hetzelfde record bijwerkt in plaats van een tweede aan te maken.

easyCoexistence koppelt het WhatsApp Business-nummer dat je in de app gebruikt aan de Cloud API van Meta via Coexistence.

X-EC-Delivery

Header op een doorgestuurde POST met het leverings-id, identiek bij elke herhaling van die levering.

About 33 hours

Spanne van de 7 doorstuurpogingen, na ongeveer 1, 5, 30, 120, 360 en 1.440 minuten.

1 attempt

Een stap Call my webhook roept je URL één keer aan; een timeout of fout laat de run mislukken en stuurt je een e-mail.

BSUID

Bedrijfsgebonden gebruikers-ID, zoals US.13491208655302741918, verstuurd in user_id en from_user_id naast of in plaats van het telefoonnummer.

30 days

Hoe lang het automatiseringslog het triggerende bericht, het antwoord en elke stap bewaart.

Welke gebeurtenissen moeten het CRM bereiken?

Drie soorten berichten vormen samen een gesprek op een Coexistence-nummer, en twee routes brengen ze over. De Forward URL, per nummer ingesteld, stuurt wat klanten schrijven en wat je team typt in de WhatsApp Business-app, als de oorspronkelijke gebeurtenissen van Meta, die opnieuw worden geprobeerd tot je CRM antwoordt. Antwoorden die door automatiseringen zijn verstuurd, bereiken Meta via de API, die ze alleen als leveringsstatussen zonder tekst meldt; om hun woorden te registreren, sluit je de automatisering af met een stap Call my webhook, waarvan de geschiedenis het antwoord bevat dat de run net heeft verstuurd. Eén endpoint kan beide aan: de X-EC-Event-header geeft automation.step voor de stap en de veldnaam van Meta voor doorgestuurde berichten.

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

Hoe koppel je een WhatsApp-afzender aan een CRM-contact?

Op telefoonnummer, genormaliseerd. WhatsApp stuurt cijfers met landcode en zonder plusteken, zoals 5511987654321, in messages[].from bij doorgestuurde berichten en in contact.wa_id bij de webhookstap. CRM-records die mensen intypen bevatten +55 11 98765-4321 of (11) 98765-4321, dus bewaar een aparte eigenschap met de vorm met alleen cijfers en zoek daarop. Is er geen overeenkomst, maak dan het contact aan met de WhatsApp-profielnaam en het nummer.

Sla ook de bedrijfsgebonden gebruikers-ID op. Een gebruiker met een WhatsApp-gebruikersnaam die 30 dagen geen contact met je nummer heeft gehad, kan alleen de BSUID aanleveren in from_user_id en contacts[].user_id. Doorgestuurde berichten bevatten die; de webhookstap bevat het telefoonnummer.

Wat moet elk CRM-record bevatten?

Een contact met de identificatoren, en één activiteit per bericht met richting, tekst, tijd en een unieke sleutel. De kaart hieronder laat zien waar elke waarde staat op beide routes. Berichttijden bij doorgestuurde berichten zijn Unix-seconden van Meta; de webhookstap stuurt ISO-datums. Media komen bij doorgestuurde berichten aan als type en id, en bij de webhookstap als plaatshouders zoals [image] met het bijschrift, dus registreer een korte aanduiding in plaats van het bestand zelf op te slaan.

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

Hoe voorkom je dat herhalingen dubbele records maken?

Antwoord snel en gebruik overal een sleutel. Een doorgestuurd bericht dat binnen 10 seconden geen 2xx krijgt, wordt opnieuw geprobeerd met hetzelfde X-EC-Delivery-id, tot 7 pogingen; een CRM-aanroep die 12 seconden duurt, loopt daarom twee keer, tenzij de activiteit wordt geüpsert op de wamid. Antwoord eerst met 200 en voer het CRM-werk uit in een wachtrij of achtergrondtaak.

De webhookstap wordt niet opnieuw geprobeerd, en de eigen herhaalde leveringen van Meta worden gefilterd voordat een automatisering draait, dus die roept je hooguit één keer per bericht aan. De geschiedenisitems hebben geen bericht-id: sleutel geautomatiseerde antwoorden op run_id plus hun positie. Tests vanuit Try it komen aan met dry_run true en het voorbeeldcontact 15550000000; sla ze over, zodat testruns nooit CRM-records aanmaken.

Hoe ziet de ontvanger eruit in Node.js?

Eén Express-route neemt beide soorten gebeurtenissen aan. Hij leest de ruwe body, kiest het geheim op basis van de X-EC-Event-header, verifieert X-EC-Signature, antwoordt direct met 200 en geeft het werk door aan een achtergrondfunctie. Het crm-object staat voor de API-client van je CRM: een upsert van het contact op het telefoonnummer met alleen cijfers, en een upsert van de activiteit op de unieke sleutel. Dezelfde opzet werkt voor een n8n-workflow, met een Code-node voor de handtekening en daarna de nodes van je 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);

Kan het CRM de lead bijwerken met wat de AI heeft geleerd?

Ja, in je workflow. Het gesprek dat binnenkomt bij een stap Call my webhook bevat de vragen die je AI stelde en de antwoorden van de klant, dus een modelnode in n8n of een aanroep in je backend kan behoefte, budget, timing of locatie eruit halen en die in de velden van de lead schrijven, waarna de fase wordt verplaatst. Geef geen antwoord terug, want de klant heeft het bericht van de AI al ontvangen. Besluit de workflow dat een lead de moeite van een telefoontje waard is, dan kan hij een taak voor een verkoper aanmaken of het team waarschuwen. Of laat easyCoexistence het uithalen zelf doen: een agent of een stap AI saves details schrijft behoefte, budget en timing in de velden van het contact, en een stap Call an API kan ze naar je CRM posten met tokens in de stijl van {{contact.budget}} in de body. De pagina over leadkwalificatie bevat de interviewinstructies en de payload voor die opzet.

Zo stel je het in

  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.

Veelgemaakte fouten

  • Het CRM doorzoeken op het vrije tekstveld voor telefoonnummers. Het cijfersformaat van WhatsApp komt zelden overeen met wat iemand intypte, en elke misser maakt een dubbel contact; zoek op een genormaliseerde eigenschap met alleen cijfers.
  • Het CRM aanroepen voordat je op het doorgestuurde bericht antwoordt. Een CRM dat langer dan 10 seconden doet, zorgt dat easyCoexistence opnieuw probeert, en zonder upsert op de wamid wordt de activiteit twee keer geregistreerd.
  • Alleen het doorgestuurde bericht registreren en verwachten dat geautomatiseerde antwoorden erin staan. Verzendingen via de API komen terug als statussen zonder tekst; een stap Call my webhook na het antwoord bevat de woorden.
  • Tests het CRM laten bereiken. Try it roept je URL echt aan met dry_run true en het voorbeeldcontact 15550000000; verwijder die gebeurtenissen vóór elke upsert.
Dit doen met EasyCoexistence

De Forward URL geeft klantberichten en telefoonantwoorden door aan je CRM als de oorspronkelijke gebeurtenissen van Meta, per nummer ondertekend en ongeveer 33 uur opnieuw geprobeerd als het CRM uitligt, en een stap Call my webhook voegt de geautomatiseerde antwoorden toe. Doorsturen en automatiseringen zitten in het abonnement. Van US$ 9 tot US$ 0,75 per nummer per maand, dalend naarmate je nummers toevoegt, met de eerste 3 dagen als gratis proefperiode.

Veelgestelde vragen

Met welke CRM's werkt dit?

Met elk CRM met een API, via je eigen backend of via een workflowtool zoals n8n, Make of Zapier die er nodes voor heeft. HubSpot heeft een Communications-object met een WhatsApp-kanaaltype dat is gebouwd om deze berichten te registreren; de HubSpot-pagina laat de aanroep zien.

Kan mijn team vanuit het CRM antwoorden aan klanten sturen?

Alleen als het CRM via de Cloud API van Meta verstuurt, met het verzendendpoint en het token van het nummer uit get_api_credentials: vrije tekst binnen 24 uur na het laatste bericht van de klant, daarna een goedgekeurd template. Die berichten verschijnen ook in de chatthread van de app op de telefoon.

Kunnen eerdere gesprekken in het CRM worden geladen?

Alleen via de geschiedenisimport van Meta, die tot 6 maanden één-op-één chats stuurt naar een directe webhookbestemming die binnen 24 uur na het verbinden is opgeslagen, eenmaal per verbinding. Een nummer dat is ingesteld op Through easyCoexistence registreert vanaf het moment dat het doorsturen begint.

Wat bewaart easyCoexistence onderweg?

Doorgestuurde wijzigingen worden in de wachtrij gezet voor nieuwe pogingen en na 7 dagen verwijderd. Op een nummer dat via easyCoexistence loopt blijft berichttekst ook bewaard voor Conversations en AI-context, gedurende de periode die je kiest, 30, 90 of 365 dagen, en runlogs worden 30 dagen bewaard. Het CRM houdt het permanente record bij.

Lees verder

Klaar om te beginnen?

Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.

Start je gratis proefperiode

Geverifieerd op