AI ایجنٹس کے لیے WhatsApp API: Tech Provider بنے بغیر منٹوں میں سرکاری رسائی
AI ایجنٹ کو Meta کے Cloud API کے ذریعے سرکاری WhatsApp رسائی ملتی ہے، اور وہ نمبر جو WhatsApp Business ایپ میں ہی رہتا ہے، Tech Provider یا Solution Partner کے ذریعے اس سے جڑتا ہے۔ آپ خود Tech Provider بن سکتے ہیں، جس کے لیے کاروباری تصدیق، App Review کی ویڈیوز اور Embedded Signup بنانا ہوگا، یا ایسے پرووائیڈر سے جڑ سکتے ہیں جو پہلے ہی بن چکا ہے: نمبر منٹوں میں جڑ جاتا ہے اور ایجنٹ کو MCP ٹولز یا API کریڈینشلز مل جاتے ہیں۔
easyCoexistence ایک آزاد Meta Tech Provider ہے: یہ WhatsApp Business نمبر کو Coexistence کے ذریعے منٹوں میں Cloud API سے جوڑتا ہے، تاکہ آپ کا ایجنٹ سرکاری رسائی حاصل کرے اور کاروبار ایپ بھی رکھے۔
جو نمبر WhatsApp Business ایپ میں رہتا ہے، اسے آن بورڈ کرنے والے سے Meta تقاضا کرتا ہے کہ اس کے پاس Tech Provider یا Solution Partner کا درجہ ہو۔
App Review ایک ایسے میسج کی ویڈیو مانگتا ہے جو آپ کی ایپ سے بھیجا گیا ہو، اور ایک ایسی ویڈیو جس میں آپ کی ایپ ٹیمپلیٹ بنا رہی ہو۔
App Review سے whatsapp_business_messaging اور whatsapp_business_management کی منظوری ملتی ہے، جو Tech Provider بننے کے لیے دونوں درکار ہیں۔
جب Meta نے Embedded Signup کے v2 اور v3 کو متروک قرار دیا، تو انٹیگریشنز کو v4 پر منتقل ہونے کو کہا۔
WhatsApp Business ایپ اور Cloud API دونوں کے ساتھ استعمال ہونے والے نمبر کی پیغامات کی رفتار مقررہ ہے۔
Partner API کے ذریعے کسٹمر کا نمبر آن بورڈ کرتے وقت ہوسٹڈ connect لنک کی درستگی کی مدت۔
AI ایجنٹ کو WhatsApp سرکاری طور پر استعمال کرنے کے لیے کیا چاہیے؟
Meta کے Cloud API سے چار چیزیں درکار ہیں۔ ایک phone number ID اور ایک access ٹوکن جس کے پاس whatsapp_business_messaging کی اجازت ہو، تاکہ ایجنٹ messages endpoint کو کال کر سکے۔ ایک ویب ہک endpoint جہاں Meta آنے والے پیغامات بھیجے، اور اگر نمبر ایپ کے ساتھ مشترک ہو تو smb_message_echoes بھی، جو وہ جوابات ہیں جو کوئی شخص فون پر ٹائپ کرتا ہے۔ منظور شدہ ٹیمپلیٹس، کیونکہ ٹائپ کیا گیا میسج صرف اسی شخص تک پہنچتا ہے جس نے پچھلے 24 گھنٹوں میں لکھا ہو۔ اور یہ جاننے کا طریقہ کہ کنکشن کب ٹوٹتا ہے، کیونکہ فون پر ایپ چلتی رہتی ہے چاہے API کی طرف کام بند ہو جائے۔
وہ شارٹ کٹ جو لوگ سب سے پہلے ڈھونڈتے ہیں وہ WhatsApp Web آٹومیشن ہے، جو linked device کے طور پر سائن ان کرتی ہے۔ یہ WhatsApp کی شرائط توڑتا ہے اور نمبر کو بین کے خطرے میں ڈال دیتا ہے، چاہے اس کے اوپر ایجنٹ کچھ بھی کرے۔
Tech Provider راستے میں کیا شامل ہے؟
یہ Meta کا اپنا مرحلہ وار عمل ہے، اسی ترتیب میں۔ ہر قدم مفت ہے، اور کوئی قدم تیز تر خریدا نہیں جا سکتا: جائزے Meta کے شیڈول پر چلتے ہیں اور Meta کوئی ٹائم لائن شائع نہیں کرتا، اس لیے پہلے گاہک کا نمبر جڑنے سے پہلے ہفتوں کی منصوبہ بندی کریں، دنوں کی نہیں۔ اس کے بعد بیک اینڈ کو چلتے رہنا ہوتا ہے: ہر سائن اپ کے بعد ٹوکن کا تبادلہ، ایک ویب ہک ریسیور، ہر نمبر کی روٹنگ، اور ڈس کنیکشن پر نگرانی، جیسے Meta کا 14 دن کی غیر فعالیت کا اصول۔
چھوٹا راستہ کون سا ہے؟
نمبر کسی ایسے پرووائیڈر کے ذریعے جوڑیں جو یہ عمل پہلے ہی مکمل کر چکا ہو۔ easyCoexistence کے ساتھ کاروبار Meta کا Embedded Signup چلاتا ہے اور WhatsApp Business ایپ سے کوڈ اسکین کرتا ہے، جس میں تقریباً دو منٹ لگتے ہیں۔ نمبر کاروبار کے اپنے Business Portfolio میں Cloud API سے جڑ جاتا ہے اور ایپ چلتی رہتی ہے۔ اس کے بعد ایجنٹ اسی شکل میں رسائی حاصل کرتا ہے جو وہ سمجھتا ہے: ChatGPT، Claude، Claude Code یا Codex جیسے اسسٹنٹ کے لیے MCP ٹولز، یا اپنے چلائے گئے کوڈ کے لیے نمبر کی کریڈینشلز اور ویب ہکس۔
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
ایجنٹ نمبر کی کریڈینشلز کیسے حاصل کرتا ہے؟
get_api_credentials کے ذریعے، یا ڈیش بورڈ میں نمبر کے صفحے سے۔ ٹول Graph API بیس URL، WhatsApp Business Account ID، phone number ID، send endpoint اور، اگر موجود ہو، کاروبار کا اپنا access ٹوکن واپس کرتا ہے، جو اس کے WhatsApp اثاثوں تک محدود ہوتا ہے۔ اگر کوئی کلائنٹ ٹوکن جاری نہیں ہوا، تو ٹوکن null آتا ہے، ساتھ ایک نوٹ کہ ڈیش بورڈ سے نمبر دوبارہ جوڑنے پر ایک جاری ہو جائے گا، بغیر اس ٹوکن کو بدلے جو کام کر رہا ہو۔ کوئی app secret حاصل کرنے کی ضرورت نہیں، کیونکہ Meta ویب ہکس پر easyCoexistence کے app secret سے دستخط کرتا ہے، جو کبھی شیئر نہیں ہوتا۔ اس ٹول کے لیے فعال پلان درکار ہے، کیونکہ ٹوکن پیغام بھیج سکتا ہے۔
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "text",
"text": { "body": "Your order #1042 is ready for pickup." }
}'آنے والے پیغامات ایجنٹ تک کیسے پہنچتے ہیں؟
ہر نمبر کے دو موڈ ہیں، جو set_inbound_mode سے یا نمبر کے صفحے پر بدلے جاتے ہیں۔ براہ راست آپ کے سرور تک: set_webhook_destination Meta کو سیدھا آپ کے HTTPS endpoint پر بھیجتا ہے، جسے Meta کے GET ہینڈ شیک کا جواب دینا ہوتا ہے، اور easyCoexistence کبھی پیغامات نہیں دیکھتا، اس لیے آٹومیشنز بند ہوتی ہیں۔ چونکہ Meta ان ڈیلیوری پر ہمارے app secret سے دستخط کرتا ہے، URL کے راستے میں ایک لمبا بے ترتیب secret رکھیں اور اس کے بغیر آنے والی درخواستیں رد کریں۔
آٹومیشنز آن: Meta easyCoexistence کو ڈیلیور کرتا ہے، آٹومیشنز جواب دے سکتی ہیں، اور ایک اختیاری Forward URL، Meta کا اصل payload "value" کے تحت وصول کرتا ہے، جس پر X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>"> کے ساتھ دستخط ہوتے ہیں، اور secret ایک بار دکھایا جاتا ہے۔ آٹومیشن کا Call my webhook مرحلہ بھی پیغام اور چیٹ کے آخری 10 پیغامات آپ کے ایجنٹ کو دیتا ہے، اور اگر آپ کا جواب 20 سیکنڈ کے اندر {"reply": "..."} کی شکل میں ہو تو اس کا جواب بھیجتا ہے۔
ایجنٹ کو کن حدود کا احترام کرنا ہوگا؟
Meta کی حدود، اور یہ کسی بھی پرووائیڈر کے ذریعے ایک جیسی ہوتی ہیں۔ جو ایجنٹ انہیں پہلے سے جانتا ہے، وہ ان ناکامیوں سے بچتا ہے جو بگ جیسی لگتی ہیں:
- فی نمبر فی سیکنڈ 20 پیغامات، جو Meta نے WhatsApp Business ایپ کے ساتھ مشترک نمبروں کے لیے طے کی ہے۔
- ٹائپ کیے گئے میسجز صرف گاہک کے آخری میسج کے 24 گھنٹوں کے اندر؛ اس کے بعد منظور شدہ ٹیمپلیٹ۔
- ٹیمپلیٹس صرف API کے ذریعے بھیجی جاتی ہیں، کیونکہ Coexistence نمبر پر ایپ انہیں نہیں بھیج سکتی۔
- کوئی شخص ایپ میں جو جواب ٹائپ کرتا ہے وہ
smb_message_echoesکے طور پر آتا ہے؛ اس چیٹ پر ایجنٹ کو روک دیں، ورنہ گاہک کو دو جواب ملیں گے۔ - گروپ چیٹس API کے ساتھ ہم وقت نہیں ہوتیں، اس لیے ایجنٹ صرف ون ٹو ون چیٹس میں کام کرتا ہے۔
- رابطے اور زیادہ سے زیادہ 6 ماہ کی ون ٹو ون چیٹس ایک بار امپورٹ ہوتے ہیں، صرف اس صورت میں جب کنیکٹ ہونے کے 24 گھنٹوں کے اندر براہ راست ویب ہک ڈیسٹینیشن محفوظ ہو؛ جس نمبر پر آٹومیشنز آن ہوں اسے امپورٹ نہیں ملتا۔
- وائس اور ویڈیو کالز ایپ میں چلتی رہتی ہیں، مگر Coexistence نمبر پر Cloud API کالز نہیں لے جاتی، اس لیے ایجنٹ ٹیکسٹ میں کام کرتا ہے۔
کیا پلیٹ فارم اپنے گاہکوں کے نمبر اس طرح جوڑ سکتا ہے؟
ہاں، Partner API کے ذریعے، جو SaaS یا ایجنسی کو اپنا Tech Provider درجہ رکھے بغیر اپنے گاہک آن بورڈ کرنے دیتی ہے۔ create_api_key سے API key بنائیں (یہ ec_live_ سے شروع ہوتی ہے اور ایک بار دکھائی جاتی ہے)، پھر اپنے بیک اینڈ سے POST /api/v1/connect-sessions کو کال کریں، یا اسسٹنٹ سے create_connect_link استعمال کریں، تاکہ 1 گھنٹہ تک درست رہنے والا ہوسٹڈ لنک ملے۔ گاہک وہاں Meta کا پاپ اپ اور QR اسکین چلاتا ہے اور connection_id کے ساتھ آپ کے redirect_url پر واپس آتا ہے۔ اس کے بعد GET /api/v1/connections/:id?credentials=1 گاہک کا اپنا ٹوکن واپس کرتا ہے، اور connection.disconnected جیسے اسٹیٹس ایونٹس X-EC-Signature کے ساتھ دستخط شدہ آتے ہیں۔ ہر نمبر کا بل آپ کے اکاؤنٹ پر اسی فی نمبر بینڈ کے مطابق لگتا ہے۔
عام غلطیاں
- براہ راست منزل پر X-Hub-Signature-256 کی تصدیق کرنا۔ Meta easyCoexistence کے app secret سے دستخط کرتا ہے، جو کبھی شیئر نہیں ہوتا، اس لیے اصل ڈیلیوری بھی ناکام ہوتی ہے؛ URL میں ایک لمبے بے ترتیب secret پر بھروسہ کریں، یا X-EC-Signature کے ساتھ فارورڈنگ استعمال کریں۔
- n8n کے WhatsApp Trigger نوڈ سے وصول کرنا۔ وہ اپنی Meta ایپ چاہتا ہے؛ اس کے بجائے عام Webhook نوڈ استعمال کریں، جس کے URL میں secret ہو۔
- smb_message_echoes کو نظر انداز کرنا۔ تب ایجنٹ اس شخص کے اوپر جواب دیتا ہے جو فون سے پہلے ہی جواب دے چکا ہے، اور گاہک کو دو جواب ملتے ہیں۔
- براہ راست ویب ہک ڈیسٹینیشن کنیکشن کے کئی دن بعد محفوظ کرنا، یا نمبر کو آٹومیشنز پر چھوڑ دینا۔ Meta کا رابطوں اور 6 ماہ تک کی چیٹس کا ایک بار کا امپورٹ، کنیکشن کے 24 گھنٹوں کے اندر محفوظ شدہ براہ راست ڈیسٹینیشن مانگتا ہے۔
ایجنٹ 30 سے زائد MCP ٹولز کے ذریعے کام کرتا ہے، یا ہر نمبر کی کریڈینشلز اور ویب ہکس کے ذریعے، اور ہر نمبر 24/7 مانیٹر ہوتا ہے، ساتھ الرٹس کے۔ فی نمبر فی ماہ US$ 9 سے US$ 0.75 تک، جیسے جیسے آپ نمبر بڑھاتے ہیں قیمت کم ہوتی ہے، اور پہلے 3 دن مفت۔
اکثر پوچھے جانے والے سوالات
کیا مجھے اپنی Meta ایپ چاہیے؟
نہیں۔ نمبر easyCoexistence کی Meta ایپ کے ذریعے آن بورڈ ہوتا ہے اور کاروبار کے اپنے Business Portfolio اور WhatsApp Business Account میں رہتا ہے۔ آپ کا کوڈ get_api_credentials سے ملنے والے کاروبار کے اپنے ٹوکن سے بھیجتا ہے، اس لیے جب تک آپ بعد میں خود ایپ نہ بنائیں، آپ کی کوئی ایپ شامل نہیں۔
کیا ایجنٹ اور ٹیم ایک ساتھ نمبر استعمال کر سکتے ہیں؟
ہاں۔ Meta Cloud API اور WhatsApp Business ایپ کے درمیان پیغامات کا عکس بناتا ہے، اس لیے جو ایجنٹ بھیجتا ہے وہ فون پر ایپ کی چیٹ تھریڈ میں نظر آتا ہے، اور جو ٹیم ایپ میں ٹائپ کرتی ہے وہ smb_message_echoes کے طور پر آپ کے سسٹم تک پہنچتا ہے۔
کون سے ایجنٹ فریم ورکس اس کے ساتھ کام کرتے ہیں؟
ہر وہ کلائنٹ جو OAuth کے ساتھ HTTP پر MCP بولتا ہو، جیسے ChatGPT، Claude، Claude Code، Codex اور Cursor، اور ہر وہ کوڈ جو Meta کے Graph API کو کال کرے: Node.js، Python، n8n، LangChain، OpenAI Agents SDK یا Vercel AI SDK۔ اس کے نیچے API خود Meta کی ہے، اس لیے ایجنٹ کے اندر کچھ بھی ملکیتی نہیں ہے۔
کیا WhatsApp پر عام مقصد کا AI اسسٹنٹ جائز ہے؟
Meta کی Business Solution Terms کا سیکشن 4.7 ایسے پرووائیڈرز کو روکتا ہے جو عام مقصد کے AI اسسٹنٹ WhatsApp Business Platform پر پیش کریں، جہاں AI بنیادی فعالیت ہو، جیسا کہ Meta طے کرے، اور یہ 15 جنوری 2026 سے نافذ ہے۔ جو کاروبار اپنے گاہکوں کے لیے، سپورٹ، سیلز یا بکنگ کے لیے AI استعمال کرتا ہے، وہ اس کا ہدف نہیں، اور یورپی یونین اور برازیل کے ریگولیٹرز نے Meta کو حریف اسسٹنٹس کے لیے اس اصول کو معطل یا واپس لینے کا حکم دیا ہے۔
مزید پڑھیں
شروع کرنے کے لیے تیار ہیں؟
WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔
فری ٹرائل شروع کریںتصدیق شدہ تاریخ