Automatski šaljite WhatsApp razgovore u vaš CRM
Da biste WhatsApp razgovore automatski slali u CRM, dolazne poruke dostavljajte kao potpisane webhookove na svoj backend ili alat za automatizaciju, pronađite ili stvorite kontakt po broju telefona i poruku zabilježite kao aktivnost na tom kontaktu. Za jedinstveni ključ aktivnosti upotrijebite ID WhatsApp poruke, pa ponovljena isporuka ažurira isti zapis umjesto da stvori drugi.
easyCoexistence povezuje WhatsApp Business broj koji držite u aplikaciji s Metinim Cloud API-jem putem Coexistence.
Zaglavlje prosljeđenog POST zahtjeva nosi ID isporuke, koji je isti pri svakom ponovnom pokušaju te isporuke.
Raspon 7 pokušaja prosljeđivanja, nakon otprilike 1, 5, 30, 120, 360 i 1.440 minuta.
Korak Call my webhook poziva vaš URL jednom; timeout ili pogreška prekida pokretanje i šalje vam e-poruku.
Poslovno ograničen korisnički ID, primjerice US.13491208655302741918, šalje se u user_id i from_user_id uz broj telefona ili umjesto njega.
Koliko dugo dnevnik pokretanja automatizacije čuva okidačku poruku, odgovor i svaki korak.
Koji događaji trebaju stići u CRM?
Tri vrste poruka čine razgovor na Coexistence broju, a dva puta ih prenose. Forward URL, postavljen po broju, šalje ono što kupci napišu i što vaš tim upiše u aplikaciji WhatsApp Business, kao izvorne Metine događaje, uz ponovne pokušaje dok CRM ne odgovori. Odgovori koje šalju automatizacije stižu do Mete putem API-ja, koji ih prijavljuje samo kao statuse isporuke bez teksta; da biste zabilježili njihov sadržaj, završite automatizaciju korakom Call my webhook, čija povijest uključuje odgovor koji je pokretanje upravo poslalo. Jedan endpoint može primiti oba: zaglavlje X-EC-Event za korak daje automation.step, a za proslijeđene poruke naziv polja koji šalje Meta.
Kako WhatsApp pošiljatelja uskladiti s CRM kontaktom?
Po broju telefona, normaliziranom. WhatsApp šalje znamenke s pozivnim brojem bez znaka plus, primjerice 5511987654321, u messages[].from kod proslijeđenih poruka i u contact.wa_id kod koraka webhooka. CRM zapisi koje upisuju ljudi sadrže npr. +55 11 98765-4321 ili (11) 98765-4321, pa čuvajte posebno svojstvo s oblikom samo od znamenki i pretražujte po njemu. Kad ništa ne odgovara, stvorite kontakt s imenom WhatsApp profila i brojem.
Pohranite i poslovno ograničen korisnički ID. Korisnik s WhatsApp korisničkim imenom koji 30 dana nije bio u kontaktu s vašim brojem može stići samo s BSUID-om u from_user_id i contacts[].user_id. Proslijeđene poruke ga nose; korak webhooka nosi broj telefona.
Što bi svaki CRM zapis trebao sadržavati?
Kontakt s identifikatorima i po jednu aktivnost za svaku poruku, sa smjerom, tekstom, vremenom i jedinstvenim ključem. Pregled niže pokazuje gdje se svaka vrijednost nalazi na jednom i drugom putu. Vremena poruka kod proslijeđenih poruka su Unix sekunde iz Mete; korak webhooka šalje ISO datume. Mediji stižu kao vrsta i ID kod proslijeđenih poruka, a kao oznake poput [image] s opisom kod koraka webhooka, pa zabilježite kratku oznaku umjesto pokušaja pohrane datoteke.
| 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 |
Kako spriječiti da ponovni pokušaji stvore duplikate?
Odgovorite brzo, a zatim sve označite jedinstvenim ključem. Proslijeđena poruka koja ne dobije 2xx unutar 10 sekundi šalje se ponovno s istim X-EC-Delivery ID-om, najviše 7 puta; poziv CRM-u koji traje 12 sekundi stoga se izvrši dvaput, osim ako aktivnost ne unosite kao upsert po wamid-u. Prvo odgovorite 200, a rad s CRM-om obavite u redu čekanja ili pozadinskom zadatku.
Korak webhooka se ne ponavlja, a Metina vlastita ponovljena isporuka filtrira se prije nego se automatizacija pokrene, pa vas poziva najviše jednom po poruci. Stavke povijesti nemaju ID poruke: automatizirane odgovore označite po run_id i položaju u nizu. Testovi iz Try it stižu s dry_run true i uzorkom kontakta 15550000000; preskočite ih da testna pokretanja nikad ne stvaraju zapise u CRM-u.
Kako izgleda primatelj u Node.js?
Jedna Express ruta prima obje vrste događaja. Čita sirovo tijelo, bira tajnu prema zaglavlju X-EC-Event, provjerava X-EC-Signature, odmah odgovara 200 i predaje posao pozadinskoj funkciji. Objekt crm predstavlja API klijent vašeg CRM-a: upsert kontakta po broju telefona samo od znamenki i upsert aktivnosti po njezinom jedinstvenom ključu. Isti oblik radi i za n8n tijek rada, s Code čvorom za potpis i čvorovima vašeg CRM-a nakon njega.
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);Može li CRM ažurirati lead iz onoga što je AI naučio?
Da, u vašem tijeku rada. Razgovor koji stiže s korakom Call my webhook sadrži pitanja koja je vaš AI postavio i odgovore kupaca, pa čvor modela u n8n ili poziv u vašem backendu može izvući potrebu, budžet, vrijeme ili lokaciju te ih upisati u polja leada, zatim pomaknuti njegovu fazu. Ne vraćajte odgovor, jer kupac već ima AI-jevu poruku. Kad tijek rada odluči da lead vrijedi poziva, može stvoriti zadatak za prodavača ili obavijestiti tim. Ili neka izvlačenje obavi easyCoexistence: agent ili korak AI saves details upisuje potrebu, budžet i vrijeme u polja kontakta, a korak Call an API može ih poslati u vaš CRM s tokenima u stilu {{contact.budget}} u svom tijelu. Stranica o kvalifikaciji leadova sadrži upute za intervju i payload za to postavljanje.
Kako ga postaviti
- 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.
Uobičajene pogreške
- Pretraživanje CRM-a po polju telefona slobodnog unosa. WhatsApp format samo od znamenki rijetko se poklapa s onim što je osoba upisala, a svaki promašaj stvara duplikat kontakta; pretražujte normalizirano svojstvo samo od znamenki.
- Pozivanje CRM-a prije odgovora na proslijeđenu poruku. CRM koji traje dulje od 10 sekundi tjera easyCoexistence na ponovni pokušaj, a bez upserta po wamid-u aktivnost se bilježi dvaput.
- Bilježenje samo proslijeđenih poruka uz očekivanje da će automatizirani odgovori biti u njima. Slanja putem API-ja vraćaju se kao statusi bez teksta; korak Call my webhook nakon odgovora nosi riječi.
- Dopuštanje da testovi dođu do CRM-a. Try it zaista poziva vaš URL s dry_run true i uzorkom kontakta 15550000000; odbacite te događaje prije svakog upserta.
Njegov Forward URL prosljeđuje poruke kupaca i telefonske odgovore vašem CRM-u kao izvorne Metine događaje, potpisane po broju i ponovljene otprilike 33 sata kad je CRM nedostupan, a korak Call my webhook dodaje automatizirane odgovore. Prosljeđivanje i automatizacije uključeni su u plan. US$ 9 do US$ 0.75 po broju mjesečno, a cijena pada kako dodajete brojeve, s prvih 3 dana besplatno.
Često postavljana pitanja
S kojim CRM-ovima ovo radi?
S bilo kojim CRM-om koji ima API, bilo preko vašeg backenda, bilo preko alata za automatizaciju poput n8n, Make ili Zapier s čvorovima za to. HubSpot ima objekt Communications s vrstom kanala WhatsApp, namijenjen bilježenju ovih poruka; stranica o HubSpotu prikazuje poziv.
Može li tim odgovarati kupcima iz CRM-a?
Samo ako CRM šalje putem Metinog Cloud API-ja, s endpointom za slanje broja i tokenom iz get_api_credentials: slobodan tekst unutar 24 sata od posljednje poruke kupca, a nakon toga odobreni predložak. Te poruke se pojavljuju i u razgovoru u aplikaciji na telefonu.
Mogu li se prošli razgovori učitati u CRM?
Samo putem Metinog uvoza povijesti, koji šalje do 6 mjeseci individualnih razgovora na izravno odredište webhooka spremljeno unutar 24 sata od povezivanja, jednom po vezi. Broj postavljen na Through easyCoexistence bilježi od trenutka kad počne prosljeđivanje.
Što easyCoexistence čuva usput?
Proslijeđene promjene stavljaju se u red za ponovna slanja i uklanjaju nakon 7 dana. Na broju koji ide preko easyCoexistence tekst poruka također ostaje za Conversations i kontekst za AI onoliko dugo koliko odaberete, 30, 90 ili 365 dana, a dnevnici pokretanja čuvaju se 30 dana. Trajni zapis vodi CRM.
Nastavite čitati
Spremni za početak?
Postavite WhatsApp Coexistence u nekoliko minuta, a ne mjeseci. Aplikacija i dalje radi na telefonu.
Započnite besplatno probno razdobljeProvjereno na