IngiaAnza kipindi cha majaribio bila malipo
Meta Tech Provider

Tuma mazungumzo ya WhatsApp kwenye CRM yako kiotomatiki

Ili kutuma mazungumzo ya WhatsApp kwenye CRM kiotomatiki, pokea ujumbe unaoingia kama webhook zilizosainiwa kwenda kwenye seva yako au zana ya mtiririko wa kazi, tafuta au unda mwasiliani kwa nambari ya simu, kisha rekodi ujumbe kama shughuli ya mwasiliani huyo. Tumia kitambulisho cha ujumbe wa WhatsApp kama ufunguo wa kipekee wa shughuli, ili uwasilishaji unaorudiwa usasishe rekodi ileile badala ya kuunda rekodi ya pili.

easyCoexistence huunganisha nambari ya WhatsApp Business unayotumia kwenye programu kwenye Cloud API ya Meta kupitia Coexistence.

X-EC-Delivery

Kichwa cha POST iliyosambazwa kinachobeba kitambulisho cha uwasilishaji, kinachofanana katika kila jaribio upya la uwasilishaji huo.

About 33 hours

Muda wa majaribio 7 ya kusambaza, baada ya takriban dakika 1, 5, 30, 120, 360 na 1,440.

1 attempt

Hatua ya Call my webhook huita URL yako mara moja; hitilafu au muda kuisha husimamisha utekelezaji na kukutumia barua pepe.

BSUID

Kitambulisho cha mtumiaji kilichowekewa biashara, kama US.13491208655302741918, kinatumwa kwenye user_id na from_user_id pamoja na au badala ya nambari ya simu.

30 days

Muda ambao kumbukumbu ya utekelezaji wa automation huhifadhi ujumbe uliosababisha, jibu na kila hatua.

Ni matukio gani yanapaswa kufika kwenye CRM?

Aina tatu za ujumbe huunda mazungumzo kwenye nambari ya Coexistence, na njia mbili zinazibeba. Forward URL, iliyowekwa kwa kila nambari, hutuma kile wateja wanachoandika na kile timu yako inachoandika kwenye programu ya WhatsApp Business, kama matukio asili ya Meta, na kujaribu tena hadi CRM yako ijibu. Majibu yanayotumwa na automation hufika Meta kupitia API, ambayo huyaripoti kama hali za uwasilishaji pekee bila maandishi; ili kurekodi maneno yake, maliza automation kwa hatua ya Call my webhook, ambayo historia yake inajumuisha jibu ambalo utekelezaji ulilituma. Endpoint moja inaweza kupokea zote mbili: kichwa X-EC-Event kinasoma automation.step kwa hatua na jina la sehemu la Meta kwa usambazaji.

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

Unalinganishaje mtumaji wa WhatsApp na mwasiliani kwenye CRM?

Kwa nambari ya simu, iliyosawazishwa. WhatsApp hutuma tarakimu zenye msimbo wa nchi bila alama ya plus, kama 5511987654321, katika messages[].from kwenye usambazaji na katika contact.wa_id kwenye hatua ya webhook. Rekodi za CRM zinazoandikwa na watu huwa na +55 11 98765-4321 au (11) 98765-4321, hivyo hifadhi sifa maalum yenye umbo la tarakimu pekee na utafute kwa kutumia hiyo. Ikiwa hakuna kinacholingana, unda mwasiliani kwa jina la wasifu wa WhatsApp na nambari.

Hifadhi pia kitambulisho cha mtumiaji kilichowekewa biashara. Mtumiaji mwenye jina la mtumiaji la WhatsApp ambaye hajawasiliana na nambari yako kwa siku 30 anaweza kufika akiwa na BSUID pekee kwenye from_user_id na contacts[].user_id. Usambazaji hubeba hiyo; hatua ya webhook hubeba nambari ya simu.

Kila rekodi ya CRM inapaswa kuwa na nini?

Mwasiliani mwenye vitambulisho, na shughuli moja kwa kila ujumbe yenye mwelekeo, maandishi, muda na ufunguo wa kipekee. Ramani hapa chini inaonyesha mahali kila thamani ilipo kwenye njia zote mbili. Muda wa ujumbe kwenye usambazaji ni sekunde za Unix kutoka Meta; hatua ya webhook hutuma tarehe za ISO. Midia hufika kama aina na kitambulisho kwenye usambazaji, na kama vishikilia nafasi kama [image] pamoja na maelezo mafupi kwenye hatua ya webhook, kwa hivyo rekodi lebo fupi badala ya kujaribu kuhifadhi faili.

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

Unazuiaje majaribio upya yasiunde marudio?

Jibu haraka, kisha ufunguo kila kitu. Usambazaji usiopata 2xx ndani ya sekunde 10 hujaribiwa tena kwa kitambulisho sawa cha X-EC-Delivery, hadi majaribio 7; kwa hiyo wito wa CRM unaochukua sekunde 12 hutekelezwa mara mbili isipokuwa shughuli isasishwe kwa upsert kwenye wamid. Jibu kwa 200 kwanza na fanya kazi ya CRM kwenye foleni au kazi ya chinichini.

Hatua ya webhook haijaribiwi tena, na uwasilishaji unaorudiwa wa Meta huchujwa kabla automation haijaendeshwa, kwa hiyo hukuita mara moja tu kwa kila ujumbe. Maingizo ya historia yake hayana kitambulisho cha ujumbe: funguo majibu ya kiotomatiki kwa run_id pamoja na nafasi yake. Majaribio ya Try it hufika yakiwa na dry_run true na mwasiliani wa mfano 15550000000; yaruke ili majaribio hayo yasiwahi kuunda rekodi za CRM.

Mfumo wa mpokeaji unaonekanaje kwenye Node.js?

Njia moja ya Express hupokea aina zote mbili za matukio. Inasoma mwili ghafi, huchagua siri kwa kichwa cha X-EC-Event, huthibitisha X-EC-Signature, hujibu 200 mara moja na kukabidhi kazi kwa kazi ya chinichini. Kitu cha crm kinawakilisha mteja wa API wa CRM yako: upsert ya mwasiliani kwa nambari ya simu yenye tarakimu pekee, na upsert ya shughuli kwa ufunguo wake wa kipekee. Umbo lile lile linafanya kazi kwa mtiririko wa kazi wa n8n, kwa nodi ya Code ya sahihi na nodi za CRM yako baada yake.

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

Je, CRM inaweza kusasisha mteja mtarajiwa kutokana na kile AI ilichojifunza?

Ndiyo, ndani ya mtiririko wa kazi wako. Mazungumzo yanayofika kwa hatua ya Call my webhook yana maswali ambayo AI yako iliuliza na majibu ya mteja, hivyo nodi ya modeli kwenye n8n au wito kwenye seva yako unaweza kutoa hitaji, bajeti, muda au eneo na kuviandika kwenye sehemu za mteja mtarajiwa, kisha kusogeza hatua yake ya mauzo. Usirudishe jibu lolote, kwa kuwa mteja tayari ana ujumbe wa AI. Mtiririko wa kazi ukiamua kwamba mteja mtarajiwa anastahili simu, unaweza kuunda kazi kwa muuzaji au kuarifu timu. Au acha easyCoexistence itoe taarifa hizo: wakala au hatua ya AI saves details huandika hitaji, bajeti na muda kwenye sehemu za mwasiliani, na hatua ya Call an API inaweza kuzituma kwenye CRM yako kwa token za mtindo wa {{contact.budget}} kwenye mwili wake. Ukurasa wa kuhitimu wateja watarajiwa una maelekezo ya mahojiano na payload ya usanidi huo.

Jinsi ya kuisanidi

  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.

