Mag-log inMagsimula ng Libreng Trial
Meta Tech Provider

Awtomatikong ipadala ang mga WhatsApp conversation sa inyong CRM

Upang awtomatikong maipadala ang mga WhatsApp conversation sa CRM, ihatid ang mga papasok na mensahe bilang naka-sign na webhook sa inyong backend o workflow tool, hanapin o gumawa ng contact gamit ang numero ng telepono, at itala ang mensahe bilang activity sa contact na iyon. Gamitin ang ID ng mensahe ng WhatsApp bilang unique key ng activity, para ang na-retry na delivery ay mag-update sa parehong record at hindi gumawa ng pangalawa.

Ikinokonekta ng easyCoexistence ang WhatsApp Business number na hawak ninyo sa app sa Cloud API ng Meta sa pamamagitan ng Coexistence.

X-EC-Delivery

Header sa forwarded POST na may delivery id, pareho sa bawat retry ng delivery na iyon.

About 33 hours

Saklaw ng 7 forward attempt, pagkatapos ng humigit-kumulang 1, 5, 30, 120, 360 at 1,440 minuto.

1 attempt

Tinatawag ng Call my webhook step ang URL ninyo nang isang beses; ang timeout o error ay nagpapabigo sa run at nagpapadala ng email sa inyo.

BSUID

User ID na naka-scope sa negosyo (BSUID), gaya ng US.13491208655302741918, ay ipinapadala sa user_id at from_user_id, kasama o kapalit ng numero ng telepono.

30 days

Gaano katagal itinatago ng automation run log ang mensaheng nagpasimula, ang reply, at ang bawat step.

Aling mga event ang dapat umabot sa CRM?

Tatlong uri ng mensahe ang bumubuo sa conversation sa isang Coexistence number, at dalawang ruta ang nagdadala nito. Ang Forward URL, na itinakda kada numero, ay nagpapadala ng isinusulat ng mga customer at ng itina-type ng inyong team sa WhatsApp Business app, bilang orihinal na event ng Meta, at nire-retry hanggang sumagot ang inyong CRM. Ang mga reply na ipinadala ng automation ay umaabot sa Meta sa pamamagitan ng API, na nag-uulat lamang sa mga delivery status na walang teksto; para ma-log ang mga salita nito, tapusin ang automation sa Call my webhook step, na ang history ay kasama ang reply na katatapos lang ipadala ng run. Kayang tanggapin ng iisang endpoint ang pareho: binabasa ng X-EC-Event header ang automation.step para sa step at ang field name ng Meta para sa forward.

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

Paano itugma ang sender ng WhatsApp sa contact sa CRM?

Sa pamamagitan ng numero ng telepono, na-normalize. Nagpapadala ang WhatsApp ng mga digit na may country code at walang plus sign, gaya ng 5511987654321, sa messages[].from sa mga forward at sa contact.wa_id sa webhook step. Ang mga CRM record na tina-type ng tao ay may +55 11 98765-4321 o (11) 98765-4321, kaya magtabi ng nakalaang property na may digits-only na anyo at maghanap gamit ito. Kapag walang tumugma, gumawa ng contact gamit ang pangalan ng WhatsApp profile at ang numero.

Itabi rin ang business-scoped user ID. Ang user na may WhatsApp username na hindi nakipag-ugnayan sa inyong numero sa loob ng 30 araw ay maaaring dumating na BSUID lamang sa from_user_id at contacts[].user_id. Dala ng forward ito; ang webhook step ay dala ang numero ng telepono.

Ano ang dapat laman ng bawat CRM record?

Isang contact na may mga identifier, at isang activity bawat mensahe na may direksyon, teksto, oras at unique key. Ipinapakita ng mapa sa ibaba kung saan nakalagay ang bawat value sa alinmang ruta. Ang oras ng mensahe sa mga forward ay Unix seconds mula sa Meta; ang webhook step ay nagpapadala ng ISO date. Ang media ay dumarating bilang type at id sa mga forward, at bilang placeholder gaya ng [image] kasama ang caption sa webhook step, kaya mag-log ng maikling label sa halip na subukang itabi ang file.

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

Paano pigilan ang retry na gumawa ng duplicate?

Sumagot agad, saka i-key ang lahat. Ang forward na hindi nakakakuha ng 2xx sa loob ng 10 segundo ay nire-retry na may parehong X-EC-Delivery id, hanggang 7 attempt; kaya ang tawag sa CRM na tumatagal ng 12 segundo ay tatakbo nang dalawang beses maliban kung ang activity ay ina-upsert sa wamid. Sumagot muna ng 200 at gawin ang trabaho sa CRM sa queue o background job.

Hindi nire-retry ang webhook step, at ang sariling paulit-ulit na delivery ng Meta ay sinasala bago tumakbo ang automation, kaya tumatawag ito nang hindi hihigit sa isang beses bawat mensahe. Ang mga entry sa history nito ay walang ID ng mensahe: i-key ang mga automated reply sa run_id kasama ang posisyon nila. Ang mga test mula sa Try it ay dumarating na may dry_run true at sample contact na 15550000000; laktawan ang mga ito para hindi kailanman gumawa ng CRM record ang mga test run.

Ano ang itsura ng receiver sa Node.js?

