WhatsApp बातचीत अपने आप CRM में भेजें
WhatsApp बातचीत को अपने आप CRM में भेजने के लिए, आने वाले मैसेज को हस्ताक्षरित वेबहुक के ज़रिए आपके बैकएंड या किसी वर्कफ़्लो टूल तक पहुँचाएँ, फ़ोन नंबर से संपर्क खोजें या बनाएँ, और मैसेज को उस संपर्क पर एक एक्टिविटी के रूप में लॉग करें। एक्टिविटी की यूनीक की के रूप में WhatsApp मैसेज आईडी इस्तेमाल करें, ताकि दोबारा भेजी गई डिलीवरी एक दूसरा रिकॉर्ड बनाने के बजाय उसी रिकॉर्ड को अपडेट करे।
easyCoexistence, ऐप में रखे WhatsApp Business नंबर को Coexistence के ज़रिए Meta के Cloud API से जोड़ता है।
फ़ॉरवर्ड किए गए POST अनुरोध के हेडर में डिलीवरी आईडी रहती है, जो उस डिलीवरी के हर रीट्राई पर एक जैसी होती है।
7 फ़ॉरवर्ड प्रयासों की अवधि, लगभग 1, 5, 30, 120, 360 और 1,440 मिनट के बाद।
'“Call my webhook”' स्टेप आपके यूआरएल को एक बार कॉल करता है; टाइमआउट या गड़बड़ी से रन विफल होता है और आपको ईमेल जाता है।
कारोबार-स्कोप्ड यूज़र आईडी, जैसे US.13491208655302741918, user_id और from_user_id में फ़ोन नंबर के साथ या उसकी जगह भेजी जाती है।
ऑटोमेशन रन लॉग कितने समय तक ट्रिगर करने वाला मैसेज, जवाब और हर स्टेप रखता है।
कौन-से इवेंट CRM तक पहुँचने चाहिए?
Coexistence नंबर पर बातचीत तीन तरह के मैसेज से बनती है, और उन्हें दो रास्ते ले जाते हैं। हर नंबर के लिए सेट किया गया Forward URL ग्राहकों के लिखे मैसेज और WhatsApp Business ऐप में आपकी टीम के टाइप किए मैसेज भेजता है, जो Meta के मूल इवेंट के रूप में आते हैं और तब तक दोबारा भेजे जाते हैं जब तक आपका CRM जवाब न दे। ऑटोमेशन द्वारा भेजे गए जवाब एपीआई के ज़रिए 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 प्रोफ़ाइल नाम और नंबर के साथ संपर्क बनाएँ।
कारोबार-स्कोप्ड यूज़र आईडी भी सहेजें। जिस यूज़र का WhatsApp यूज़रनेम है और जो 30 दिनों से आपके नंबर से संपर्क में नहीं आया, उसके मैसेज में from_user_id और contacts[].user_id में केवल BSUID आ सकती है। फ़ॉरवर्ड उसे साथ भेजते हैं; वेबहुक स्टेप फ़ोन नंबर भेजता है।
हर CRM रिकॉर्ड में क्या होना चाहिए?
पहचानकर्ताओं वाला एक संपर्क, और हर मैसेज के लिए एक एक्टिविटी, जिसमें दिशा, टेक्स्ट, समय और एक यूनीक की हो। नीचे दिया नक्शा दिखाता है कि दोनों रास्तों पर हर मान कहाँ आता है। फ़ॉरवर्ड पर मैसेज का समय Meta से Unix सेकंड में आता है; वेबहुक स्टेप ISO तारीखें भेजता है। मीडिया फ़ॉरवर्ड पर टाइप और आईडी के रूप में आता है, और वेबहुक स्टेप पर [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 आईडी के साथ 7 प्रयासों तक दोबारा भेजा जाता है; इसलिए 12 सेकंड लेने वाली CRM कॉल तब तक दो बार चलती है जब तक एक्टिविटी wamid पर अपसर्ट न हो। पहले 200 जवाब दें और CRM का काम किसी क्यू या बैकग्राउंड जॉब में करें।
वेबहुक स्टेप रीट्राई नहीं होता, और Meta की अपनी दोहराई गई डिलीवरी ऑटोमेशन चलने से पहले छाँट दी जाती हैं, इसलिए वह हर मैसेज पर अधिकतम एक बार कॉल करता है। उसके इतिहास की प्रविष्टियों में कोई मैसेज आईडी नहीं होती: स्वचालित जवाबों की कुंजी run_id और उनकी स्थिति (position) के आधार पर बनाएँ। Try it से आए टेस्ट dry_run true और सैंपल संपर्क 15550000000 के साथ आते हैं; उन्हें छोड़ दें ताकि टेस्ट रन कभी CRM रिकॉर्ड न बनाएँ।
Node.js में रिसीवर कैसा दिखता है?
एक Express रूट दोनों तरह के इवेंट लेता है। वह कच्चा बॉडी पढ़ता है, X-EC-Event हेडर से सीक्रेट चुनता है, X-EC-Signature की पुष्टि करता है, तुरंत 200 जवाब देता है और काम एक बैकग्राउंड फ़ंक्शन को सौंपता है। crm ऑब्जेक्ट आपके CRM के एपीआई क्लाइंट को दर्शाता है: सामान्यीकृत केवल-अंक फ़ोन पर संपर्क का अपसर्ट, और उसकी यूनीक की पर एक्टिविटी का अपसर्ट। यही आकार 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);क्या 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 को कॉल करना। जो CRM 10 सेकंड से ज़्यादा लेता है, उस पर easyCoexistence रीट्राई करता है, और wamid पर अपसर्ट के बिना एक्टिविटी दो बार लॉग होती है।
- केवल फ़ॉरवर्ड लॉग करना और उसमें ऑटोमेटेड जवाब की उम्मीद करना। एपीआई से भेजे गए मैसेज बिना टेक्स्ट के स्टेटस के रूप में लौटते हैं; जवाब के बाद का '“Call my webhook”' स्टेप ही शब्द लेकर आता है।
- टेस्ट को CRM तक पहुँचने देना। Try it वास्तव में dry_run true और सैंपल संपर्क 15550000000 के साथ आपके यूआरएल को कॉल करता है; किसी भी अपसर्ट से पहले उन इवेंट को हटा दें।
उसका Forward URL ग्राहक के मैसेज और फ़ोन से दिए जवाब Meta के मूल इवेंट के रूप में आपके CRM तक पहुँचाता है, हर नंबर के लिए हस्ताक्षरित और CRM बंद होने पर लगभग 33 घंटे तक दोबारा भेजे जाते हुए, और '“Call my webhook”' स्टेप स्वचालित जवाब जोड़ता है। फ़ॉरवर्डिंग और ऑटोमेशन प्लान में शामिल हैं। US$ 9 से US$ 0.75 तक प्रति नंबर प्रति माह, जैसे-जैसे आप नंबर जोड़ते हैं कीमत घटती है, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
किन CRM के साथ यह काम करता है?
कोई भी CRM जिसका एपीआई हो, चाहे आपके अपने बैकएंड के ज़रिए या n8n, Make या Zapier जैसे वर्कफ़्लो टूल के ज़रिए जिनके इसके लिए नोड हों। HubSpot में एक Communications ऑब्जेक्ट है जिसमें इन मैसेज को लॉग करने के लिए बना WhatsApp चैनल टाइप है; HubSpot पेज वह कॉल दिखाता है।
क्या मेरी टीम CRM से ग्राहकों को जवाब दे सकती है?
केवल तब, जब CRM नंबर के send एंडपॉइंट और get_api_credentials से मिले टोकन के साथ Meta के Cloud API से भेजे: ग्राहक के आख़िरी मैसेज के 24 घंटे के भीतर फ़्री टेक्स्ट, और उसके बाद एक मंज़ूर टेम्पलेट। ऐसे मैसेज फ़ोन पर ऐप की चैट थ्रेड में भी दिखते हैं।
क्या पुरानी बातचीत CRM में लोड की जा सकती है?
केवल Meta के इतिहास आयात के ज़रिए, जो कनेक्ट करने के 24 घंटे के भीतर सहेजे गए सीधे वेबहुक डेस्टिनेशन पर हर कनेक्शन के लिए एक बार, एक-से-एक चैट के 6 महीने तक भेजता है। Through easyCoexistence पर सेट नंबर फ़ॉरवर्डिंग शुरू होने के क्षण से लॉग करता है।
easyCoexistence इस दौरान क्या सहेजता है?
फ़ॉरवर्ड किए गए बदलाव दोबारा भेजने के लिए कतार में रखे जाते हैं और 7 दिन बाद हटा दिए जाते हैं। easyCoexistence से होकर जाने वाले नंबर पर मैसेज का टेक्स्ट Conversations और AI संदर्भ के लिए आपके चुने समय तक, 30, 90 या 365 दिन, भी रहता है, और रन लॉग 30 दिन रखे जाते हैं। स्थायी रिकॉर्ड CRM के पास रहता है।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित