AnmeldenKostenlose Testphase starten
Meta Tech Provider

WhatsApp-Gespräche automatisch an Ihr CRM senden

Um WhatsApp-Gespräche automatisch an ein CRM zu senden, lassen Sie eingehende Nachrichten als signierte Webhooks an Ihr Backend oder ein Workflow-Tool zustellen, suchen oder erstellen den Kontakt anhand der Telefonnummer und protokollieren die Nachricht als Aktivität bei diesem Kontakt. Verwenden Sie die WhatsApp-Nachrichten-ID als eindeutigen Schlüssel der Aktivität, damit eine wiederholte Zustellung denselben Datensatz aktualisiert, statt einen zweiten anzulegen.

easyCoexistence verbindet die WhatsApp-Business-Nummer, die Sie in der App führen, über Coexistence mit der Cloud API von Meta.

X-EC-Delivery

Header auf einem weitergeleiteten POST mit der Zustell-ID, bei jedem Wiederholungsversuch derselben Zustellung identisch.

About 33 hours

Zeitraum der 7 Weiterleitungsversuche, nach etwa 1, 5, 30, 120, 360 und 1,440 Minuten.

1 attempt

Ein Schritt „Call my webhook“ ruft Ihre URL einmal auf; ein Timeout oder Fehler lässt den Lauf fehlschlagen und sendet Ihnen eine E-Mail.

BSUID

Geschäftsbezogene Benutzer-ID, etwa US.13491208655302741918, die in user_id und from_user_id neben oder anstelle der Telefonnummer gesendet wird.

30 days

Wie lange das Ausführungsprotokoll der Automations die auslösende Nachricht, die Antwort und jeden Schritt speichert.

Welche Ereignisse sollten das CRM erreichen?

Drei Arten von Nachrichten ergeben eine Unterhaltung auf einer Coexistence-Nummer, und zwei Wege transportieren sie. Die Forward URL, pro Nummer festgelegt, sendet, was Kunden schreiben und was Ihr Team in der WhatsApp Business App eingibt, als ursprüngliche Ereignisse von Meta, die so lange erneut zugestellt werden, bis Ihr CRM antwortet. Antworten, die Automations senden, gelangen über die API zu Meta; dort werden sie nur als Zustellstatus ohne Text gemeldet. Um ihren Wortlaut zu protokollieren, beenden Sie die Automation mit einem Schritt „Call my webhook“, dessen Verlauf die Antwort enthält, die der Lauf gerade gesendet hat. Ein einziger Endpoint kann beides annehmen: Der Header X-EC-Event liefert automation.step für den Schritt und den Feldnamen von Meta für Weiterleitungen.

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

Wie ordnen Sie einen WhatsApp-Absender einem CRM-Kontakt zu?

Über die Telefonnummer, normalisiert. WhatsApp sendet Ziffern mit Ländervorwahl und ohne Pluszeichen, etwa 5511987654321, in messages[].from bei Weiterleitungen und in contact.wa_id beim Webhook-Schritt. Von Menschen erfasste CRM-Datensätze enthalten +55 11 98765-4321 oder (11) 98765-4321. Legen Sie deshalb eine eigene Eigenschaft mit der Form nur aus Ziffern an und suchen Sie darüber. Findet sich kein Treffer, erstellen Sie den Kontakt mit dem WhatsApp-Profilnamen und der Nummer.

Speichern Sie außerdem die geschäftsbezogene Benutzer-ID. Ein Nutzer mit WhatsApp-Benutzernamen, der 30 Tage lang nicht mit Ihrer Nummer in Kontakt war, kann nur mit der BSUID in from_user_id und contacts[].user_id eintreffen. Weiterleitungen enthalten sie; der Webhook-Schritt enthält die Telefonnummer.

Was sollte jeder CRM-Datensatz enthalten?

Ein Kontakt mit den Kennungen und eine Aktivität pro Nachricht mit Richtung, Text, Zeit und einem eindeutigen Schlüssel. Die Übersicht unten zeigt, wo jeder Wert auf beiden Wegen steht. Nachrichtenzeiten bei Weiterleitungen sind Unix-Sekunden von Meta; der Webhook-Schritt sendet ISO-Datumsangaben. Medien kommen bei Weiterleitungen als Typ und ID an, beim Webhook-Schritt als Platzhalter wie [image] mit der Bildunterschrift. Protokollieren Sie deshalb ein kurzes Kennzeichen, statt zu versuchen, die Datei zu speichern.

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

Wie verhindern Sie, dass Wiederholungen Duplikate erzeugen?

Antworten Sie schnell und versehen Sie alles mit einem Schlüssel. Eine Weiterleitung, die innerhalb von 10 Sekunden keine 2xx-Antwort erhält, wird mit derselben X-EC-Delivery-ID bis zu 7 Versuchen wiederholt. Ein CRM-Aufruf, der 12 Sekunden dauert, läuft daher zweimal, sofern die Aktivität nicht per Upsert über die wamid geschrieben wird. Antworten Sie zuerst mit 200 und erledigen Sie die CRM-Arbeit in einer Warteschlange oder einem Hintergrundjob.

Der Webhook-Schritt wird nicht wiederholt, und Metas eigene wiederholte Zustellungen werden gefiltert, bevor eine Automation läuft. Er ruft Sie daher höchstens einmal pro Nachricht auf. Seine Verlaufseinträge tragen keine Nachrichten-ID: Versehen Sie automatisierte Antworten mit einem Schlüssel aus run_id und ihrer Position. Tests aus Try it kommen mit dry_run true und dem Beispielkontakt 15550000000 an; überspringen Sie sie, damit Testläufe niemals CRM-Datensätze erzeugen.