Isang Express route ang tumatanggap ng dalawang uri ng event. Binabasa nito ang raw body, pinipili ang secret ayon sa X-EC-Event header, bine-verify ang X-EC-Signature, sumasagot ng 200 agad, at ipinapasa ang gawain sa background function. Ang crm object ay kumakatawan sa API client ng inyong CRM: isang upsert ng contact sa digits-only na telepono, at isang upsert ng activity sa unique key nito. Gumagana rin ang parehong hugis para sa n8n workflow, na may Code node para sa signature at mga node ng inyong CRM pagkatapos nito.

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

Maaari bang i-update ng CRM ang lead mula sa natutunan ng AI?

Oo, sa inyong workflow. Ang chat na dumarating kasama ang Call my webhook step ay naglalaman ng mga tanong na itinanong ng inyong AI at ang mga sagot ng customer, kaya maaaring kumuha ng need, budget, timing o location ang model node sa n8n o isang tawag sa inyong backend at isulat ang mga ito sa mga field ng lead, saka ilipat ang stage nito. Huwag magbalik ng reply, dahil natanggap na ng customer ang mensahe ng AI. Kapag nagpasya ang workflow na karapat-dapat tawagan ang lead, maaari itong gumawa ng task para sa isang salesperson o mag-alerto sa team. O hayaan ang easyCoexistence na mag-extract: ang isang agent o ang AI saves details step ay nagsusulat ng need, budget at timing sa mga field ng contact, at maaari itong i-post ng isang Call an API step sa CRM ninyo gamit ang mga token na may estilong {{contact.budget}} sa body nito. Ang lead qualification page ay naglalaman ng mga tagubilin sa interview at ng payload para sa setup na iyon.

Paano ito i-set up

  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.

Mga karaniwang pagkakamali

  • Paghahanap sa CRM gamit ang free-form text na phone field. Bihirang tumugma ang digits-only na format ng WhatsApp sa itinype ng tao, at bawat hindi tugma ay gumagawa ng duplicate na contact; maghanap sa na-normalize na digits-only property.
  • Pagtawag sa CRM bago sagutin ang forward. Kapag mahigit 10 segundo ang CRM, mag-retry ang easyCoexistence, at kung walang upsert sa wamid, dalawang beses mai-log ang activity.
  • Pag-log lang ng forward at pag-asang nandoon ang automated reply. Ang mga send ng API ay bumabalik bilang status na walang teksto; ang Call my webhook step pagkatapos ng reply ang may dala ng mga salita.
  • Pagpapahintulot na maabot ng test ang CRM. Talagang tinatawag ng Try it ang URL ninyo na may dry_run true at sample contact na 15550000000; alisin ang mga event na iyon bago ang anumang upsert.
Ginagawa ito gamit ang EasyCoexistence

Ipinapasa ng Forward URL nito ang mga mensahe ng customer at mga phone reply sa inyong CRM bilang orihinal na event ng Meta, naka-sign kada numero at nire-retry nang humigit-kumulang 33 oras kapag down ang CRM, at idinaragdag ng Call my webhook step ang mga automated reply. Kasama sa plan ang forwarding at automation. Mula US$ 9 kada naka-connect na numero kada buwan, bumababa hanggang US$ 0.75 habang dumarami ang mga numero, at may unang 3 araw na free trial.

Mga madalas itanong

Aling mga CRM ang gumagana rito?

Anumang CRM na may API, sa pamamagitan ng sarili ninyong backend o ng workflow tool gaya ng n8n, Make o Zapier na may node para dito. Ang HubSpot ay may Communications object na may WhatsApp channel type na ginawa para sa pag-log ng mga mensaheng ito; ipinapakita ng HubSpot page ang tawag.

Maaari bang sumagot ang team namin sa customer mula sa CRM?

Puwede lamang kung ang CRM ay nagpapadala sa pamamagitan ng Cloud API ng Meta gamit ang send endpoint ng numero at ang token mula sa get_api_credentials: free-form text sa loob ng 24 oras mula sa huling mensahe ng customer, at naaprubahang template pagkatapos noon. Lumalabas din ang mga mensaheng ito sa chat thread ng app sa telepono.

Maaari bang i-load ang mga nakaraang conversation sa CRM?

Puwede lamang sa pamamagitan ng history import ng Meta, na nagpapadala ng hanggang 6 na buwan ng one-to-one chat sa direct webhook destination na na-save sa loob ng 24 oras mula sa pagkonekta, isang beses bawat koneksyon. Ang numerong nakatakda sa Through easyCoexistence ay nagla-log mula sa sandaling magsimula ang forwarding.

Ano ang iniingatan ng easyCoexistence habang nagpapatuloy?

Ang mga forwarded na pagbabago ay inilalagay sa pila para sa mga retry at inaalis pagkatapos ng 7 araw. Sa numerong dumadaan sa easyCoexistence, nananatili rin ang teksto ng mensahe para sa Conversations at AI context sa tagal na pipiliin ninyo, 30, 90 o 365 araw, at 30 araw na itinatago ang run log. Ang CRM ang may permanenteng record.

Magpatuloy sa pagbabasa

Handa na po ba kayong magsimula?

I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.

Magsimula ng Libreng Trial

Na-verify noong