Automatycznie przesyłaj rozmowy WhatsApp do CRM
Aby automatycznie przesyłać rozmowy WhatsApp do CRM, dostarczaj przychodzące wiadomości jako podpisane webhooki do swojego backendu lub narzędzia do automatyzacji, znajdź albo utwórz kontakt po numerze telefonu i zapisz wiadomość jako aktywność przypisaną do tego kontaktu. Użyj identyfikatora wiadomości WhatsApp jako unikalnego klucza aktywności, dzięki czemu ponowiona dostawa aktualizuje ten sam rekord zamiast tworzyć drugi.
easyCoexistence łączy numer WhatsApp Business, który trzymasz w aplikacji, z Cloud API Meta przez Coexistence.
Nagłówek przekazywanego żądania POST zawiera identyfikator dostawy; jest taki sam przy każdym ponowieniu tej dostawy.
Przedział 7 prób przekazania, po około 1, 5, 30, 120, 360 i 1 440 minutach.
Krok Call my webhook wywołuje Twój adres URL jeden raz; przekroczenie limitu czasu lub błąd kończy uruchomienie i wysyła do Ciebie e-mail.
Identyfikator użytkownika w zakresie firmy, na przykład US.13491208655302741918, przesyłany w user_id i from_user_id obok numeru telefonu lub zamiast niego.
Jak długo dziennik przebiegów automatyzacji przechowuje wiadomość wyzwalającą, odpowiedź i każdy krok.
Które zdarzenia powinny trafiać do CRM?
Rozmowa na numerze Coexistence składa się z trzech rodzajów wiadomości, a przenoszą je dwie trasy. Forward URL, ustawiany osobno dla każdego numeru, przesyła to, co piszą klienci i co Twój zespół wpisuje w aplikacji WhatsApp Business, jako oryginalne zdarzenia Meta, ponawiane, dopóki CRM nie odpowie. Odpowiedzi wysyłane przez automatyzacje trafiają do Meta przez API, które raportuje je tylko jako statusy dostarczenia, bez treści; aby zapisać ich słowa, zakończ automatyzację krokiem Call my webhook, którego historia zawiera odpowiedź właśnie wysłaną przez przebieg. Jeden endpoint może obsłużyć oba: nagłówek X-EC-Event wskazuje automation.step dla kroku, a nazwę pola Meta dla przekazanych zdarzeń.
Jak dopasować nadawcę WhatsApp do kontaktu w CRM?
Po numerze telefonu, znormalizowanym. WhatsApp wysyła cyfry z kodem kraju, bez znaku plus, na przykład 5511987654321, w messages[].from w przekazaniach oraz w contact.wa_id w kroku Call my webhook. Rekordy w CRM wpisywane przez ludzi zawierają +55 11 98765-4321 lub (11) 98765-4321, dlatego zachowaj osobną właściwość z postacią samych cyfr i wyszukuj po niej. Gdy nic nie pasuje, utwórz kontakt z nazwą profilu WhatsApp i numerem.
Zapisz też identyfikator użytkownika w zakresie firmy. Użytkownik z nazwą użytkownika WhatsApp, który nie kontaktował się z Twoim numerem przez 30 dni, może przyjść tylko z BSUID w from_user_id i contacts[].user_id. Przekazania zawierają go; krok Call my webhook zawiera numer telefonu.
Co powinien zawierać każdy rekord w CRM?
Kontakt z identyfikatorami oraz jedną aktywność na wiadomość, z kierunkiem, treścią, czasem i unikalnym kluczem. Poniższa mapa pokazuje, gdzie każda wartość znajduje się na każdej z tras. Czasy wiadomości w przekazaniach to sekundy Unix z Meta; krok Call my webhook wysyła daty w formacie ISO. Media przychodzą w przekazaniach jako typ i identyfikator, a w kroku Call my webhook jako symbole zastępcze, na przykład [image], z podpisem; zapisz więc krótką etykietę, zamiast próbować przechowywać plik.
| 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 |
Jak zapobiec duplikatom przy ponowieniach?
Odpowiadaj szybko, a potem kluczuj wszystko. Przekazanie, które nie dostanie odpowiedzi 2xx w ciągu 10 sekund, jest ponawiane z tym samym identyfikatorem X-EC-Delivery, do 7 prób; wywołanie CRM trwające 12 sekund wykona się więc dwukrotnie, chyba że aktywność zostanie upsertowana po wamid. Najpierw odpowiedz 200, a pracę w CRM wykonaj w kolejce lub zadaniu w tle.
Krok Call my webhook nie jest ponawiany, a powtórne dostawy wysyłane przez Meta są odfiltrowywane, zanim automatyzacja się uruchomi, więc wywołuje Cię co najwyżej raz na wiadomość. Wpisy historii nie zawierają identyfikatora wiadomości: odpowiedzi automatyczne kluczuj po run_id oraz pozycji. Testy z Try it przychodzą z dry_run true i przykładowym kontaktem 15550000000; pomijaj je, aby testy nigdy nie tworzyły rekordów w CRM.
Jak wygląda odbiornik w Node.js?
Jedna trasa Express obsługuje oba rodzaje zdarzeń. Odczytuje surowe ciało żądania, wybiera sekret na podstawie nagłówka X-EC-Event, weryfikuje X-EC-Signature, od razu odpowiada 200 i przekazuje pracę do funkcji w tle. Obiekt crm oznacza klienta API Twojego CRM: upsert kontaktu po numerze z samymi cyframi oraz upsert aktywności po jej unikalnym kluczu. Ten sam kształt działa w przepływie n8n, z węzłem Code do podpisu, a po nim węzły Twojego 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);Czy CRM może zaktualizować leada na podstawie tego, czego nauczyła się AI?
Tak, w Twoim przepływie. Czat, który przychodzi z krokiem Call my webhook, zawiera pytania zadane przez AI i odpowiedzi klienta, więc węzeł modelu w n8n lub wywołanie w Twoim backendzie może wydobyć potrzebę, budżet, termin lub lokalizację i zapisać je w polach leada, a następnie przesunąć jego etap. Nie zwracaj odpowiedzi, bo klient już ma wiadomość AI. Gdy przepływ uzna, że lead warto zadzwonić, może utworzyć zadanie dla handlowca lub powiadomić zespół. Albo pozwól, by wydobyciem zajęło się easyCoexistence: agent lub krok saves details zapisuje potrzebę, budżet i termin w polach kontaktu, a krok Call an API może wysłać je do Twojego CRM z tokenami w stylu {{contact.budget}} w treści. Strona o kwalifikacji leadów zawiera instrukcje rozmowy oraz payload dla tej konfiguracji.
Jak to skonfigurować
- 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.
Typowe błędy
- Wyszukiwanie w CRM po polu telefonu z dowolnym tekstem. Format WhatsApp z samymi cyframi rzadko pasuje do tego, co wpisała osoba, a każde chybienie tworzy duplikat kontaktu; szukaj po znormalizowanej właściwości z samymi cyframi.
- Wywoływanie CRM przed odpowiedzią na przekazanie. CRM, który odpowiada dłużej niż 10 sekund, powoduje ponowienia w easyCoexistence, a bez upsertu po wamid aktywność zostanie zapisana dwukrotnie.
- Zapisywanie tylko przekazań i liczenie na to, że znajdą się w nich automatyczne odpowiedzi. Wysyłki przez API wracają jako statusy bez tekstu; krok Call my webhook po odpowiedzi zawiera słowa.
- Dopuszczanie testów do CRM. Try it naprawdę wywołuje Twój URL z dry_run true i przykładowym kontaktem 15550000000; odrzuć te zdarzenia przed każdym upsertem.
Jego Forward URL przekazuje wiadomości klientów i odpowiedzi telefonu do CRM jako oryginalne zdarzenia Meta, podpisane osobno dla każdego numeru i ponawiane przez około 33 godziny, gdy CRM nie działa, a krok Call my webhook dodaje odpowiedzi automatyczne. Przekazywanie i automatyzacje są wliczone w plan. US$ 9 do US$ 0,75 za numer miesięcznie, spadając w miarę dodawania numerów, pierwsze 3 dni za darmo.
Najczęściej zadawane pytania
Z którymi CRM to działa?
Z każdym CRM, który ma API, bezpośrednio przez Twój backend albo przez narzędzie do automatyzacji, takie jak n8n, Make czy Zapier, które mają do tego węzły. HubSpot ma obiekt Communications z typem kanału WhatsApp, stworzony do zapisywania tych wiadomości; na stronie HubSpot znajdziesz to wywołanie.
Czy mój zespół może odpowiadać klientom z CRM?
Tylko jeśli CRM wysyła przez Cloud API Meta, używając endpointu wysyłki numeru i tokenu z get_api_credentials: dowolny tekst w ciągu 24 godzin od ostatniej wiadomości klienta, a później zatwierdzony szablon. Te wiadomości pojawiają się też w wątku czatu w aplikacji na telefonie.
Czy dawne rozmowy można wczytać do CRM?
Tylko przez import historii Meta, który wysyła do 6 miesięcy rozmów jeden na jeden do bezpośredniego celu webhooka zapisanego w ciągu 24 godzin od połączenia, raz na połączenie. Numer ustawiony na Through easyCoexistence zapisuje dane od chwili rozpoczęcia przekazywania.
Co easyCoexistence przechowuje po drodze?
Przekazywane zmiany trafiają do kolejki ponowień i są usuwane po 7 dniach. Na numerze, który przechodzi przez easyCoexistence, treść wiadomości zostaje też dla Conversations i kontekstu AI przez wybrany przez Ciebie czas, 30, 90 lub 365 dni, a dzienniki przebiegów przez 30 dni. Trwały zapis prowadzi CRM.
Czytaj dalej
Gotowy, aby zacząć?
Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.
Rozpocznij bezpłatny okres próbnyZweryfikowano w