WhatsApp آٹومیشنز کو محفوظ بنائیں: کیز، ویب ہکس اور دستخط
WhatsApp آٹومیشن کو چار نکات پر محفوظ بنائیں: AI کی، جو خفیہ شکل میں محفوظ ہو اور صرف AI جوابات کے لیے استعمال ہو؛ ویب ہک جسے آٹومیشن کال کرتی ہے، جو کسی درخواست پر بھروسہ کرنے سے پہلے HMAC دستخط جانچے؛ آنے والے میسجز کا فارورڈ، جو قابلِ تبدیل سیکرٹ سے دستخط شدہ ہو؛ اور وہ لوگ اور اسسٹنٹس جن کی رسائی ہے، جو صرف ضرورت تک محدود رہے۔
easyCoexistence آپ کی AI کیز خفیہ شکل میں محفوظ کرتا ہے اور انہیں دوبارہ کبھی نہیں دکھاتا، ہر Call my webhook درخواست اور ہر فارورڈ کیا گیا میسج X-EC-Signature کے ساتھ ایسے سیکرٹ سے دستخط کرتا ہے جو صرف آپ کے پاس ہو، اور عوامی HTTPS نہ ہونے والے ویب ہک پتے مسترد کرتا ہے۔
محفوظ شدہ AI کیز، سائننگ سیکرٹس اور نمبر کے Meta رسائی ٹوکن کو ذخیرہ کرتے وقت خفیہ کاری استعمال ہوتی ہے۔
محفوظ شدہ AI کی دوبارہ صرف یوں دکھائی جاتی ہے: “ending in” کے ساتھ اس کے آخری چار حروف۔
ہر سائننگ سیکرٹ میں whsec_ کے بعد 24 رینڈم بائٹس ہوتی ہیں، ہر آٹومیشن اور ہر فارورڈنگ نمبر کے لیے ایک۔
ویب ہک اور فارورڈ URLs لازماً عوامی HTTPS ہوں؛ نجی اور اندرونی پتے محفوظ کرتے وقت اور ہر بھیجنے سے پہلے مسترد کیے جاتے ہیں۔
دستخط کی t قدر کی عمر پر تجویز کردہ حد، تاکہ دوبارہ چلائی گئی درخواستیں مسترد ہوں۔
WhatsApp آٹومیشن سیٹ اپ میں کس چیز کی حفاظت ضروری ہے؟
پانچ کریڈینشلز، ہر ایک کی اپنی جگہ اور لیک ہونے پر اپنا علاج۔ ان میں سے دو خود آٹومیشنز کے ہیں: AI کی اور “Call my webhook” کا سائننگ سیکرٹ؛ فارورڈ سیکرٹ نمبر کا ہے؛ رسائی ٹوکن اور آپ کے اسسٹنٹ کا سائن اِن اکاؤنٹ کا ہے۔ یہ جاننا بتاتا ہے کہ کچھ غلط ہونے پر کیا بدلنا ہے۔
AI کیز کیسے محفوظ اور استعمال ہوتی ہیں؟
صرف ڈیش بورڈ سے: آٹومیشنز صفحے پر “AI keys” بٹن، پھر “Test and save”۔ کی پہلے ایک مفت اینڈ پوائنٹ پر پرووائیڈر کے ذریعے جانچی جاتی ہے، جس میں کوئی ٹوکن خرچ نہیں ہوتا، اور وہ کی جسے پرووائیڈر مسترد کرے وہ محفوظ کیے بغیر ہٹا دی جاتی ہے۔ کام کرنے والی کی AES-256-GCM سے خفیہ شکل میں ذخیرہ ہوتی ہے، صرف آپ کے AI مراحل اور ایجنٹس کے لیے اس پرووائیڈر کو کال کرتے وقت، اور OpenAI یا OpenRouter کی پر وائس میسجز کو متن میں لکھنے کے لیے ڈی کرپٹ ہوتی ہے، اور بعد میں صرف یوں دکھائی جاتی ہے: “ending in 1234”۔ کوئی MCP ٹول کی قبول یا واپس نہیں کرتا، اس لیے یہ کبھی آپ کے اسسٹنٹ کے ساتھ چیٹ سے نہیں گزرتی۔
ایک اکاؤنٹ میں ہر پرووائیڈر کی ایک کی ہوتی ہے، اور نئی محفوظ کرنے سے پرانی بدل جاتی ہے۔ پرووائیڈر کے پاس آٹومیشنز کے لیے الگ کی بنائیں، جہاں ممکن ہو خرچ کی حد کے ساتھ، تاکہ وہ آپ کی دوسری ایپس کو توڑے بغیر منسوخ ہو سکے۔ اگر پرووائیڈر اسے کبھی مسترد کرے تو اسے استعمال کرنے والی آٹومیشنز “Paused” دکھاتی ہیں اور آپ کو ایک ای میل ملتی ہے؛ ایک کام کرنے والی کی محفوظ کرنے سے وہ خود دوبارہ شروع ہو جاتی ہیں۔
Call my webhook کی درخواست کا اصلی ہونا کیسے جانچیں؟
کوئی بھی چیز پڑھنے سے پہلے دستخط جانچیں۔ ہر درخواست کے ساتھ X-EC-Signature آتا ہے: t=<unix seconds>,v1=<hex HMAC-SHA256 of “<t>.<raw body>”>، جو اس آٹومیشن کے “Signing secret” سے بنایا جاتا ہے، جو آپ محفوظ کرنے کے بعد ایڈیٹر کے مرحلے سے کاپی کرتے ہیں۔ خام بائٹس پر HMAC دوبارہ نکالیں، مستقل وقت میں موازنہ کریں، اور وہ t جو آپ کی گھڑی سے 5 منٹ سے زیادہ دور ہو مسترد کریں۔ باڈی سے دو اہم باتیں بھی معلوم ہوتی ہیں۔ dry_run اس وقت true ہوتا ہے جب درخواست “Try it” سے آئی ہو، تو ایسی کوئی بھی کارروائی چھوڑ دیں جسے واپس نہ کیا جا سکے، جیسے آرڈر بنانا۔ اور run_id ہر رن کے لیے منفرد ہے، اس لیے ان کی فہرست رکھیں جنہیں آپ نمٹا چکے ہیں اور دوبارہ چلائی گئی درخواست مسترد کریں۔ 20 سیکنڈ میں جواب دیں؛ {"reply": "..."} گاہک کو جوں کا توں بھیجا جاتا ہے، اس لیے گاہک کا متن کبھی بغیر جانچے آگے نہ بھیجیں۔
POST /hooks/whatsapp HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-automations/1
X-EC-Event: automation.step
X-EC-Signature: t=1794405732,v1=<64 hex characters>
{
"event": "automation.step",
"dry_run": false,
"automation": { "id": "a7d0c3e2-5b1f-4c8e-9a6d-2f4e8b1c7d90", "name": "Order status" },
"run_id": "e41b9f07-3c2a-4d6e-8f15-7a9c0b2d4e68",
"channel": { "type": "whatsapp", "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==", "type": "text", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.000Z" },
"history": [
{ "direction": "in", "text": "Hi!", "at": "2026-11-11T14:01:40.120Z" },
{ "direction": "in", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.310Z" }
]
}
// Your answer, within 20 seconds (or {} to send nothing):
{ "reply": "Your order #1042 left the shop at 2:20 p.m." }فارورڈ سیکرٹس کیسے کام کرتے ہیں، اور انہیں کیسے بدلا جاتا ہے؟
جو نمبر Through easyCoexistence پر سیٹ ہو وہ آنے والے میسجز اپنے سسٹم کو فارورڈ کر سکتا ہے۔ پہلی بار Forward URL محفوظ کرتے وقت ایک سیکرٹ بنتا ہے اور صرف ایک بار دکھایا جاتا ہے، “Your signing secret, shown once. Copy it now:” کے تحت؛ یہ ہر فارورڈ کی گئی POST پر اسی X-EC-Signature طریقے سے دستخط کرتا ہے۔ نمبر کے صفحے پر “New secret”، یا rotate_secret کو true کے ساتھ set_inbound_mode سے ایک متبادل بنتا ہے، جو پھر ایک بار دکھایا جاتا ہے، اور اس کے بعد سے ہر چیز پر دستخط ہوتے ہیں، پرانی ڈیلیوری کی دوبارہ کوششوں سمیت۔ آپ اپنا سیکرٹ بھی لکھ سکتے ہیں، کم از کم 24 حروف کا، جو محفوظ کر لیا جاتا ہے اور دوبارہ کبھی نہیں دکھایا جاتا۔ فارورڈنگ بند کرنے سے سیکرٹ حذف ہو جاتا ہے، اس لیے بعد میں URL محفوظ کرنے پر نیا سیکرٹ بنتا ہے۔
ٹیم کے کسی رکن کے رسائی چھوڑنے کے بعد، کسی سیکرٹ کے کسی ریپوزٹری، ٹکٹ یا لاگ میں پہنچنے کے بعد، اور ہوسٹنگ بدلتے وقت بدلیں۔ “Call my webhook” سیکرٹ آٹومیشن کا ہوتا ہے اور اسے صرف اکاؤنٹ کا مالک دیکھتا ہے۔ جہاں ایڈیٹر “Your system calls a URL” ٹرگر کے تحت “New secret” دکھاتا ہے، وہ بٹن اسے بدل دیتا ہے اور پرانا فوراً کام کرنا بند کر دیتا ہے؛ جس آٹومیشن میں وہ بٹن نہ ہو، اس میں آٹومیشن دوبارہ بنائیں، اپنے ریسیور کو نئے سیکرٹ پر لے جائیں، پھر پرانی آٹومیشن حذف کریں۔
آٹومیشنز کن پتوں کو کال کر سکتی ہیں؟
صرف عوامی HTTPS پتے۔ وہ Call my webhook URL یا Forward URL جو http:// سے شروع ہو، localhost کی طرف اشارہ کرے، نجی نیٹ ورک رینج، .internal یا .local نام، یا کلاؤڈ میٹا ڈیٹا پتا ہو، محفوظ کرتے وقت مسترد ہوتا ہے، اور ہر درخواست سے پہلے DNS کے بعد دوبارہ جانچا جاتا ہے، تاکہ کوئی عوامی نام بعد میں کسی نجی نیٹ ورک کی طرف موڑا نہ جا سکے۔ ری ڈائریکٹس فالو نہیں کیے جاتے: 301 یا 302 مرحلہ ناکام کر دیتا ہے، اس لیے حتمی پتا محفوظ کریں۔
سیکرٹس کو URL سے باہر رکھیں۔ list_automations ہر آٹومیشن کے مراحل، بشمول ویب ہک URL، آپ کے اکاؤنٹ سے جڑے کسی بھی اسسٹنٹ کو واپس دیتا ہے، اس لیے کوئری اسٹرنگ میں ٹوکن وہاں پڑھا جا سکتا ہے۔ اس کے بجائے ثبوت دستخط کے ذریعے دیں۔
رسائی کو کم سے کم کیسے رکھیں؟
ہر شخص اور ہر ٹول کو صرف وہی رسائی دیں جو اس کے کام کے لیے ضروری ہو، اور جو اب استعمال نہ ہو اسے ہٹا دیں۔ کنیکٹر کی طرف، یعنی سائن اِن، تصدیق اور بلاک شدہ ٹولز، وہ صفحے پر دیا گیا ہے جو WhatsApp کو AI سے محفوظ طریقے سے جوڑنے پر ہے؛ آٹومیشن کی طرف یہ عادات سب سے زیادہ اہم ہیں:
get_api_credentialsصرف نجی چیٹ میں مانگیں: نمبر کا رسائی ٹوکن پھر اس ٹرانسکرپٹ میں رہتا ہے۔- کسی تھرڈ پارٹی ٹول کو ٹوکن دینے کے بجائے Call my webhook یا Forward URL کو ترجیح دیں۔
- ریٹائر کی گئی آٹومیشنز حذف کریں؛ اس سے ان کے سائننگ سیکرٹس بھی ریٹائر ہو جاتے ہیں۔
- یاد رکھیں کہ رن لاگز 30 دن تک گاہک کے میسجز اور جوابات رکھتے ہیں، اور Conversations چیٹس کو آپ کی مقرر کردہ مدت (30، 90 یا 365 دن) تک رکھتی ہیں، اور دونوں ڈیش بورڈ اور آپ کے جڑے ہوئے اسسٹنٹ کے ذریعے پڑھے جا سکتے ہیں۔
- ایک نمبر پر جو “Straight to your system” پر سیٹ ہو، کال بیک URL کے پاتھ میں ایک طویل رینڈم سیکرٹ رکھیں، کیونکہ وہاں Meta کا دستخط جانچا نہیں جا سکتا۔
عام غلطیاں
- دستخط ایسے JSON پر جانچنا جسے آپ کے فریم ورک نے دوبارہ سیریلائز کیا ہو۔ کئی پارسرز اسپیسنگ، ایسکیپنگ یا کیز کی ترتیب بدل دیتے ہیں؛ جہاں آپ کا اسٹیک خام درخواست بائٹس فراہم کرے وہاں HMAC انہی پر نکالیں۔
- ٹیسٹ کالز پر سائیڈ ایفیکٹس چلانا۔ Try it آپ کے ویب ہک کو dry_run کو true کے ساتھ کال کرتا ہے؛ اس وقت بنایا گیا آرڈر، ریفنڈ یا CRM میں لکھا گیا ڈیٹا حقیقی ہوتا ہے۔
- وقت بچانے کے لیے AI کی کو اسسٹنٹ کے ساتھ چیٹ میں چسپاں کرنا۔ کوئی ٹول اسے قبول نہیں کرتا، اور یہ ٹرانسکرپٹ میں رہتی ہے؛ AI keys ڈیش بورڈ میں استعمال کریں۔
- فارورڈ کو Call my webhook سیکرٹ سے جانچنا، یا اس کے برعکس۔ یہ الگ سیکرٹس ہیں: فارورڈز کے لیے ہر نمبر کا ایک، ویب ہک کالز کے لیے ہر آٹومیشن کا ایک۔
آپ کا نمبر Coexistence کے ذریعے Meta کے سرکاری Cloud API پر رہتا ہے، 24/7 نگرانی کے ساتھ۔ فی نمبر فی مہینہ US$ 9 سے US$ 0.75 تک، نمبر بڑھانے کے ساتھ کم ہوتی جاتی ہے، پہلے 3 دن مفت۔
اکثر پوچھے جانے والے سوالات
کیا easyCoexistence کا عملہ یا سپورٹ میری AI کی دیکھ سکتا ہے؟
کی محفوظ کرنے کے بعد کبھی نہیں دکھائی جاتی: نہ ڈیش بورڈ میں، نہ MCP نتائج میں، نہ اس حقیقت میں جو سپورٹ اسسٹنٹ پڑھتا ہے۔ اسے صرف سسٹم ڈی کرپٹ کرتا ہے، اسی لمحے جب وہ AI جواب کے لیے آپ کے پرووائیڈر کو کال کرتا ہے۔
میرے آٹومیشن رن لاگز کون پڑھ سکتا ہے؟
easyCoexistence کے اکاؤنٹ میں سائن ان کوئی بھی شخص، بشمول وہ لوگ جنہیں آپ نے مدعو کیا ہو، Runs ٹیب میں، اور اکاؤنٹ سے جڑا کوئی بھی اسسٹنٹ، list_automation_runs اور get_automation_run کے ذریعے۔ لاگز میں گاہک کا میسج اور جواب ہوتا ہے، اور وہ 30 دن بعد حذف ہو جاتے ہیں۔
AI کی کو محفوظ طریقے سے کیسے ہٹاؤں؟
پہلے وہ آٹومیشنز بند کریں جو اسے استعمال کرتی ہیں، اور کوئی بھی ایجنٹ جو اس پر چلتا ہو، پھر “AI keys” کے تحت Remove منتخب کریں اور پرووائیڈر پر کی منسوخ کریں۔ اگر آٹومیشنز اب بھی اسے استعمال کر رہی ہوں تو اسے ہٹانے سے وہ اگلے AI جواب پر Paused ہو جاتی ہیں اور آپ کو ای میل آتی ہے۔
کیا Try it میرے ویب ہک پر گاہک کا ڈیٹا بھیجتا ہے؟
یہ صرف وہ نمونہ متن بھیجتا ہے جو آپ نے لکھا، dry_run کو true اور خالی ہسٹری کے ساتھ۔ حقیقی رنز آنے والا میسج اور چیٹ کے حالیہ میسجز، زیادہ سے زیادہ 10، بھیجتے ہیں، اس لیے اپنے اینڈ پوائنٹ کو گاہک کا ڈیٹا سنبھالنے والا سمجھیں۔
مزید پڑھیں
شروع کرنے کے لیے تیار ہیں؟
WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔
فری ٹرائل شروع کریںتصدیق شدہ تاریخ