WhatsApp సంభాషణలను మీ CRMకు ఆటోమేటిక్గా పంపండి
CRMకు WhatsApp సంభాషణలను ఆటోమేటిక్గా పంపడానికి, వచ్చే మెసేజ్లను సంతకం చేసిన వెబ్హుక్ల ద్వారా మీ బ్యాకెండ్ లేదా వర్క్ఫ్లో టూల్కు పంపండి, ఫోన్ నంబర్ ఆధారంగా కాంటాక్ట్ను కనుగొని లేదా సృష్టించండి, ఆ మెసేజ్ను ఆ కాంటాక్ట్పై యాక్టివిటీగా లాగ్ చేయండి. WhatsApp మెసేజ్ ID ను యాక్టివిటీ యొక్క యూనిక్ కీగా ఉపయోగించండి, తద్వారా మళ్లీ ప్రయత్నించిన డెలివరీ ఒక కొత్త రికార్డ్ సృష్టించకుండా అదే రికార్డ్ను అప్డేట్ చేస్తుంది.
easyCoexistence యాప్లో మీరు ఉంచే WhatsApp Business నంబర్ను Coexistence ద్వారా Meta యొక్క Cloud API కు కనెక్ట్ చేస్తుంది.
ఫార్వర్డ్ చేసిన POST పై హెడర్, డెలివరీ ID తో కూడినది, ఆ డెలివరీ ప్రతి రీట్రైలోనూ ఒకేలా ఉంటుంది.
7 ఫార్వర్డ్ ప్రయత్నాల వ్యవధి; సుమారు 1, 5, 30, 120, 360 మరియు 1,440 నిమిషాల తర్వాత.
Call my webhook స్టెప్ URLను ఒకసారి పిలుస్తుంది; టైమ్అవుట్ లేదా లోపం రన్ను విఫలం చేసి మీకు ఇమెయిల్ పంపుతుంది.
వ్యాపారానికి పరిమితమైన యూజర్ ID, ఉదాహరణకు US.13491208655302741918, ఫోన్ నంబర్ పక్కన లేదా దానికి బదులుగా user_id మరియు from_user_id లో పంపబడుతుంది.
ఆటోమేషన్ రన్ లాగ్ ట్రిగ్గర్ మెసేజ్, రిప్లై మరియు ప్రతి స్టెప్ను ఎంతకాలం ఉంచుతుంది.
ఏ ఈవెంట్లు CRMకు చేరాలి?
ఒక Coexistence నంబర్పై సంభాషణ మూడు రకాల మెసేజ్లతో ఏర్పడుతుంది, వాటిని రెండు మార్గాలు తీసుకువెళ్తాయి. ప్రతి నంబర్కు సెట్ చేసే Forward URL, కస్టమర్లు రాసేవి మరియు మీ టీమ్ WhatsApp Business యాప్లో టైప్ చేసేవి Meta యొక్క ఒరిజినల్ ఈవెంట్లుగా పంపుతుంది, CRM ప్రతిస్పందించే వరకు రీట్రై చేస్తుంది. ఆటోమేషన్ల ద్వారా పంపిన రిప్లైలు API ద్వారా Meta కు చేరతాయి, అవి టెక్స్ట్ లేకుండా కేవలం డెలివరీ స్టేటస్లుగా మాత్రమే నివేదిస్తాయి; వాటి మాటలను లాగ్ చేయడానికి, ఆటోమేషన్ను Call my webhook స్టెప్తో ముగించండి, దాని హిస్టరీలో రన్ ఇప్పుడే పంపిన రిప్లై ఉంటుంది. ఒకే ఎండ్పాయింట్ రెండింటినీ తీసుకోగలదు: స్టెప్ కోసం X-EC-Event హెడర్ automation.step ను, ఫార్వర్డ్ల కోసం Meta ఫీల్డ్ పేరును చదువుతుంది.
WhatsApp పంపినవారిని CRM కాంటాక్ట్తో ఎలా సరిపోల్చాలి?
ఫోన్ నంబర్ ద్వారా, నార్మలైజ్ చేసి. WhatsApp దేశ కోడ్తో, ప్లస్ గుర్తు లేకుండా అంకెలను పంపుతుంది, ఉదాహరణకు 5511987654321, ఫార్వర్డ్లలో messages[].from లో, మరియు వెబ్హుక్ స్టెప్లో contact.wa_id లో. వ్యక్తులు టైప్ చేసిన CRM రికార్డ్లలో +55 11 98765-4321 లేదా (11) 98765-4321 ఉంటాయి, కాబట్టి కేవలం అంకెల రూపంలో ఉండే ప్రత్యేక ప్రాపర్టీని ఉంచి దాని ద్వారా వెతకండి. ఏదీ సరిపోలకపోతే, WhatsApp ప్రొఫైల్ పేరు మరియు నంబర్తో కొత్త కాంటాక్ట్ను సృష్టించండి.
వ్యాపారానికి పరిమితమైన యూజర్ ID ను కూడా నిల్వ చేయండి. WhatsApp యూజర్నేమ్ ఉన్న, 30 రోజులుగా మీ నంబర్తో సంప్రదించని యూజర్, from_user_id మరియు contacts[].user_id లో కేవలం BSUID తో రావచ్చు. ఫార్వర్డ్లు దాన్ని తీసుకువెళ్తాయి; వెబ్హుక్ స్టెప్ ఫోన్ నంబర్ను తీసుకువెళ్తుంది.
ప్రతి CRM రికార్డ్లో ఏం ఉండాలి?
ఐడెంటిఫైయర్లతో కూడిన కాంటాక్ట్, మరియు ప్రతి మెసేజ్కు ఒక యాక్టివిటీ, దానిలో దిశ, టెక్స్ట్, సమయం మరియు యూనిక్ కీ ఉంటాయి. దిగువ మ్యాప్ రెండు మార్గాల్లో ప్రతి విలువ ఎక్కడ ఉంటుందో చూపుతుంది. ఫార్వర్డ్లలో మెసేజ్ సమయాలు Meta నుండి Unix సెకన్లలో ఉంటాయి; వెబ్హుక్ స్టెప్ ISO తేదీలను పంపుతుంది. మీడియా ఫార్వర్డ్లలో రకం మరియు ID గా వస్తుంది, వెబ్హుక్ స్టెప్లో [image] వంటి ప్లేస్హోల్డర్లుగా క్యాప్షన్తో వస్తుంది, కాబట్టి ఫైల్ను నిల్వ చేయడానికి బదులు చిన్న లేబుల్ను లాగ్ చేయండి.
| 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 |
రీట్రైలు డూప్లికేట్లను ఎలా ఆపాలి?
త్వరగా సమాధానం ఇవ్వండి, తర్వాత అన్నింటినీ కీ చేయండి. 10 సెకన్లలో 2xx ప్రతిస్పందన రాని ఫార్వర్డ్ అదే X-EC-Delivery ID తో రీట్రై చేయబడుతుంది, 7 ప్రయత్నాల వరకు; కాబట్టి 12 సెకన్లు తీసుకునే CRM కాల్ రెండుసార్లు నడుస్తుంది, యాక్టివిటీ wamid పై అప్సర్ట్ చేయబడితే తప్ప. ఫార్వర్డ్కు ముందు 200 ఇవ్వండి, CRM పని క్యూ లేదా బ్యాక్గ్రౌండ్ జాబ్లో చేయండి.
వెబ్హుక్ స్టెప్ రీట్రై కాదు, మరియు Meta యొక్క స్వంత పునరావృత డెలివరీలు ఆటోమేషన్ నడవక ముందే ఫిల్టర్ చేయబడతాయి, కాబట్టి అది ప్రతి మెసేజ్కు గరిష్టంగా ఒకసారి మిమ్మల్ని పిలుస్తుంది. దాని హిస్టరీ ఎంట్రీలలో మెసేజ్ ID ఉండదు: ఆటోమేటెడ్ రిప్లైలను run_id మరియు వాటి స్థానం ద్వారా కీ చేయండి. Try it నుండి వచ్చే టెస్ట్లు dry_run true మరియు నమూనా కాంటాక్ట్ 15550000000 తో వస్తాయి; వాటిని వదిలేయండి, తద్వారా టెస్ట్ రన్లు ఎప్పుడూ CRM రికార్డ్లు సృష్టించవు.
Node.js లో రిసీవర్ ఎలా కనిపిస్తుంది?
ఒకే Express రూట్ రెండు రకాల ఈవెంట్లను తీసుకుంటుంది. ఇది రా బాడీని చదువుతుంది, X-EC-Event హెడర్ ద్వారా సీక్రెట్ను ఎంచుకుంటుంది, X-EC-Signature ను వెరిఫై చేస్తుంది, వెంటనే 200 ఇస్తుంది, మరియు పనిని బ్యాక్గ్రౌండ్ ఫంక్షన్కు అప్పగిస్తుంది. crm ఆబ్జెక్ట్ మీ CRM యొక్క API క్లయింట్ను సూచిస్తుంది: కేవలం అంకెలతో కూడిన ఫోన్పై కాంటాక్ట్ యొక్క అప్సర్ట్, మరియు దాని యూనిక్ కీపై యాక్టివిటీ యొక్క అప్సర్ట్. అదే ఆకృతి n8n వర్క్ఫ్లోకు కూడా పనిచేస్తుంది, సిగ్నేచర్ కోసం Code నోడ్తో, దాని తర్వాత మీ 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);AI నేర్చుకున్న దాని నుండి CRM లీడ్ను అప్డేట్ చేయగలదా?
అవును, మీ వర్క్ఫ్లోలో. Call my webhook స్టెప్తో వచ్చే చాట్లో మీ AI అడిగిన ప్రశ్నలు మరియు కస్టమర్ సమాధానాలు ఉంటాయి, కాబట్టి n8n లోని మోడల్ నోడ్ లేదా మీ బ్యాకెండ్లోని కాల్ అవసరం, బడ్జెట్, సమయం లేదా లొకేషన్ను సంగ్రహించి, వాటిని లీడ్ ఫీల్డ్లలో రాసి, దాని స్టేజ్ను మార్చగలదు. రిప్లై ఇవ్వకండి, ఎందుకంటే కస్టమర్కు ఇప్పటికే AI మెసేజ్ ఉంది. వర్క్ఫ్లో ఒక లీడ్ కాల్కు విలువైనదని నిర్ణయిస్తే, అది సేల్స్పర్సన్ కోసం టాస్క్ సృష్టించగలదు లేదా టీమ్ను హెచ్చరించగలదు. లేదా easyCoexistence నే సంగ్రహించనివ్వండి: ఏజెంట్ లేదా AI saves details దశ అవసరం, బడ్జెట్ మరియు సమయాన్ని కాంటాక్ట్ ఫీల్డ్లలో రాస్తుంది, మరియు Call an API దశ వాటిని {{contact.budget}} వంటి టోకెన్లతో దాని బాడీలో మీ CRM కు పంపగలదు. లీడ్ క్వాలిఫికేషన్ పేజీలో ఆ సెటప్ కోసం ఇంటర్వ్యూ సూచనలు మరియు పేలోడ్ ఉన్నాయి.
దీన్ని ఎలా సెటప్ చేయాలి
- 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.
సాధారణ పొరపాట్లు
- స్వేచ్ఛా రూప టెక్స్ట్ ఫోన్ ఫీల్డ్పై CRM ను వెతకడం. WhatsApp యొక్క కేవలం అంకెల ఆకృతి వ్యక్తులు టైప్ చేసిన దానితో అరుదుగా సరిపోతుంది, ప్రతి మిస్ డూప్లికేట్ కాంటాక్ట్ సృష్టిస్తుంది; నార్మలైజ్ చేసిన, కేవలం అంకెల ప్రాపర్టీపై వెతకండి.
- ఫార్వర్డ్కు సమాధానం ఇవ్వకముందే CRMకు కాల్ చేయడం. 10 సెకన్ల కంటే ఎక్కువ తీసుకునే CRM కారణంగా easyCoexistence రీట్రై చేస్తుంది, మరియు wamid పై అప్సర్ట్ లేకపోతే యాక్టివిటీ రెండుసార్లు లాగ్ అవుతుంది.
- ఫార్వర్డ్ను మాత్రమే లాగ్ చేసి, అందులో ఆటోమేటెడ్ రిప్లైలు ఉంటాయని ఆశించడం. API ద్వారా పంపినవి టెక్స్ట్ లేకుండా స్టేటస్లుగా మాత్రమే వస్తాయి; రిప్లై తర్వాత Call my webhook స్టెప్ మాటలను తీసుకువెళ్తుంది.
- టెస్ట్లు CRMకు చేరనివ్వడం. Try it నిజంగానే dry_run true మరియు నమూనా కాంటాక్ట్ 15550000000 తో URLను పిలుస్తుంది; ఏదైనా అప్సర్ట్ ముందు ఆ ఈవెంట్లను తీసివేయండి.
దాని Forward URL కస్టమర్ మెసేజ్లను మరియు ఫోన్ రిప్లైలను Meta యొక్క ఒరిజినల్ ఈవెంట్లుగా మీ CRM కు పంపుతుంది, ప్రతి నంబర్కు సంతకం చేసి, CRM డౌన్ ఉన్నప్పుడు సుమారు 33 గంటల పాటు రీట్రై చేస్తుంది, మరియు Call my webhook స్టెప్ ఆటోమేటెడ్ రిప్లైలను జోడిస్తుంది. ఫార్వర్డింగ్ మరియు ఆటోమేషన్లు ప్లాన్లో చేర్చబడ్డాయి. ప్రతి నంబర్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీరు నంబర్లు జోడించినప్పుడు తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
ఏ CRMలతో ఇది పనిచేస్తుంది?
API ఉన్న ఏ CRM అయినా, మీ స్వంత బ్యాకెండ్ ద్వారా లేదా n8n, Make లేదా Zapier వంటి వర్క్ఫ్లో టూల్ ద్వారా, దాని కోసం నోడ్లు ఉంటే. HubSpot కు ఈ మెసేజ్లను లాగ్ చేయడానికి రూపొందించిన WhatsApp ఛానెల్ రకంతో Communications ఆబ్జెక్ట్ ఉంది; కాల్ ఎలా ఉంటుందో HubSpot పేజీ చూపుతుంది.
మీ టీమ్ CRM నుండి కస్టమర్లకు రిప్లై ఇవ్వగలదా?
CRM, get_api_credentials నుండి వచ్చిన నంబర్ యొక్క send endpoint మరియు టోకెన్తో Meta యొక్క Cloud API ద్వారా పంపితేనే: కస్టమర్ చివరి మెసేజ్ తర్వాత 24 గంటల లోపు స్వేచ్ఛా రూప టెక్స్ట్, ఆ తర్వాత ఆమోదించబడిన టెంప్లేట్. ఆ మెసేజ్లు ఫోన్లోని యాప్ చాట్ థ్రెడ్లో కూడా కనిపిస్తాయి.
గత సంభాషణలను CRMలోకి లోడ్ చేయవచ్చా?
Meta యొక్క హిస్టరీ ఇంపోర్ట్ ద్వారా మాత్రమే, ఇది కనెక్ట్ చేసిన 24 గంటల లోపు సేవ్ చేయబడిన డైరెక్ట్ వెబ్హుక్ డెస్టినేషన్కు, ఒక్కో కనెక్షన్కు ఒకసారి, 6 నెలల వరకు ఒకరితో ఒకరు చాట్లను పంపుతుంది. Through easyCoexistence కు సెట్ చేసిన నంబర్ ఫార్వర్డింగ్ మొదలైన క్షణం నుండి లాగ్ చేస్తుంది.
easyCoexistence ఈ దారిలో ఏమి నిల్వ చేస్తుంది?
ఫార్వర్డ్ చేసిన మార్పులు రీట్రైల కోసం క్యూలో ఉంచబడి 7 రోజుల తర్వాత తొలగించబడతాయి. easyCoexistence ద్వారా వెళ్లే నంబర్పై, మెసేజ్ టెక్స్ట్ Conversations మరియు AI కాంటెక్స్ట్ కోసం మీరు ఎంచుకున్న 30, 90 లేదా 365 రోజుల పాటు కూడా ఉంటుంది, మరియు రన్ లాగ్లు 30 రోజులు ఉంచబడతాయి. శాశ్వత రికార్డ్ను CRM ఉంచుతుంది.
చదవడం కొనసాగించండి
ప్రారంభించడానికి సిద్ధంగా ఉన్నారా?
నెలల్లో కాదు, నిమిషాల్లో WhatsApp Coexistence సెటప్ చేయండి. యాప్ ఫోన్లో పనిచేస్తూనే ఉంటుంది.
ఉచిత ట్రయల్ ప్రారంభించండిధృవీకరించిన తేదీ