Claude Code یا Codex کے ساتھ WhatsApp بوٹ بنائیں، اسی نمبر پر جو آپ ایپ میں رکھتے ہیں
Claude Code یا Codex میں WhatsApp MCP سرور شامل کریں اور کوڈنگ ایجنٹ کو سیٹ اپ خود کرنے دیں۔ وہ نمبر کی Cloud API اسناد پڑھتا ہے، ویب ہک ریسیور کا ڈھانچہ بناتا ہے، آنے والے میسجز اسے بھیجتا ہے، اور آخری 24 گھنٹوں میں لکھنے والے کسی شخص کو ٹیسٹ جواب بھیجتا ہے۔ آپ کو جو ملتا ہے وہ آپ کا اپنا ایجنٹ ہے، جو آپ کے اپنے سرور پر آپ کے کوڈ کے طور پر چلتا ہے۔
easyCoexistence آپ کی ایپ میں رکھے ہوئے WhatsApp Business نمبر کو Coexistence کے ذریعے Meta کے Cloud API سے جوڑتا ہے اور Claude Code اور Codex کو بنانے کے لیے 30 سے زیادہ MCP ٹولز دیتا ہے: اسناد، روٹنگ، ٹیمپلیٹس، ٹیسٹ بھیجنا اور آٹومیشنز۔
Claude Code کا فلیگ جو ایک سرور کو آپ کے تمام پروجیکٹس میں لوڈ کرتا ہے؛ ڈیفالٹ لوکل اسکوپ اسے صرف وہیں لوڈ کرتا ہے جہاں اسے شامل کیا گیا تھا۔
Codex کی کمانڈ جو کسی سرور کا OAuth سائن ان محفوظ کرتی ہے؛ کسی اسناد کے بغیر Codex تصدیق کے بغیر کنیکٹ ہو سکتا ہے۔
براہ راست ویب ہک منزل کے لیے کیا استعمال ہونا چاہیے، اور اسے Meta کے GET ہینڈ شیک میں hub.challenge واپس بھیجنا ہوگا۔
ویب ہک کال کرنے والا مرحلہ آپ کے اینڈ پوائنٹ سے {"reply"} کا کتنی دیر انتظار کرتا ہے، اس کے بعد مرحلہ ناکام ہو جاتا ہے۔
صارف کے آخری میسج کے بعد کی کسٹمر سروس ونڈو؛ اس کے باہر Meta صرف ٹیمپلیٹ میسجز قبول کرتا ہے۔
ایسے نمبر کی مقررہ تھرو پٹ جو WhatsApp Business ایپ اور Cloud API دونوں کے ساتھ استعمال ہو۔
کوڈنگ ایجنٹ کو WhatsApp ایجنٹ بنانے کے لیے کیا چاہیے؟
چار چیزیں۔ ایک WhatsApp Business نمبر جو Coexistence کے ذریعے Meta کے Cloud API سے جڑا ہو، تاکہ ایپ فون پر رہے اور کوڈ میسج بھیج اور وصول کر سکے۔ Claude Code یا Codex سے اس نمبر تک ایک MCP کنکشن، جس سے کوڈنگ ایجنٹ ڈیش بورڈ کھولے بغیر اسناد پڑھ سکے، روٹنگ بدل سکے اور ٹیسٹ میسج بھیج سکے۔ ریسیور کے لیے ایک عوامی HTTPS پتہ، جو اس ہوسٹ سے آئے جہاں آپ ایجنٹ ڈیپلائے کرتے ہیں یا ڈیویلپمنٹ کے دوران ٹنل سے۔ اور اس ایجنٹ کے لیے ایک ماڈل کی، جو آپ بنا رہے ہیں۔
دونوں ایجنٹوں کو ذہن میں الگ رکھیں۔ Claude Code یا Codex بنانے والا ہے: یہ صرف اس وقت کام کرتا ہے جب آپ ٹرمینل میں اس کے ساتھ کام کر رہے ہوں۔ جو پروگرام یہ لکھتا ہے وہی کسٹمرز کو جواب دیتا ہے، اور سیشن بند کرنے کے بعد بھی چلتا رہتا ہے۔
Claude Code اور Codex میں WhatsApp ٹولز کیسے شامل کریں؟
ہر ایک ٹرمینل سے ایک URL لیتا ہے اور OAuth کے ذریعے سائن ان کرتا ہے، اس لیے کوئی کلید کسی فائل میں نہیں جاتی۔ Claude Code میں سرور کو --scope user کے ساتھ شامل کریں تاکہ وہ ہر پروجیکٹ میں لوڈ ہو، پھر claude شروع کریں، /mcp چلائیں، easycoexistence چنیں اور براؤزر میں سائن ان کریں۔ Codex میں سرور شامل کریں اور codex mcp login چلائیں، جو سائن ان محفوظ کرتا ہے؛ codex mcp list دکھاتا ہے کہ کیا ترتیب دیا گیا ہے۔ Codex یہ اندراج ~/.codex/config.toml میں رکھتا ہے، جسے ChatGPT ڈیسک ٹاپ ایپ اور Codex IDE ایکسٹینشن بھی پڑھتے ہیں۔
جانچیں کہ کام ہو گیا، ایسی چیز مانگ کر جس کا جواب صرف ٹولز دے سکیں، جیسے "میرے WhatsApp نمبرز کی فہرست دکھائیں"۔ ایجنٹ list_numbers کال کرتا ہے اور ہر نمبر کا connection_id لیتا ہے، جسے باقی ہر ٹول استعمال کرتا ہے۔
# Claude Code: then start claude and run /mcp to sign in
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp
# Codex: add, store the OAuth sign-in, check
codex mcp add easycoexistence --url https://easycoexistence.com/api/mcp
codex mcp login easycoexistence
codex mcp listایجنٹ کو کون سا راستہ بنانا چاہیے؟
تین راستے کسٹمر کا میسج آپ کے کوڈ تک لاتے ہیں، اور وہ اس میں فرق کرتے ہیں کہ کوڈ کو کتنا سنبھالنا پڑتا ہے۔ پہلے ورژن کے لیے ویب ہک کال کرنے والا مرحلہ سب سے مختصر ہے: easyCoexistence ڈپلیکیٹس چھوڑ دیتا ہے، جب آپ فون سے جواب دیں تو رک جاتا ہے، اور آپ کے اینڈ پوائنٹ کو کال کرنے سے پہلے 24 گھنٹے کی ونڈو چیک کرتا ہے، اس لیے آپ کا کوڈ صرف جواب لکھتا ہے۔ جب ایجنٹ کو صرف وہ میسجز نہیں بلکہ ہر ایونٹ چاہیے جو کوئی آٹومیشن چنتی ہے، تو فارورڈ URL یا براہ راست منزل پر جائیں۔
ایجنٹ سے کیا کرنے کو کہیں؟
شروع میں ہی اسے راستہ، زبان اور قواعد دیں، اور کوڈ لکھنے سے پہلے پلان مانگیں۔ بتائیں کہ وہ کون سی ٹول کالز خود کر سکتا ہے: اسناد اور دستاویزات پڑھنا نقصان دہ نہیں، جبکہ میسجز کہاں جاتے ہیں یہ بدلنا لائیو نمبر کو متاثر کرتا ہے۔ get_docs easyCoexistence کی دستاویزات واپس کرتا ہے، بشمول یہ کہ ریسیور ڈیلیوریز کی تصدیق کیسے کرتا ہے، تاکہ ایجنٹ قواعد کا اندازہ لگانے کے بجائے انہیں پڑھ سکے۔ ایسی درخواست سے ایسا ریسیور بنتا ہے جسے آپ ایک نشست میں جانچ سکیں:
Build a WhatsApp agent in Node.js for my number +55 11 4000 1234.
1. Call list_numbers, then get_api_credentials for that number.
Put send_endpoint and access_token in .env, never in code.
2. Scaffold an HTTPS server with POST /wa/<long random path>.
Verify X-EC-Signature (HMAC-SHA256 of "<t>.<raw body>").
Skip message ids already handled.
On smb_message_echoes, stay quiet on that chat for 4 hours.
3. Reply with my model only within 24 hours of the
customer's last message.
4. Write tests for the signature check and the 24-hour rule.
Do not call set_inbound_mode or set_webhook_destination
until I say so.ریسیور کو کیسے جوڑیں اور ٹیسٹ کیسے کریں؟
سرور کو ایسی جگہ شروع کریں جہاں Meta اور easyCoexistence HTTPS پر پہنچ سکیں، پھر ایجنٹ کو روٹنگ سیٹ کرنے دیں۔ فارورڈ URL راستے کے لیے، ایجنٹ آٹومیشنز میں ایک نمبر پر، Automations on موڈ میں، set_inbound_mode کو آپ کے URL کے ساتھ کال کرتا ہے؛ فارورڈ سیکرٹ ایک بار واپس آتا ہے، اور ایجنٹ اسے آپ کی .env فائل میں لکھ دیتا ہے۔ براہ راست راستے کے لیے، اینڈ پوائنٹ کو پہلے Meta کے GET ہینڈ شیک کا جواب دینا ہوگا، پھر ایجنٹ set_webhook_destination کو URL، اس کے پاتھ میں ایک لمبا رینڈم سیکرٹ اور آپ کا ویریفائی ٹوکن کے ساتھ کال کرتا ہے۔
ٹیسٹ کے لیے اپنے فون سے کاروباری نمبر پر میسج کریں اور لاگز دیکھیں: ریسیور ایونٹ دیکھے، ماڈل جواب دے، اور جواب چیٹ میں ظاہر ہو۔ چونکہ آپ نے ابھی لکھا ہے، 24 گھنٹے کی ونڈو کھلی ہے، اس لیے کوڈنگ ایجنٹ اپنے نمبر پر send_message بھی آزما سکتا ہے۔
کیا تیار ایجنٹ کو اب بھی MCP سرور چاہیے؟
نہیں۔ MCP سرور بنانے والے کا ٹول ہے، جو آپ کے نام سے سائن ان ہے۔ آپ جو ایجنٹ ڈیپلائے کرتے ہیں وہ Meta کے Graph API کے ذریعے بھیجتا ہے، اس send_endpoint اور access_token کے ساتھ جو get_api_credentials نے واپس کیے، یعنی کاروبار کا اپنا ٹوکن جو اس کے WhatsApp اثاثوں تک محدود ہے؛ اور وہ اسی راستے سے وصول کرتا ہے جو آپ نے سیٹ کیا۔ اگر access_token null آیا، تو ڈیش بورڈ سے نمبر دوبارہ کنکٹ کرنے پر ایک جاری ہو جاتا ہے، بغیر اس ٹوکن کو بدلے جو پہلے سے کام کر رہا ہو۔
MCP کنکشن کو ایجنٹ کے اردگرد کے کام کے لیے رکھیں: create_template سے ٹیمپلیٹس بنانا، کچھ غلط لگے تو get_number_health چیک کرنا، اور کسی بھی آٹومیشن کا رن لاگ پڑھنا جو میسجز آپ کے کوڈ کو دیتی ہے۔
اسے کیسے سیٹ اپ کریں
- Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
- Add the server to your coding agentRun the claude mcp add or codex mcp add command, then sign in with /mcp in Claude Code or codex mcp login in Codex.
- Ask for credentials and a planHave the agent call list_numbers and get_api_credentials, store the values in .env and propose the receiver before writing it.
- Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
- Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
- Test from your phoneSend the business number a message and check that your agent's reply arrives in the same chat.
عام غلطیاں
- پہلے 24 گھنٹوں میں ایک عارضی ٹنل کو براہ راست منزل کے طور پر محفوظ کرنا۔ Meta کا ایک بار کا امپورٹ، جو رابطوں اور 6 مہینے تک کی چیٹس پر مشتمل ہے، اسی URL پر جاتا ہے اور ٹنل بند ہوتے ہی کھو جاتا ہے۔
- ایسے نمبر پر براہ راست منزل سیٹ کرنا جس پر آٹومیشنز چلتی ہوں۔ نمبر براہ راست پر چلا جاتا ہے اور اس کی آٹومیشنز رک جاتی ہیں؛ دونوں کو چلانے کے لیے Automations on موڈ میں فارورڈ URL استعمال کریں۔
- ایجنٹ کا لکھا ہوا .env کمٹ کرنا۔ پہلے اسے .gitignore میں شامل کریں، کیونکہ جس کے پاس ایکسیس ٹوکن ہے وہ کاروبار کے طور پر کسٹمرز کو میسج کر سکتا ہے۔
- ایسے رابطے پر send_message ٹیسٹ کرنا جس نے 24 گھنٹوں میں نہیں لکھا۔ Meta ونڈو کے باہر آزاد متن سے انکار کرتا ہے، اس لیے پہلے اپنے فون سے نمبر پر میسج کریں۔
آپ کا ایجنٹ پھر آپ کے اپنے سرور پر چلتا ہے، اور ہر نمبر 24/7 مانیٹر ہوتا ہے، الرٹس کے ساتھ۔ فی نمبر فی مہینہ US$ 9 سے US$ 0.75 تک، نمبرز بڑھانے کے ساتھ قیمت کم ہوتی ہے، پہلے 3 دن فری ٹرائل۔
اکثر پوچھے جانے والے سوالات
کیا یہ Cursor یا دوسرے کوڈنگ ٹولز میں کام کرتا ہے؟
ہاں۔ کوئی بھی MCP کلائنٹ جو Streamable HTTP پر OAuth کے ساتھ ریموٹ سرورز سے جڑتا ہے، وہی URL استعمال کر سکتا ہے، جن میں Cursor، VS Code، Gemini CLI اور Antigravity شامل ہیں۔ ہر کلائنٹ کے لیے صرف ترتیب کا فارمیٹ بدلتا ہے۔
ایجنٹ کون سی زبان میں لکھنا چاہیے؟
کوئی بھی زبان جو HTTPS سرو کر سکے اور HMAC-SHA256 حساب کر سکے۔ Node.js اور Python عام انتخاب ہیں، اور دونوں کے جانچے ہوئے نمونے، دستخط کی جانچ، ڈپلیکیٹ ہینڈلنگ اور فون کے وقفے کے ساتھ، Node.js اور Python ایجنٹ کے صفحے پر موجود ہیں۔
کیا مجھے اپنی Meta ایپ یا App Review کی ضرورت ہے؟
نہیں۔ نمبر easyCoexistence کی Meta ایپ کے ذریعے Cloud API سے جڑتا ہے اور کاروبار کے اپنے Business Portfolio میں رہتا ہے۔ آپ کا کوڈ جو ٹوکن استعمال کرتا ہے وہ کاروبار کا اپنا ہے، اس لیے آپ کی کوئی Meta ایپ شامل نہیں ہوتی۔
کیا کوڈنگ ایجنٹ وہ ٹیمپلیٹس بنا سکتا ہے جو ایجنٹ کو درکار ہیں؟
ہاں، create_template سے، پھر get_template_status تک، جب تک Meta جواب دے، عموماً چند منٹوں میں اور زیادہ سے زیادہ تقریباً 24 گھنٹوں میں۔ آپ کے ایجنٹ کو گفتگو شروع کرنے یا 24 گھنٹے کی ونڈو بند ہونے کے بعد لکھنے کے لیے ایک منظور شدہ ٹیمپلیٹ چاہیے۔
مزید پڑھیں
شروع کرنے کے لیے تیار ہیں؟
WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔
فری ٹرائل شروع کریںتصدیق شدہ تاریخ