WhatsApp कुराकानी स्वचालित रूपमा आफ्नो CRM मा पठाउनुहोस्
WhatsApp कुराकानी स्वचालित रूपमा CRM मा पठाउन, आउने म्यासेजहरू हस्ताक्षरित वेबहुक मार्फत आफ्नो ब्याकएन्ड वा वर्कफ्लो टुलमा पठाउनुहोस्, फोन नम्बरबाट सम्पर्क खोज्नुहोस् वा नयाँ बनाउनुहोस्, र म्यासेजलाई त्यस सम्पर्कको गतिविधिका रूपमा लग गर्नुहोस्। WhatsApp म्यासेज ID लाई गतिविधिको अद्वितीय कुञ्जी बनाउनुहोस्, ताकि पुनः प्रयास गरिएको डेलिभरीले दोस्रो रेकर्ड नबनाई उही रेकर्ड अद्यावधिक गरोस्।
easyCoexistence ले Coexistence मार्फत आफ्नो एपमा राखेको WhatsApp Business नम्बरलाई Meta को Cloud API सँग जोड्छ।
फर्वार्ड गरिएको POST मा डेलिभरी ID बोक्ने हेडर, जुन उही डेलिभरीको हरेक पुनः प्रयासमा एउटै हुन्छ।
7 फर्वार्ड प्रयासहरूको अवधि, लगभग 1, 5, 30, 120, 360 र 1,440 मिनेटपछि।
कल माई वेबहुक स्टेपले तपाईंको यूआरएलमा एक पटक मात्र कल गर्छ; टाइमआउट वा त्रुटि भएमा रन असफल हुन्छ र तपाईंलाई इमेल आउँछ।
US.13491208655302741918 जस्तो व्यवसाय-सीमित यूजर ID, जुन user_id र from_user_id मा फोन नम्बरसँगै वा सट्टा पठाइन्छ।
स्वचालित रन लगले ट्रिगर गर्ने म्यासेज, उत्तर र प्रत्येक चरण कति समयसम्म राख्छ।
कुन इभेन्टहरू CRM मा पुग्नुपर्छ?
Coexistence नम्बरमा कुराकानी बनाउने म्यासेजका तीन प्रकार हुन्छन्, र ती दुई बाटोबाट आउँछन्। हरेक नम्बरका लागि सेट गरिने फर्वार्ड यूआरएल ले ग्राहकले लेखेका म्यासेज र तपाईंको टोलीले WhatsApp Business एपमा टाइप गरेका म्यासेज Meta का मूल इभेन्टका रूपमा पठाउँछ, र तपाईंको CRM ले प्रतिक्रिया नदिउन्जेल पुनः प्रयास गरिन्छ। स्वचालनद्वारा पठाइएका उत्तरहरू एपीआई मार्फत Meta मा पुग्छन्, र तिनले पाठविना केवल डेलिभरी स्ट्याटसका रूपमा रिपोर्ट गर्छन्। ती उत्तरका शब्दहरू लग गर्न, स्वचालनलाई कल माई वेबहुक स्टेप सँग अन्त्य गर्नुहोस्; त्यसको इतिहासमा रनले ठीक अघि पठाएको उत्तर समावेश हुन्छ। एउटै एन्डपोइन्टले दुवै लिन सक्छ: चरणका लागि 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 |
CRM ले पुनः प्रयासबाट दोहोरो रेकर्ड कसरी रोक्ने?
छिटो प्रतिक्रिया दिनुहोस्, त्यसपछि सबै कुरा कुञ्जीकृत गर्नुहोस्। 10 सेकेन्डभित्र 2xx प्रतिक्रिया नपाएको फर्वार्ड उही X-EC-Delivery ID सहित 7 प्रयाससम्म पुनः प्रयास गरिन्छ; त्यसैले 12 सेकेन्ड लाग्ने CRM कल दुई पटक चल्छ, जबसम्म गतिविधि wamid मा upsert गरिँदैन। पहिले 200 फर्काउनुहोस्, र CRM को काम क्युमा वा पृष्ठभूमिको कार्यमा गर्नुहोस्।
वेबहुक चरणलाई पुनः प्रयास गरिँदैन, र Meta का आफ्नै दोहोरिएका डेलिभरीहरू स्वचालन चल्नुअघि नै छानिन्छन्, त्यसैले यसले प्रत्येक म्यासेजका लागि अधिकतम एक पटक कल गर्छ। यसका इतिहास प्रविष्टिहरूमा म्यासेज ID हुँदैन: स्वचालित उत्तरलाई run_id र त्यसको स्थानसँग जोडेर कुञ्जीकृत गर्नुहोस्। Try it बाट गरिएका परीक्षणहरू dry_run true र नमुना सम्पर्क 15550000000 सहित आउँछन्; तिनलाई छोड्नुहोस्, ताकि परीक्षण रनले CRM रेकर्ड कहिल्यै नबनाओस्।
Node.js मा रिसिभर कस्तो देखिन्छ?
एउटै Express मार्गले दुवै इभेन्ट प्रकार लिन्छ। यसले raw body पढ्छ, X-EC-Event हेडरबाट गोप्य कुञ्जी छान्छ, X-EC-Signature प्रमाणित गर्छ, तुरुन्त 200 उत्तर दिन्छ, र काम पृष्ठभूमि प्रकार्यमा हस्तान्तरण गर्छ। crm वस्तुले तपाईंको CRM को एपीआई क्लाइन्ट जनाउँछ: अंक मात्र भएको फोनमा सम्पर्कको upsert, र यसको अद्वितीय कुञ्जीमा गतिविधिको upsert। यही आकार 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 ले AI ले सिकेको कुरा हेरेर लिड अद्यावधिक गर्न सक्छ?
हो, तपाईंको वर्कफ्लोमा। कल माई वेबहुक स्टेपसँग आउने कुराकानीमा तपाईंको AI ले सोधेका प्रश्न र ग्राहकका उत्तर हुन्छन्, त्यसैले n8n को मोडेल नोड वा तपाईंको ब्याकएन्डको कलले आवश्यकता, बजेट, समय वा स्थान निकालेर लिडका फिल्डमा लेख्न सक्छ, त्यसपछि त्यसको चरण सार्न सक्छ। उत्तर नफिर्ताउनुहोस्, किनकि ग्राहकसँग AI को म्यासेज पहिले नै छ। जब वर्कफ्लोले लिडलाई कल गर्न लायक ठान्छ, त्यसले बिक्री प्रतिनिधिका लागि कार्य बनाउन वा टोलीलाई सूचित गर्न सक्छ। वा निकाल्ने काम easyCoexistence लाई नै दिनुहोस्: एजेन्ट वा AI ले विवरण सुरक्षित गर्ने स्टेपले आवश्यकता, बजेट र समय सम्पर्कका फिल्डमा लेख्छ, र कल एन एपीआई स्टेपले आफ्नो बडीमा {{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 मा upsert नभएमा गतिविधि दुई पटक लग हुन्छ।
- केवल फर्वार्ड लग गरेर त्यसमा स्वचालित उत्तर आउने अपेक्षा गर्नु। एपीआई बाट पठाइएका म्यासेज पाठविना स्ट्याटसका रूपमा फर्किन्छन्; उत्तरपछिको कल माई वेबहुक स्टेपले शब्दहरू बोक्छ।
- परीक्षणलाई CRM सम्म पुग्न दिनु। Try it ले dry_run true र नमुना सम्पर्क 15550000000 सहित तपाईंको यूआरएललाई वास्तवमै कल गर्छ; कुनै पनि upsert अघि ती इभेन्ट हटाउनुहोस्।
यसको फर्वार्ड यूआरएल ले ग्राहकका म्यासेज र फोनका उत्तर Meta का मूल इभेन्टका रूपमा तपाईंको CRM मा पठाउँछ, प्रति नम्बर हस्ताक्षरित गरिएर, र CRM बन्द हुँदा लगभग 33 घण्टासम्म पुनः प्रयास गरिन्छ; कल माई वेबहुक स्टेपले स्वचालित उत्तर थप्छ। फर्वार्डिङ र स्वचालन योजनामा समावेश छन्। प्रति नम्बर प्रति महिना US$ 9 देखि US$ 0.75 सम्म, नम्बर थप्दै जाँदा घट्दै, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
कुन CRM सँग यो काम गर्छ?
एपीआई भएको कुनै पनि CRM, तपाईंको आफ्नै ब्याकएन्ड मार्फत वा n8n, Make वा Zapier जस्ता वर्कफ्लो टुलमार्फत, जसमा त्यसका लागि नोडहरू छन्। HubSpot सँग यी म्यासेज लग गर्न बनाइएको WhatsApp च्यानल प्रकारसहितको Communications वस्तु छ; HubSpot पृष्ठले त्यो कल देखाउँछ।
के तपाईंको टोलीले CRM बाट ग्राहकलाई उत्तर दिन सक्छ?
केवल तब, जब CRM ले 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 सेट अप गर्नुहोस्। एप फोनमा चलिरहन्छ।
निःशुल्क ट्रायल सुरु गर्नुहोस्प्रमाणीकरण गरिएको