Automatski šaljite WhatsApp razgovore u svoj CRM
Da biste WhatsApp razgovore automatski slali u CRM, neka se dolazne poruke isporučuju kao potpisani webhookovi na vaš backend ili alat za automatizaciju, pronađite ili kreirajte kontakt po broju telefona i zabeležite poruku kao aktivnost na tom kontaktu. Koristite ID WhatsApp poruke kao jedinstveni ključ aktivnosti, tako da ponovljena isporuka ažurira isti zapis umesto da kreira drugi.
easyCoexistence povezuje WhatsApp Business broj koji čuvate u aplikaciji sa Meta Cloud API-jem preko Coexistence.
Zaglavlje na prosleđenom POST zahtevu koje nosi ID isporuke, identičan pri svakom ponovnom pokušaju te isporuke.
Raspon 7 pokušaja prosleđivanja, posle otprilike 1, 5, 30, 120, 360 i 1,440 minuta.
Korak Call my webhook poziva vaš URL jednom; tajmaut ili greška prekidaju izvršavanje i šalju vam e-poruku.
Korisnički ID vezan za firmu, poput US.13491208655302741918, šalje se u user_id i from_user_id uz broj telefona ili umesto njega.
Koliko dugo dnevnik izvršavanja automatizacije čuva poruku koja ga je pokrenula, odgovor i svaki korak.
Koje događaje treba da primi CRM?
Tri vrste poruka čine razgovor na Coexistence broju, a dve rute ih prenose. Forward URL, podešen po broju, šalje ono što pišu klijenti i ono što vaš tim kuca u WhatsApp Business aplikaciji, kao originalne Meta događaje, uz ponovne pokušaje dok CRM ne odgovori. Odgovore koje šalju automatizacije Meta prima preko API-ja, koji ih prijavljuje samo kao statuse isporuke bez teksta; da biste zabeležili njihove reči, završite automatizaciju korakom Call my webhook, čija istorija uključuje odgovor koji je izvršavanje upravo poslalo. Jedna krajnja tačka može da primi oba: zaglavlje X-EC-Event za korak čita automation.step, a za prosleđene poruke naziv Meta polja.
Kako se pošiljalac na WhatsApp-u povezuje sa CRM kontaktom?
Po broju telefona, normalizovanom. WhatsApp šalje cifre sa pozivnim brojem i bez znaka plus, poput 5511987654321, u messages[].from kod prosleđenih poruka i u contact.wa_id na koraku webhook-a. Zapisi u CRM-u koje unose ljudi sadrže +55 11 98765-4321 ili (11) 98765-4321, pa čuvajte posebno polje sa oblikom samo cifara i pretražujte po njemu. Kada nema podudaranja, kreirajte kontakt sa imenom WhatsApp profila i brojem.
Sačuvajte i korisnički ID vezan za firmu. Korisnik sa WhatsApp korisničkim imenom koji 30 dana nije pisao na vaš broj može stići samo sa BSUID-om u from_user_id i contacts[].user_id. Prosleđene poruke ga nose; korak webhook-a nosi broj telefona.
Šta treba da sadrži svaki CRM zapis?
Kontakt sa identifikatorima i jedna aktivnost po poruci, sa smerom, tekstom, vremenom i jedinstvenim ključem. Mapa ispod pokazuje gde se svaka vrednost nalazi na svakoj ruti. Vremena poruka kod prosleđenih poruka su Unix sekunde koje šalje Meta; korak webhook-a šalje ISO datume. Mediji stižu kao tip i ID kod prosleđenih poruka, a na koraku webhook-a kao oznake poput [image] sa natpisom, pa zabeležite kratku oznaku umesto da pokušavate da čuvate fajl.
| 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 sprečiti da ponovni pokušaji naprave duplikate?
Odgovorite brzo, pa sve vezujte za jedinstveni ključ. Prosleđena poruka koja ne dobije 2xx u roku od 10 sekundi ponavlja se sa istim X-EC-Delivery ID-jem, do 7 pokušaja; poziv CRM-u koji traje 12 sekundi zato se izvršava dvaput, osim ako se aktivnost ne izvrši kao upsert po wamid-u. Prvo odgovorite sa 200, a rad sa CRM-om obavite u redu čekanja ili pozadinskom zadatku.
Korak webhook-a se ne ponavlja, a dupli prenosi koje šalje sama Meta filtriraju se pre pokretanja automatizacije, pa vas poziva najviše jednom po poruci. Stavke istorije nemaju ID poruke: automatske odgovore vezujte za run_id i njihovu poziciju. Probni pozivi iz Try it stižu sa dry_run true i test kontaktom 15550000000; preskočite ih da test izvršavanja nikad ne napravi zapise u CRM-u.
Kako izgleda prijemnik u Node.js-u?
Jedna Express ruta prima oba tipa događaja. Čita sirovo telo, bira tajnu prema zaglavlju X-EC-Event, proverava X-EC-Signature, odmah odgovara sa 200 i predaje posao pozadinskoj funkciji. Objekat crm predstavlja API klijent vašeg CRM-a: upsert kontakta po telefonu samo sa ciframa i upsert aktivnosti po njenom jedinstvenom ključu. Isti oblik radi i za n8n tok, sa Code čvorom za potpis i čvorovima vašeg CRM-a posle 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 da ažurira lead na osnovu onoga što je AI saznao?
Da, u vašem toku rada. Razgovor koji stiže uz korak Call my webhook sadrži pitanja koja je AI postavio i odgovore kupca, pa čvor modela u n8n-u ili poziv u vašem backendu može da izdvoji potrebu, budžet, rok ili lokaciju i upiše ih u polja leada, a zatim pomeri njegovu fazu. Ne vraćajte odgovor, jer kupac već ima AI-jevu poruku. Kada tok odluči da je lead vredan poziva, može da kreira zadatak za prodavca ili obavesti tim. Ili neka easyCoexistence izdvoji podatke: agent ili korak AI saves details upisuje potrebu, budžet i rok u polja kontakta, a korak Call an API može da ih pošalje u vaš CRM pomoću tokena oblika {{contact.budget}} u svom telu. Stranica o kvalifikaciji leadova sadrži uputstva za razgovor i payload za takvo podešavanje.
Kako da podesite
- 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.
Česte greške
- Pretraga CRM-a po polju za telefon u koje je slobodan tekst. WhatsApp-ov format samo sa ciframa retko se poklapa sa onim što je osoba ukucala, a svaki promašaj pravi duplikat kontakta; pretražujte normalizovano polje sa samo ciframa.
- Poziv CRM-a pre odgovora na prosleđenu poruku. CRM koji traje duže od 10 sekundi navodi easyCoexistence da ponovi pokušaj, a bez upserta po wamid-u aktivnost se beleži dvaput.
- Beleženje samo prosleđenih poruka i očekivanje da će automatski odgovori biti u njima. Slanja preko API-ja vraćaju se kao statusi bez teksta; korak Call my webhook posle odgovora nosi reči.
- Dozvoljavanje testovima da stignu do CRM-a. Try it zaista poziva vaš URL sa dry_run true i test kontaktom 15550000000; odbacite te događaje pre bilo kakvog upserta.
Njegov Forward URL prosleđuje poruke kupaca i telefonske odgovore vašem CRM-u kao originalne Meta događaje, potpisane po broju i ponavljane oko 33 sata kada je CRM nedostupan, a korak Call my webhook dodaje automatske odgovore. Prosleđivanje i automatizacije su uključeni u plan. Od US$ 9 do US$ 0.75 po broju mesečno, uz pad kako dodajete brojeve, uz prva 3 dana besplatno.
Često postavljana pitanja
Sa kojim CRM-ovima ovo radi?
Sa bilo kojim CRM-om koji ima API, bilo preko sopstvenog backenda ili preko alata za automatizaciju poput n8n, Make ili Zapier, koji imaju čvorove za to. HubSpot ima objekat Communications sa tipom kanala WhatsApp, namenjen beleženju ovih poruka; stranica o HubSpot-u prikazuje poziv.
Može li tim da odgovara kupcima iz CRM-a?
Samo ako CRM šalje preko Meta Cloud API-ja, sa endpointom za slanje broja i tokenom iz get_api_credentials: slobodan tekst u roku od 24 sata od poslednje poruke kupca, a posle toga odobren šablon. Te poruke se takođe pojavljuju u razgovoru u aplikaciji na telefonu.
Mogu li prethodni razgovori da se učitaju u CRM?
Samo preko uvoza istorije koji nudi Meta, koji šalje do 6 meseci pojedinačnih razgovora na direktnu webhook destinaciju sačuvanu u roku od 24 sata od povezivanja, jednom po vezi. Broj podešen na Through easyCoexistence beleži od trenutka kada počne prosleđivanje.
Šta easyCoexistence čuva usput?
Prosleđene promene stoje u redu za ponovne pokušaje i uklanjaju se posle 7 dana. Na broju koji ide preko easyCoexistence tekst poruka se takođe čuva za Conversations i AI kontekst onoliko dugo koliko izaberete, 30, 90 ili 365 dana, a dnevnici izvršavanja čuvaju se 30 dana. CRM čuva trajni zapis.
Nastavite sa čitanjem
Spremni da počnete?
Podesite WhatsApp Coexistence za nekoliko minuta, a ne meseci. Aplikacija nastavlja da radi na telefonu.
Započnite besplatni probni periodProvereno na