WhatsApp پیغامات اور رابطے خودکار طور پر Google Sheets میں محفوظ کریں
WhatsApp Business پیغامات کو خودکار طور پر Google Sheets میں محفوظ کرنے کے لیے، انہیں دستخط شدہ HTTP POST درخواستوں کے ذریعے n8n، Make یا Zapier جیسے آٹومیشن ٹول کو بھیجیں، اور اس کا Google Sheets مرحلہ ہر پیغام کے لیے ایک قطار شامل کرنے دیں: وقت، سمت، فون نمبر، نام، متن اور میسج آئی ڈی۔ فون نمبر پر مبنی دوسرا ٹیب ہر رابطے کے لیے ایک قطار رکھتا ہے، جو اس کے دوبارہ لکھنے پر اپڈیٹ ہوتی ہے۔
easyCoexistence آپ کے ایپ میں رکھے WhatsApp Business نمبر کو Coexistence کے ذریعے Meta کے Cloud API سے جوڑتا ہے۔
اگر آپ کا URL ناکام ہو تو فارورڈ شدہ ڈیلیوری تقریباً 1، 5، 30، 120، 360 اور 1,440 منٹ کے بعد دوبارہ کوشش کی جاتی ہے۔
فارورڈ شدہ POST کتنی دیر 2xx جواب کا انتظار کرتی ہے، اس سے پہلے کہ وہ ڈیلیوری دوبارہ بھیجی جائے۔
Google Sheets API میں فی پروجیکٹ لکھنے کی درخواستیں فی منٹ، فی صارف، اجازت شدہ ہیں؛ فی پروجیکٹ 300 ہیں۔
Apps Script ویب ایپ کا آؤٹ پٹ ایک بار استعمال ہونے والے script.googleusercontent.com URL پر ری ڈائریکٹ ہوتا ہے۔
Apps Script کا doPost ایونٹ آبجیکٹ باڈی اور پیرامیٹرز دکھاتا ہے، HTTP درخواست کے ہیڈرز نہیں۔
کون سا راستہ شیٹ بھرے؟
جس نمبر کے پیغامات easyCoexistence سے گزرتے ہیں اس پر دو راستے ہیں، جو مختلف ضرورتیں پوری کرتے ہیں۔ Forward URL، جو ہر نمبر کے لیے ایک بار سیٹ ہوتا ہے، Meta کے اصل ایونٹس آگے بھیجتا ہے، چاہے کوئی آٹومیشن جواب دے یا نہ دے: گاہک کے پیغامات، آپ کی ٹیم کے WhatsApp Business ایپ میں ٹائپ کیے گئے جواب اور ڈیلیوری اسٹیٹسز۔ مکمل پیغام لاگ کے لیے یہی راستہ ہے۔ آٹومیشن کے اندر Call my webhook مرحلہ صرف ان پیغامات پر چلتا ہے جنہیں وہ آٹومیشن منتخب کرتی ہے، اور اس میں حالیہ چیٹ شامل ہوتی ہے، بشمول وہ جواب جو آٹومیشن نے ابھی بھیجا۔ یہ ان لیڈز، آرڈرز یا درخواستوں کی شیٹ کے لیے موزوں ہے جنہیں ایک آٹومیشن سنبھالتی ہے۔ دونوں دستخط شدہ ہیں، مگر ان کے راز مختلف ہیں۔
| Forward URL (per number) | Call my webhook step (per automation) | |
|---|---|---|
| Fires on | Any message event on the number, with or without automations | Only messages that automation is picked for |
| Carries | Meta's original value: messages, phone replies, statuses | The message, the contact and up to 10 recent messages |
| Automated replies | Delivery statuses only, without the text | In history, direction out |
| Retries | 7 attempts over about 33 hours | One attempt |
| Signed with | The number's forward secret, shown once | The automation's Signing secret |
| Set in | Number page, Where incoming messages go card | The automation editor, or create_automation |
کون سے فیلڈز آتے ہیں، اور شیٹ میں کون سے کالم ہونے چاہئیں؟
فارورڈ شدہ POST ایک Meta change کو لپیٹتا ہے: id (ڈیلیوری)، event (Meta کا فیلڈ نام، جیسے messages یا smb_message_echoes)، received_at، connection (آپ کے نمبر کی id، phone اور phone_number_id) اور value، بالکل ویسا جیسا Meta نے بھیجا۔ value میں messages وہ رکھتے ہیں جو گاہکوں نے لکھا، اور message_echoes وہ جو آپ کی ٹیم نے فون پر ٹائپ کیا۔ فون نمبر ملک کوڈ کے ساتھ صرف ہندسوں میں آتے ہیں، بغیر پلس کے نشان کے؛ وہ کالم سادہ متن کے طور پر محفوظ کریں تاکہ Sheets اسے نمبر میں نہ بدلے۔ WhatsApp username رکھنے والا صارف نمبر کے ساتھ، یا اس کے بجائے، business-scoped user ID کے ساتھ آ سکتا ہے، اس لیے اس کے لیے بھی ایک کالم رکھیں۔
n8n میں پیغام لاگ کیسے بنائیں؟
تین نوڈز۔ HTTP Method POST والا Webhook نوڈ، Respond کو Immediately پر سیٹ، اور اس کا Production URL نمبر کے Forward URL کے طور پر محفوظ کیا گیا۔ ایک Code نوڈ جو forward secret کے ساتھ X-EC-Signature چیک کرتا ہے اور ایونٹ کو قطاروں میں بدلتا ہے، ڈیلیوری اسٹیٹسز کو چھوڑتے ہوئے۔ ایک Google Sheets نوڈ جس میں Append or Update Row آپریشن ہو، Column to match on کو Message id پر سیٹ کیا گیا ہو، تاکہ دوبارہ کوشش کی گئی ڈیلیوری ایک نئی قطار شامل کرنے کے بجائے وہی قطار دوبارہ لکھے۔
forward secret ایک بار ظاہر ہوتا ہے، جب آپ Forward URL محفوظ کرتے ہیں؛ اگر وہ گم ہو جائے تو New secret پر کلک کریں اور نیا پیسٹ کریں۔ n8n Cloud Code نوڈز میں crypto ماڈیول کی اجازت دیتا ہے؛ خود میزبانی والے n8n کے لیے NODE_FUNCTION_ALLOW_BUILTIN=crypto سیٹ کرنا ضروری ہے۔
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the number's forward secret, shown once when you saved the Forward URL
const { headers, body } = $input.first().json;
const sig = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(headers['x-ec-signature'] || '');
if (!sig || Math.abs(Date.now() / 1000 - Number(sig[1])) > 300) throw new Error('Bad or stale signature');
// n8n has parsed the body; it was sent as compact JSON, so JSON.stringify rebuilds the signed bytes.
const mac = crypto.createHmac('sha256', SECRET).update(sig[1] + '.' + JSON.stringify(body)).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(sig[2], 'hex'))) throw new Error('Bad signature');
const { event, connection, value } = body;
const names = Object.fromEntries((value.contacts || []).map((c) => [c.wa_id, c.profile?.name || '']));
const textOf = (m) => m.text?.body ?? m.button?.text ?? m.interactive?.button_reply?.title
?? m.interactive?.list_reply?.title ?? ('[' + m.type + '] ' + (m[m.type]?.caption || '')).trim();
const row = (m, direction, phone) => ({
time: new Date(Number(m.timestamp) * 1000).toISOString(), direction, phone,
user_id: m.from_user_id || '', name: names[phone] || '', text: textOf(m),
message_id: m.id, number: connection.phone,
});
let rows = [];
if (event === 'messages') rows = (value.messages || []).map((m) => row(m, 'in', m.from || '')); // statuses skipped
if (event === 'smb_message_echoes') rows = (value.message_echoes || []).map((m) => row(m, 'out', m.to || ''));
return rows.map((json) => ({ json }));ہر رابطے کے لیے ایک قطار کیسے رکھیں؟
Contacts ٹیب پر ایک دوسرا Google Sheets نوڈ شامل کریں، جو بھی Append or Update Row کے ساتھ ہو، Phone پر مماثل کیا گیا ہو۔ فون، پروفائل نام، user ID، وقت اور تازہ ترین پیغام کا متن میپ کریں۔ کسی نمبر سے پہلا پیغام اس کی قطار بناتا ہے؛ بعد کے پیغامات نام اور آخری رابطے کے کالم اپڈیٹ کرتے ہیں، تاکہ یہ ٹیب ایک فہرست بھی بن جائے کہ کس نے کب لکھا۔ ہاتھ سے لکھے نوٹس ایک الگ ٹیب پر رکھیں، جنہیں فون سے دیکھا جائے، تاکہ ورک فلو انہیں کبھی اوور رائٹ نہ کرے۔
فون کی ایڈریس بک میں محفوظ رابطے اس طرح نہیں آتے۔ Meta انہیں، 6 ماہ تک کی چیٹس کے ساتھ، صرف اس براہ راست ویب ہک منزل کو بھیجتا ہے جو نمبر جوڑنے کے 24 گھنٹے کے اندر محفوظ کی گئی ہو۔
کیا Apps Script پیغامات براہ راست وصول کر سکتا ہے؟
صاف طور پر نہیں، اس لیے شیٹ کے سامنے ایک ورک فلو ٹول رکھیں۔ Google Apps Script ویب ایپ کا جواب ایک بار استعمال ہونے والے script.googleusercontent.com URL پر ری ڈائریکٹ کے ذریعے پیش کرتا ہے، اور easyCoexistence ری ڈائریکٹ کی پیروی نہیں کرتا۔ 302 ناکام ڈیلیوری شمار ہوتا ہے: فارورڈ کو 7 بار تک دوبارہ کوشش کی جاتی ہے، اور ہر دوبارہ کوشش doPost کو دوبارہ چلاتی ہے اور ایک اور قطار لکھتی ہے، جبکہ Call my webhook مرحلہ ناکام ہو کر آپ کو ای میل بھیجتا ہے۔ doPost درخواست کے ہیڈرز بھی نہیں پڑھ سکتا، اس لیے وہاں X-EC-Signature کی جانچ ممکن نہیں۔
Apps Script دوسری سمت کے لیے اب بھی موزوں ہے، یعنی شیٹ کی قطاروں سے منظور شدہ ٹیمپلیٹس بھیجنا، جس کا کوڈ Google Sheets انٹیگریشن صفحے پر ہے۔
کیا Make یا Zapier اس کے بجائے شیٹ بھر سکتے ہیں؟
جی ہاں۔ Make میں منظرنامہ Webhooks > Custom webhook سے شروع کریں اور Google Sheets > Add a Row شامل کریں؛ Zapier میں Webhooks by Zapier کے ساتھ Catch Raw Hook استعمال کریں، جو ہیڈرز برقرار رکھتا ہے، پھر Google Sheets > Create Spreadsheet Row۔ دونوں POST کا جواب فوراً 2xx کے ساتھ دیتے ہیں، جو فارورڈ کو اس کے 10 سیکنڈ کے اندر درکار ہوتا ہے۔ value.messages سے وہی فیلڈز اوپر کی طرح میپ کریں، اور ان ایونٹس کو چھان دیں جن کی value میں messages کے بجائے statuses ہوں۔
ویب ہک URL کو پاس ورڈ سمجھیں، کیونکہ جو بھی اسے رکھتا ہے وہ قطاریں پوسٹ کر سکتا ہے۔ اگر آپ کے پلان میں کوڈ مرحلہ شامل ہو تو وہاں n8n نوڈ میں استعمال ہونے والے HMAC طریقے سے X-EC-Signature کی جانچ کریں۔
ڈپلیکیٹ یا گم شدہ قطاروں سے کیسے بچیں؟
ڈپلیکیٹس دوبارہ کوششوں سے آتے ہیں۔ جو فارورڈ 10 سیکنڈ میں 2xx حاصل نہ کرے، وہ اسی X-EC-Delivery ہیڈر اور باڈی میں اسی id کے ساتھ دوبارہ بھیجا جاتا ہے، اور اندر کے پیغامات اپنا wamid برقرار رکھتے ہیں، اس لیے Message id پر مماثلت دوبارہ کوشش کو بے ضرر بنا دیتی ہے۔ Webhook-step راستے پر، Try it کے ٹیسٹ dry_run true کے ساتھ آتے ہیں: انہیں ٹیسٹ ٹیب پر بھیجیں یا چھوڑ دیں۔
گم شدہ قطاریں Google کی لکھنے کی کوٹا سے آتی ہیں۔ Sheets API فی منٹ، فی صارف، فی پروجیکٹ 60 لکھنے کی درخواستیں دیتا ہے، اور ایک n8n کریڈینشل ایک صارف ہے؛ ٹیمپلیٹ مہم کے بعد جوابات کا ایک زوردار ریلا اس سے تجاوز کر کے HTTP 429 لا سکتا ہے۔ Google Sheets نوڈ کی سیٹنگز میں Retry On Fail آن کریں، یا چند سیکنڈ پیغامات جمع کر کے انہیں ایک درخواست میں شامل کریں۔
اسے کیسے سیٹ اپ کریں
- Check the number's modeOn the number's page, the card Where incoming messages go must show Through easyCoexistence. If it shows Straight to your system, choose Through easyCoexistence.
- Build the workflowWebhook node (POST, Respond Immediately), the Code node above, then Google Sheets with Append or Update Row matched on Message id. Activate it and copy the Production URL.
- Save the Forward URLPaste the Production URL into Forward URL (optional) and click Save forward URL. Copy the signing secret shown once into the Code node.
- Send a test messageFrom another phone, write to your number and reply to it from the WhatsApp Business app. Two rows should appear: one in, one out.
عام غلطیاں
- فارورڈ کی جانچ آٹومیشن کے Signing secret سے کرنا، یا اس کا الٹ۔ Forward URL نمبر کے forward secret سے دستخط شدہ ہوتا ہے، اور Call my webhook آٹومیشن کے اپنے secret سے؛ راز X-EC-Event ہیڈر سے چنیں۔
- کلید کے بغیر ہر POST کے لیے ایک قطار شامل کرنا۔ سست جواب کے بعد دوبارہ بھیجی گئی ڈیلیوری وہی پیغام دو بار لکھ دیتی ہے؛ message id پر مماثل Append or Update Row استعمال کریں۔
- ڈیلیوری اسٹیٹسز کو پیغامات کے طور پر لکھنا۔ messages ایونٹ value.statuses میں sent، delivered اور read اسٹیٹسز بھی رکھتا ہے، جن میں متن نہیں ہوتا اور وہ خالی قطاریں بناتے ہیں۔
- Apps Script ویب ایپ کا URL بطور Forward URL محفوظ کرنا۔ اس کا ری ڈائریکٹ ناکامی شمار ہوتا ہے، اس لیے 7 میں سے ہر کوشش doPost کو دوبارہ چلاتی ہے اور ایک ڈپلیکیٹ قطار شامل کرتی ہے۔
آٹومیشن آن ہونے پر، ایک Forward URL Meta کے اصل ایونٹس آپ کے ورک فلو کو بھیجتا ہے، ایک ایسے راز سے دستخط شدہ جو صرف آپ کے پاس ہے، اور آپ کا URL بند ہونے پر دوبارہ کوشش ہوتی ہے؛ اور Call my webhook مرحلہ وہ بھیجتا ہے جو آٹومیشن نے سنبھالا، اس کے جواب کے ساتھ۔ دونوں پلان میں شامل ہیں۔ US$ 9 سے US$ 0.75 تک فی نمبر فی مہینہ، نمبر بڑھنے کے ساتھ کم ہوتی ہوئی، پہلے 3 دن کا فری ٹرائل۔
اکثر پوچھے جانے والے سوالات
کیا شیٹ میں وہ پیغامات آتے ہیں جو میری ٹیم فون پر ٹائپ کرتی ہے؟
جی ہاں، Forward URL کے ذریعے۔ WhatsApp Business ایپ میں ٹائپ کیے گئے جواب smb_message_echoes ایونٹس کے طور پر آتے ہیں، جن کے to فیلڈ میں گاہک کا نمبر ہوتا ہے۔ آٹومیشن کے بھیجے گئے جواب صرف ڈیلیوری اسٹیٹسز کے طور پر واپس آتے ہیں، اس لیے ان کا متن اس Call my webhook مرحلے سے لاگ کریں جو جواب کے بعد رکھا گیا ہو۔
کیا میں اپنی موجودہ چیٹس شیٹ میں لوڈ کر سکتا ہوں؟
جس نمبر کے پیغامات easyCoexistence سے گزرتے ہیں اس پر نہیں۔ Meta، 6 ماہ تک کی انفرادی چیٹس، صرف اس براہ راست ویب ہک منزل کو بھیجتا ہے جو کنکشن کے 24 گھنٹے کے اندر محفوظ ہو، ہر کنکشن کے لیے ایک بار۔ easyCoexistence کے ذریعے چلنے والا نمبر Forward URL محفوظ ہونے کے لمحے سے لاگ کرتا ہے۔
کیا easyCoexistence پیغامات کی کاپی رکھتا ہے؟
جزوی طور پر۔ easyCoexistence کے ذریعے روٹ ہونے والے اور آٹومیشنز آن والے نمبر پر، پیغام کا متن آپ کی منتخب کردہ مدت، 30، 90 یا 365 دن (ڈیفالٹ 90)، تک رکھا جاتا ہے اور Conversations میں دکھایا جاتا ہے؛ فارورڈ کی گئی ترسیلات دوبارہ کوشش کے لیے 7 دن تک، اور رن لاگز 30 دن رکھے جاتے ہیں۔ شیٹ آپ کی مستقل کاپی ہے۔
کیا میرا AI جواب دینے کے لیے شیٹ پڑھ سکتا ہے؟
Reply with AI مرحلے سے نہیں، کیونکہ وہ صرف اپنی Instructions اور چیٹ پڑھتا ہے۔ AI ایجنٹ کسٹم HTTP ٹول کے ذریعے چیزیں تلاش کر سکتا ہے، اور Call my webhook یا Call an API مرحلہ سوال ایک ورک فلو کو بھیج سکتا ہے، جو شیٹ میں جواب تلاش کر کے اسے جواب کے طور پر واپس کرتا ہے۔
مزید پڑھیں
شروع کرنے کے لیے تیار ہیں؟
WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔
فری ٹرائل شروع کریںتصدیق شدہ تاریخ