Makosa ya kawaida

  • Kutafuta CRM kwa sehemu ya simu ya maandishi huru. Muundo wa tarakimu pekee wa WhatsApp mara chache hulingana na alichoandika mtu, na kila kukosa kunaunda nakala ya mwasiliani; tafuta sifa iliyosawazishwa ya tarakimu pekee.
  • Kuita CRM kabla ya kujibu usambazaji. CRM inayochukua zaidi ya sekunde 10 humfanya easyCoexistence ajaribu tena, na bila upsert kwenye wamid shughuli inarekodiwa mara mbili.
  • Kurekodi usambazaji pekee na kutarajia majibu ya kiotomatiki ndani yake. Majibu yaliyotumwa kupitia API hurudi kama hali bila maneno; hatua ya Call my webhook baada ya jibu ndiyo hubeba maneno.
  • Kuruhusu majaribio kufikia CRM. Try it huita URL yako kweli kwa dry_run true na mwasiliani wa mfano 15550000000; ondoa matukio hayo kabla ya upsert yoyote.
Kufanya hili ukitumia EasyCoexistence

Forward URL yake hupeleka ujumbe wa wateja na majibu ya simu kwenye CRM yako kama matukio asili ya Meta, yakisainiwa kwa kila nambari na kujaribiwa tena kwa takriban saa 33 CRM ikiwa chini, na hatua ya Call my webhook huongeza majibu ya kiotomatiki. Usambazaji na automation vimo kwenye mpango. Kuanzia US$ 9 kwa kila nambari iliyounganishwa kwa mwezi, hadi US$ 0.75 kadri unavyoongeza nambari, kwa kipindi cha majaribio bila malipo cha siku 3 za kwanza.

Maswali yanayoulizwa mara kwa mara

CRM zipi zinafanya kazi na hii?

CRM yoyote yenye API, ama kupitia backend yako mwenyewe au kupitia zana ya mtiririko wa kazi kama n8n, Make au Zapier ambayo ina nodi zake. HubSpot ina kitu cha Communications chenye aina ya kituo cha WhatsApp kilichoundwa kwa ajili ya kurekodi ujumbe huu; ukurasa wa HubSpot unaonyesha wito huo.

Je, timu yangu inaweza kuwajibu wateja kutoka CRM?

Tu ikiwa CRM inatuma kupitia Cloud API ya Meta, ukitumia endpoint ya kutuma ya nambari na token kutoka get_api_credentials: maandishi huru ndani ya dirisha la huduma kwa wateja la saa 24 tangu ujumbe wa mwisho wa mteja, na kiolezo cha ujumbe kilichoidhinishwa baada ya hapo. Ujumbe huo pia huonekana kwenye mazungumzo ya programu kwenye simu.

Mazungumzo ya zamani yanaweza kupakiwa kwenye CRM?

Tu kupitia uingizaji wa historia wa Meta, ambao hutuma hadi miezi 6 ya mazungumzo ya mtu mmoja kwa mtu mmoja kwenda kwenye lengo la moja kwa moja la webhook lililohifadhiwa ndani ya saa 24 tangu kuunganisha, mara moja kwa kila muunganisho. Nambari iliyowekwa kuwa Kupitia easyCoexistence huanza kurekodi kuanzia wakati usambazaji unapoanza.

easyCoexistence huhifadhi nini njiani?

Mabadiliko yanayosambazwa huwekwa kwenye foleni kwa kujaribu tena na huondolewa baada ya siku 7. Kwenye nambari inayopitia easyCoexistence, maandishi ya ujumbe pia hubaki kwa Conversations na muktadha wa AI kwa muda unaochagua, siku 30, 90 au 365, na kumbukumbu za utekelezaji huhifadhiwa siku 30. CRM ndiyo inayoshikilia rekodi ya kudumu.

Endelea kusoma

Uko tayari kuanza?

Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.

Anza kipindi cha majaribio bila malipo

Imethibitishwa kwenye