Trimite automat conversațiile WhatsApp în CRM-ul tău
Pentru a trimite automat conversațiile WhatsApp în CRM, configurați livrarea mesajelor primite ca webhook-uri semnate către backend-ul dumneavoastră sau către un instrument de automatizare, găsiți sau creați contactul după numărul de telefon și înregistrați mesajul ca activitate pe acel contact. Folosiți ID-ul mesajului WhatsApp drept cheie unică a activității, astfel încât o livrare reîncercată să actualizeze aceeași înregistrare în loc să creeze una nouă.
easyCoexistence conectează numărul WhatsApp Business pe care îl păstrați în aplicație la Cloud API de la Meta prin Coexistence.
Antet pe POST-ul redirecționat, care poartă ID-ul livrării, identic la fiecare reîncercare a aceleiași livrări.
Durata celor 7 încercări de redirecționare, după aproximativ 1, 5, 30, 120, 360 și 1,440 de minute.
Un pas Call my webhook apelează URL-ul o singură dată; un timeout sau o eroare face ca rularea să eșueze și vă trimite un e-mail.
ID-ul utilizatorului limitat la firmă, de exemplu US.13491208655302741918, trimis în user_id și from_user_id, lângă numărul de telefon sau în locul lui.
Cât timp păstrează jurnalul rulării automatizării mesajul declanșator, răspunsul și fiecare pas.
Ce evenimente ar trebui să ajungă în CRM?
Trei tipuri de mesaje formează o conversație pe un număr Coexistence, iar două rute le transportă. Forward URL, setat pentru fiecare număr, trimite ce scriu clienții și ce tastează echipa în aplicația WhatsApp Business, ca evenimente originale Meta, reîncercate până când CRM-ul răspunde. Răspunsurile trimise de automatizări ajung la Meta prin API, care le raportează doar ca stări de livrare, fără text; pentru a le înregistra cuvintele, încheiați automatizarea cu un pas Call my webhook, al cărui istoric include răspunsul pe care rularea tocmai l-a trimis. Un singur endpoint poate primi ambele: antetul X-EC-Event are valoarea automation.step pentru pas și numele câmpului Meta pentru redirecționări.
Cum potriviți un expeditor WhatsApp cu un contact din CRM?
După numărul de telefon, normalizat. WhatsApp trimite cifre cu prefixul țării și fără semnul plus, de exemplu 5511987654321, în messages[].from la redirecționări și în contact.wa_id la pasul webhook. Înregistrările din CRM introduse de oameni conțin +55 11 98765-4321 sau (11) 98765-4321, deci păstrați o proprietate dedicată cu forma doar cu cifre și căutați după ea. Când nu există potrivire, creați contactul cu numele profilului WhatsApp și numărul.
Stocați și ID-ul utilizatorului limitat la firmă. Un utilizator cu un nume de utilizator WhatsApp, care nu a mai fost în contact cu numărul dumneavoastră de 30 de zile, poate sosi cu doar BSUID-ul în from_user_id și contacts[].user_id. Redirecționările îl transportă; pasul webhook transportă numărul de telefon.
Ce ar trebui să conțină fiecare înregistrare din CRM?
Un contact cu identificatorii și o activitate pentru fiecare mesaj, cu direcție, text, oră și o cheie unică. Harta de mai jos arată unde se află fiecare valoare pe fiecare rută. Orele mesajelor la redirecționări sunt secunde Unix de la Meta; pasul webhook trimite date ISO. Fișierele media sosesc ca tip și ID la redirecționări și ca substituenți precum [image], cu legenda, la pasul webhook; așadar înregistrați o etichetă scurtă, în loc să încercați să stocați fișierul.
| Forwarded event (value is Meta's) | Call my webhook step | |
|---|---|---|
| Contact phone | messages[].from | contact.wa_id |
| Contact name | contacts[].profile.name | contact.name |
| BSUID | contacts[].user_id, messages[].from_user_id | Not sent |
| Activity text | text.body, or the media type | message.text and history[].text |
| Direction | messages = in, smb_message_echoes = out | history[].direction: in, out or echo |
| Time | timestamp, Unix seconds | message.at and history[].at, ISO 8601 |
| Unique key | messages[].id (wamid) | message.id; run_id for history entries |
Cum împiedicați reîncercările să creeze duplicate?
Răspundeți rapid, apoi indexați totul pe cheie. O redirecționare care nu primește un răspuns 2xx în 10 secunde este reîncercată cu același X-EC-Delivery, până la 7 încercări; un apel CRM care durează 12 secunde se execută deci de două ori, dacă activitatea nu se face upsert pe wamid. Răspundeți mai întâi cu 200 și faceți lucrul în CRM într-o coadă sau un job de fundal.
Pasul webhook nu este reîncercat, iar livrările repetate ale Meta sunt filtrate înainte ca o automatizare să ruleze, deci vă apelează cel mult o dată pentru fiecare mesaj. Intrările din istoric nu conțin ID de mesaj: indexați răspunsurile automate pe run_id plus poziția lor. Testele din Try it sosesc cu dry_run true și contactul de probă 15550000000; ignorați-le, ca rulările de test să nu creeze niciodată înregistrări în CRM.
Cum arată receptorul în Node.js?
O singură rută Express primește ambele tipuri de evenimente. Citește corpul brut, alege secretul după antetul X-EC-Event, verifică X-EC-Signature, răspunde imediat cu 200 și transmite lucrul unei funcții de fundal. Obiectul crm reprezintă clientul API al CRM-ului dumneavoastră: un upsert al contactului pe numărul de telefon doar cu cifre și un upsert al activității pe cheia sa unică. Aceeași structură funcționează pentru un workflow n8n, cu un nod Code pentru semnătură și nodurile CRM-ului după el.
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);Poate CRM-ul să actualizeze clientul potențial cu ce a aflat AI-ul?
Da, în workflow-ul dumneavoastră. Chatul care sosește cu un pas Call my webhook conține întrebările pe care le-a pus AI-ul și răspunsurile clientului, deci un nod de model în n8n sau un apel în backend-ul dumneavoastră poate extrage nevoia, bugetul, termenul sau locația și le poate scrie în câmpurile clientului potențial, apoi îi poate muta etapa. Nu returnați niciun răspuns, deoarece clientul a primit deja mesajul AI-ului. Când workflow-ul decide că un client potențial merită un apel, poate crea o sarcină pentru un agent de vânzări sau poate alerta echipa. Sau lăsați easyCoexistence să facă extragerea: un agent sau un pas AI saves details scrie nevoia, bugetul și termenul în câmpurile clientului, iar un pas Call an API le poate trimite către CRM-ul dumneavoastră cu tokeni de forma {{contact.budget}} în corpul său. Pagina despre calificarea clienților potențiali are instrucțiunile de interviu și payload-ul pentru această configurare.
Cum să îl configurați
- 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.
- Deploy the receiverPublish the endpoint or n8n workflow on public HTTPS, with the CRM upserts keyed on the phone and the message id.
- Save the Forward URLPaste the receiver's URL into Forward URL (optional), click Save forward URL and store the signing secret shown once.
- 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.
- 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.
Greșeli frecvente
- Căutarea în CRM după câmpul de telefon scris liber. Formatul WhatsApp doar cu cifre rareori se potrivește cu ce tastează o persoană, iar fiecare nepotrivire creează un contact duplicat; căutați după o proprietate normalizată doar cu cifre.
- Apelarea CRM-ului înainte de a răspunde la redirecționare. Un CRM care durează mai mult de 10 secunde determină easyCoexistence să reîncerce, iar fără upsert pe wamid activitatea este înregistrată de două ori.
- Înregistrarea doar a redirecționării și așteptarea răspunsurilor automate în ea. Trimiterile API revin ca stări de livrare fără text; un pas Call my webhook după răspuns transportă cuvintele.
- Lăsarea testelor să ajungă în CRM. Try it apelează cu adevărat URL-ul dumneavoastră cu dry_run true și contactul de probă 15550000000; eliminați aceste evenimente înainte de orice upsert.
Forward URL trimite mesajele clienților și răspunsurile telefonice către CRM-ul dumneavoastră ca evenimente originale Meta, semnate pentru fiecare număr și reîncercate timp de aproximativ 33 de ore când CRM-ul este oprit, iar un pas Call my webhook adaugă răspunsurile automate. Redirecționarea și automatizările sunt incluse în plan. De la US$ 9 per număr conectat pe lună, scăzând la US$ 0.75 pe măsură ce adăugați numere, cu primele 3 zile gratuite.
Întrebări frecvente
Cu ce CRM-uri funcționează aceasta?
Cu orice CRM care are un API, fie prin propriul backend, fie printr-un instrument de automatizare precum n8n, Make sau Zapier, care are noduri pentru el. HubSpot are un obiect Communications cu un tip de canal WhatsApp, creat pentru înregistrarea acestor mesaje; pagina HubSpot arată apelul.
Poate echipa mea să răspundă clienților din CRM?
Doar dacă CRM-ul trimite prin Cloud API de la Meta, cu endpoint-ul de trimitere al numărului și token-ul din get_api_credentials: text liber în 24 de ore de la ultimul mesaj al clientului, iar după aceea un șablon aprobat. Aceste mesaje apar și în firul de chat din aplicația de pe telefon.
Pot fi încărcate conversațiile anterioare în CRM?
Doar prin importul istoricului de la Meta, care trimite până la 6 luni de conversații one-to-one către o destinație webhook directă salvată în 24 de ore de la conectare, o singură dată pentru fiecare conexiune. Un număr setat la „Through easyCoexistence” ține jurnal din momentul în care începe redirecționarea.
Ce păstrează easyCoexistence pe parcurs?
Modificările redirecționate sunt puse în coadă pentru reîncercări și eliminate după 7 zile. Pe un număr care trece prin easyCoexistence, textul mesajelor rămâne și pentru Conversations și contextul AI pe perioada pe care o alegeți, 30, 90 sau 365 de zile, iar jurnalele rulărilor sunt păstrate 30 de zile. CRM-ul păstrează înregistrarea permanentă.
Continuați să citiți
Gata să începeți?
Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.
Începeți perioada de probă gratuităVerificat la