WhatsApp گفتگو خودکار طور پر اپنے CRM میں بھیجیں
WhatsApp گفتگو خودکار طور پر CRM میں بھیجنے کے لیے، آنے والے میسجز کو دستخط شدہ ویب ہکس کے ذریعے آپ کے بیک اینڈ یا ورک فلو ٹول تک پہنچائیں، فون نمبر سے کانٹیکٹ تلاش کریں یا بنائیں، اور اس کانٹیکٹ پر میسج کو ایک ایکٹیویٹی کے طور پر درج کریں۔ WhatsApp میسج ID کو ایکٹیویٹی کی یونیک کی کے طور پر استعمال کریں، تاکہ دوبارہ کوشش کی گئی ڈیلیوری اسی ریکارڈ کو اپ ڈیٹ کرے، نیا ریکارڈ نہ بنائے۔
easyCoexistence، ایپ میں رکھے WhatsApp Business نمبر کو Coexistence کے ذریعے Meta کے Cloud API سے جوڑتا ہے۔
فارورڈ کیے گئے POST پر ہیڈر، جس میں ڈیلیوری ID ہوتی ہے، اس ڈیلیوری کی ہر دوبارہ کوشش پر یکساں رہتا ہے۔
7 فارورڈ کوششوں کا دورانیہ، تقریباً 1، 5، 30، 120، 360 اور 1,440 منٹ کے وقفوں پر۔
Call my webhook step ایک بار آپ کے URL کو کال کرتا ہے؛ ٹائم آؤٹ یا خرابی سے رن ناکام ہوتا ہے اور آپ کو ای میل ملتا ہے۔
کاروبار تک محدود یوزر ID، جیسے US.13491208655302741918، فون نمبر کے ساتھ یا اس کے بجائے user_id اور from_user_id میں بھیجی جاتی ہے۔
آٹومیشن رن لاگ کتنی مدت تک ٹرگر کرنے والا میسج، جواب اور ہر مرحلہ محفوظ رکھتا ہے۔
CRM تک کون سے ایونٹس پہنچنے چاہئیں؟
Coexistence نمبر پر گفتگو تین قسم کے میسجز سے بنتی ہے، اور دو راستے انہیں لے جاتے ہیں۔ ہر نمبر کے لیے الگ سیٹ ہونے والا Forward URL وہ بھیجتا ہے جو کسٹمرز لکھتے ہیں اور جو آپ کی ٹیم WhatsApp Business ایپ میں ٹائپ کرتی ہے، Meta کے اصل ایونٹس کی صورت میں، اور جب تک آپ کا CRM جواب نہ دے تب تک دوبارہ کوشش ہوتی رہتی ہے۔ آٹومیشن کے بھیجے گئے جوابات API کے ذریعے Meta تک پہنچتے ہیں، جو انہیں بغیر متن کے صرف ڈیلیوری اسٹیٹس کے طور پر ظاہر کرتا ہے۔ ان کے الفاظ درج کرنے کے لیے آٹومیشن کو Call my webhook step پر ختم کریں، جس کی ہسٹری میں رن کا بھیجا ہوا جواب شامل ہوتا ہے۔ ایک اینڈ پوائنٹ دونوں لے سکتا ہے: X-EC-Event ہیڈر مرحلے کے لیے automation.step پڑھتا ہے اور فارورڈز کے لیے Meta کا فیلڈ نام۔
WhatsApp بھیجنے والے کو CRM کانٹیکٹ سے کیسے ملائیں؟
فون نمبر سے، معیاری شکل میں ڈھال کر۔ WhatsApp ہندسے ملک کے کوڈ کے ساتھ، بغیر پلس کے بھیجتا ہے، جیسے 5511987654321، فارورڈز میں messages[].from میں اور webhook step میں contact.wa_id میں۔ لوگوں کے ٹائپ کیے گئے CRM ریکارڈز میں +55 11 98765-4321 یا (11) 98765-4321 ہوتا ہے، اس لیے صرف ہندسوں والی شکل کے لیے ایک الگ پراپرٹی رکھیں اور اسی پر تلاش کریں۔ جب کوئی مماثلت نہ ملے، تو WhatsApp پروفائل نام اور نمبر کے ساتھ کانٹیکٹ بنائیں۔
کاروبار تک محدود یوزر ID بھی محفوظ کریں۔ وہ یوزر جس کا WhatsApp یوزرنیم ہے اور جو 30 دن سے آپ کے نمبر کے ساتھ رابطے میں نہیں رہا، اس کے from_user_id اور contacts[].user_id میں صرف BSUID آ سکتا ہے۔ فارورڈز اسے لاتے ہیں؛ webhook step فون نمبر لاتا ہے۔
ہر CRM ریکارڈ میں کیا ہونا چاہیے؟
شناخت کنندگان کے ساتھ ایک کانٹیکٹ، اور ہر میسج کے لیے ایک ایکٹیویٹی جس میں سمت، متن، وقت اور ایک یونیک کی ہو۔ نیچے دیا گیا نقشہ دکھاتا ہے کہ ہر قدر دونوں راستوں میں کہاں ہوتی ہے۔ فارورڈز پر میسج کے اوقات Meta سے Unix سیکنڈ میں آتے ہیں؛ webhook step ISO تاریخیں بھیجتا ہے۔ میڈیا فارورڈز پر ایک ٹائپ اور ایک ID کی صورت میں آتا ہے، اور webhook step پر [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 پر upsert نہ ہو۔ پہلے 200 جواب دیں اور CRM کا کام کسی قطار یا پس منظر جاب میں کریں۔
webhook step دوبارہ کوشش نہیں ہوتا، اور Meta کی اپنی بار بار کی ڈیلیوریاں آٹومیشن چلنے سے پہلے فلٹر ہو جاتی ہیں، اس لیے یہ ہر میسج پر زیادہ سے زیادہ ایک بار کال کرتا ہے۔ اس کی ہسٹری انٹری میں میسج ID نہیں ہوتا: خودکار جوابات کو run_id اور ان کی پوزیشن کے ملاپ سے کلید بنائیں۔ Try it سے ٹیسٹ dry_run true اور نمونہ کانٹیکٹ 15550000000 کے ساتھ آتے ہیں؛ انہیں چھوڑ دیں تاکہ ٹیسٹ رنز کبھی CRM ریکارڈ نہ بنائیں۔
Node.js میں ریسیور کیسا نظر آتا ہے؟
ایک Express روٹ دونوں ایونٹ اقسام لیتا ہے۔ یہ خام باڈی پڑھتا ہے، X-EC-Event ہیڈر سے سیکرٹ چنتا ہے، X-EC-Signature کی تصدیق کرتا ہے، فوراً 200 جواب دیتا ہے اور کام ایک پس منظر فنکشن کو دے دیتا ہے۔ crm آبجیکٹ آپ کے CRM کے API کلائنٹ کی نمائندگی کرتا ہے: صرف ہندسوں والے فون نمبر پر کانٹیکٹ کا 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 کی سیکھی ہوئی معلومات سے لیڈ اپ ڈیٹ کر سکتا ہے؟
ہاں، آپ کے ورک فلو میں۔ Call my webhook step کے ساتھ آنے والی چیٹ میں وہ سوالات ہوتے ہیں جو آپ کے AI نے پوچھے اور کسٹمر کے جوابات، اس لیے n8n میں ماڈل نوڈ یا آپ کے بیک اینڈ میں ایک کال ضرورت، بجٹ، وقت یا مقام نکال سکتی ہے اور انہیں لیڈ کے فیلڈز میں لکھ کر اس کا اسٹیج بدل سکتی ہے۔ کوئی جواب نہ بھیجیں، کیونکہ کسٹمر کے پاس پہلے ہی AI کا میسج ہے۔ جب ورک فلو طے کرے کہ لیڈ کال کے قابل ہے، تو وہ سیلز پرسن کے لیے ٹاسک بنا سکتا ہے یا ٹیم کو الرٹ کر سکتا ہے۔ یا نکالنے کا کام easyCoexistence کو کرنے دیں: ایک ایجنٹ یا AI saves details مرحلہ ضرورت، بجٹ اور وقت کو رابطے کے فیلڈز میں لکھتا ہے، اور Call an API مرحلہ اپنی باڈی میں {{contact.budget}} طرز کے ٹوکنز کے ساتھ انہیں آپ کے CRM کو پوسٹ کر سکتا ہے۔ lead qualification صفحے پر انٹرویو کی ہدایات اور اس سیٹ اپ کے لیے پے لوڈ موجود ہے۔
اسے کیسے سیٹ اپ کریں
- 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 پر upsert کے بغیر ایکٹیویٹی دو بار درج ہوتی ہے۔
- صرف فارورڈ درج کرنا اور اس میں خودکار جوابات کی توقع رکھنا۔ API کے ذریعے بھیجے گئے میسجز بغیر متن کے اسٹیٹس کے طور پر واپس آتے ہیں؛ جواب کے بعد Call my webhook step الفاظ لے کر آتا ہے۔
- ٹیسٹس کو CRM تک پہنچنے دینا۔ Try it واقعی dry_run true اور نمونہ کانٹیکٹ 15550000000 کے ساتھ آپ کے URL کو کال کرتا ہے؛ کسی بھی upsert سے پہلے وہ ایونٹس ہٹا دیں۔
اس کا Forward URL کسٹمر میسجز اور فون کے جوابات کو Meta کے اصل ایونٹس کی صورت میں آپ کے CRM تک پہنچاتا ہے، ہر نمبر کے لیے دستخط شدہ، اور جب CRM ڈاؤن ہو تو تقریباً 33 گھنٹے تک دوبارہ کوشش ہوتی ہے، جبکہ Call my webhook step خودکار جوابات شامل کرتا ہے۔ فارورڈنگ اور آٹومیشن پلان میں شامل ہیں۔ فی نمبر فی مہینہ US$ 9 سے US$ 0.75 تک، نمبر بڑھانے کے ساتھ کم ہوتی ہوئی، اور پہلے 3 دن فری ٹرائل میں۔
اکثر پوچھے جانے والے سوالات
یہ کن CRMs کے ساتھ کام کرتا ہے؟
کوئی بھی CRM جس کا API ہو، یا تو آپ کے اپنے بیک اینڈ کے ذریعے، یا n8n، Make یا Zapier جیسے ورک فلو ٹول کے ذریعے جن کے پاس اس کے نوڈز ہوں۔ HubSpot میں Communications آبجیکٹ ہے جس میں WhatsApp چینل ٹائپ ہے، جو ان میسجز کو درج کرنے کے لیے بنا ہے؛ HubSpot کا صفحہ کال دکھاتا ہے۔
کیا میری ٹیم CRM سے کسٹمرز کو جواب دے سکتی ہے؟
صرف اس صورت میں اگر CRM نمبر کے send اینڈ پوائنٹ اور get_api_credentials کے ٹوکن کے ساتھ Meta کے Cloud API کے ذریعے بھیجے: کسٹمر کے آخری میسج کے 24 گھنٹے کے اندر آزاد متن، اور اس کے بعد منظور شدہ ٹیمپلیٹ۔ یہ میسجز ایپ کی فون پر چیٹ تھریڈ میں بھی ظاہر ہوتے ہیں۔
کیا پرانی گفتگوئیں CRM میں لوڈ ہو سکتی ہیں؟
صرف Meta کے ہسٹری امپورٹ کے ذریعے، جو ایک سے ایک چیٹ کے 6 ماہ تک کے میسجز اس ڈائریکٹ webhook destination پر بھیجتا ہے جو کنکشن کے 24 گھنٹوں کے اندر محفوظ کیا گیا ہو، ہر کنکشن کے لیے ایک بار۔ Through easyCoexistence پر سیٹ نمبر فارورڈنگ شروع ہونے کے لمحے سے درج کرتا ہے۔
easyCoexistence راستے میں کیا محفوظ رکھتا ہے؟
فارورڈ کی گئی تبدیلیاں دوبارہ کوشش کے لیے قطار میں رہتی ہیں اور 7 دن بعد ہٹا دی جاتی ہیں۔ جو نمبر easyCoexistence کے ذریعے چلتا ہے، اس پر میسج کا متن Conversations اور AI سیاق کے لیے آپ کے منتخب کردہ وقت، یعنی 30، 90 یا 365 دن، تک بھی رہتا ہے، اور رن لاگز 30 دن تک محفوظ رہتے ہیں۔ مستقل ریکارڈ CRM کے پاس ہوتا ہے۔
مزید پڑھیں
شروع کرنے کے لیے تیار ہیں؟
WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔
فری ٹرائل شروع کریںتصدیق شدہ تاریخ