Wie sieht der Empfänger in Node.js aus?

Eine einzige Express-Route nimmt beide Ereignisarten an. Sie liest den Rohtext, wählt den Geheimschlüssel anhand des Headers X-EC-Event, prüft X-EC-Signature, antwortet sofort mit 200 und übergibt die Arbeit an eine Hintergrundfunktion. Das Objekt crm steht für den API-Client Ihres CRM: ein Upsert des Kontakts über die Telefonnummer nur aus Ziffern und ein Upsert der Aktivität über ihren eindeutigen Schlüssel. Dieselbe Struktur funktioniert für einen n8n-Workflow, mit einem Code-Knoten für die Signatur und den Knoten Ihres CRM danach.

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);

Kann das CRM den Lead anhand dessen aktualisieren, was die KI erfahren hat?

Ja, in Ihrem Workflow. Der Chat, der mit einem Schritt „Call my webhook“ eintrifft, enthält die Fragen Ihrer KI und die Antworten des Kunden. Ein Modellknoten in n8n oder ein Aufruf in Ihrem Backend kann daher Bedarf, Budget, Zeitplan oder Standort extrahieren, in die Felder des Leads schreiben und anschließend seine Phase verschieben. Geben Sie keine Antwort zurück, da der Kunde die Nachricht der KI bereits hat. Entscheidet der Workflow, dass ein Lead einen Anruf wert ist, kann er eine Aufgabe für einen Vertriebsmitarbeiter anlegen oder das Team alarmieren. Oder lassen Sie easyCoexistence das Extrahieren übernehmen: Ein Schritt „Agent“ oder „AI saves details“ schreibt Bedarf, Budget und Zeitplan in die Felder des Kontakts, und ein Schritt „Call an API“ kann sie mit Tokens wie {{contact.budget}} in seinem Body an Ihr CRM senden. Die Seite zur Lead-Qualifizierung enthält die Interviewanweisungen und die Payload für diesen Aufbau.

So richten Sie es ein

  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.

Häufige Fehler

  • Die Suche im CRM über das Freitext-Telefonfeld. Das Format von WhatsApp mit nur Ziffern stimmt selten mit dem überein, was ein Mensch eingegeben hat, und jeder Fehltreffer erzeugt einen Duplikatkontakt. Suchen Sie stattdessen über eine normalisierte Eigenschaft nur mit Ziffern.
  • Das CRM aufruft, bevor die Weiterleitung beantwortet ist. Ein CRM, das länger als 10 Sekunden braucht, veranlasst easyCoexistence zu einer Wiederholung, und ohne Upsert über die wamid wird die Aktivität zweimal protokolliert.
  • Nur die Weiterleitung protokollieren und automatisierte Antworten darin erwarten. API-Sendungen kommen als Status ohne Text zurück; ein Schritt „Call my webhook“ nach der Antwort enthält den Wortlaut.
  • Tests bis zum CRM gelangen lassen. Try it ruft Ihre URL mit dry_run true und dem Beispielkontakt 15550000000 tatsächlich auf; verwerfen Sie diese Ereignisse vor jedem Upsert.
Mit EasyCoexistence

Ihre Forward URL leitet Kundennachrichten und Antworten per Telefon als ursprüngliche Ereignisse von Meta an Ihr CRM weiter, pro Nummer signiert und rund 33 Stunden lang erneut zugestellt, wenn das CRM nicht erreichbar ist. Ein Schritt „Call my webhook“ ergänzt die automatisierten Antworten. Weiterleitung und Automations sind im Tarif enthalten. US$ 9 bis US$ 0.75 pro Nummer und Monat, mit sinkendem Preis je weiterer Nummer, und die ersten 3 Tage gelten als kostenlose Testphase.

Häufig gestellte Fragen

Mit welchen CRMs funktioniert das?

Mit jedem CRM, das eine API hat, entweder über Ihr eigenes Backend oder über ein Workflow-Tool wie n8n, Make oder Zapier, das dafür Knoten besitzt. HubSpot hat ein Objekt Communications mit einem Kanaltyp WhatsApp, der für das Protokollieren dieser Nachrichten gedacht ist; die HubSpot-Seite zeigt den Aufruf.

Kann Ihr Team Kunden aus dem CRM antworten?

Nur, wenn das CRM über die Cloud API von Meta sendet, mit dem Sendeendpunkt der Nummer und dem Token aus get_api_credentials: Freitextnachrichten innerhalb von 24 Stunden nach der letzten Nachricht des Kunden, danach ein genehmigtes Template. Diese Nachrichten erscheinen auch im Chatverlauf der App auf dem Telefon.

Können frühere Gespräche in das CRM geladen werden?

Nur über den Verlaufsimport von Meta, der bis zu 6 Monate Einzelchats an ein direktes Webhook-Ziel sendet, das innerhalb von 24 Stunden nach der Verbindung gespeichert wurde, einmal pro Verbindung. Eine Nummer mit der Einstellung Through easyCoexistence protokolliert ab dem Start der Weiterleitung.

Was speichert easyCoexistence dabei?

Weitergeleitete Änderungen werden für Wiederholungen in eine Warteschlange gestellt und nach 7 Tagen entfernt. Bei einer Nummer, die über easyCoexistence läuft, bleibt der Nachrichtentext außerdem für Conversations und den KI-Kontext so lange gespeichert, wie Sie wählen: 30, 90 oder 365 Tage; Ausführungsprotokolle werden 30 Tage aufbewahrt. Den dauerhaften Datensatz führt das CRM.

Weiterlesen

Bereit für den Start?

Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.

Kostenlose Testphase starten

Verifiziert am