MCP ٹولز کا حوالہ
یہ کنیکٹر اکاؤنٹ کے ہر کنکشن پر 30 سے زیادہ ٹولز فراہم کرتا ہے۔ WhatsApp کے لیے list_numbers پہلے آتا ہے، جس کے ٹولز اس سے ملنے والا connection_id لیتے ہیں، اور دوسرے چینلز کے لیے list_social_accounts، جن کے ٹولز account_id لیتے ہیں۔ بلنگ رکنے پر چھ ٹولز محدود ہو جاتے ہیں: بیرونی دنیا میں کارروائی کرنے والے WhatsApp کے چار ٹولز، access token واپس کرنے والا get_api_credentials اور create_connect_link۔ باقی دستیاب رہتے ہیں۔
کنیکٹر کے فراہم کردہ ٹولز۔
بلنگ رکنے پر محدود ہونے والے ٹولز، بشمول get_api_credentials جو access token واپس کرتا ہے۔
OAuth سائن اِن، اکاؤنٹ کے ہر نمبر کے لیے۔
ہر ٹول کیا کرتا ہے؟
پڑھنا: list_numbers منسلک نمبرز کے ساتھ اسٹیٹس، کوالٹی ریٹنگ اور میسجنگ ٹئیر واپس کرتا ہے، اور ہر دوسری کال یہیں سے شروع ہوتی ہے۔ get_number_health لائیو Meta snapshot کے ساتھ حالیہ مانیٹرنگ ٹائم لائن، ویب ہک ایونٹس اور پولر چیکس ایک ساتھ واپس کرتا ہے۔ get_api_credentials Graph API کا بنیادی URL، WABA id، phone number id اور، جہاں دستیاب ہو، اکاؤنٹ کا اپنا access token واپس کرتا ہے۔
بھیجنا: send_message، 24 گھنٹے کی ونڈو کے اندر آزاد متن بھیجتا ہے، جہاں جوابات مفت ہوتے ہیں۔ send_template منظور شدہ ٹیمپلیٹ بھیجتا ہے، اور اسی طرح اس شخص کے ساتھ گفتگو شروع ہوتی ہے جس نے ابھی کچھ نہیں لکھا۔ list_templates، create_template اور get_template_status ٹیمپلیٹ لائف سائیکل کا احاطہ کرتے ہیں۔
کنکشن: set_webhook_destination آنے والے میسجز اور ایپ ایکوز کو آپ کے سسٹم تک پہنچاتا ہے، جبکہ null دینے سے یہ دوبارہ پہلے جیسا ہو جاتا ہے۔ get_connect_link نیا نمبر جوڑنے کے لیے ڈیش بورڈ لنک اور مراحل واپس کرتا ہے۔ get_docs پروڈکٹ کی دستاویزات markdown میں واپس کرتا ہے۔
Partner API، ان سافٹ ویئر یا ایجنسیوں کے لیے جن کے اپنے کسٹمرز نمبر جوڑتے ہیں: get_partner_setup بلنگ، API key، events URL اور اگلا قدم دکھاتا ہے۔ create_api_key ایک Partner API key جاری کرتا ہے اور اسے صرف ایک بار دکھاتا ہے، اور واضح تصدیق کے بغیر موجودہ key کو تبدیل نہیں کرتا۔ revoke_api_key اسے منسوخ کرتا ہے، یہ بھی تصدیق کے بعد۔ set_partner_events_url طے کرتا ہے کہ status events کہاں جائیں اور signing secret ایک بار واپس کرتا ہے۔ create_connect_link ایک کسٹمر کے لیے 1 گھنٹے تک کارآمد hosted connect لنک بناتا ہے، بالکل POST /api/v1/connect-sessions کی طرح۔
connection_id کیوں اہم ہے؟
کیونکہ یہی کسی ہدایت کو مخصوص نمبر سے جوڑتا ہے، اور اسسٹنٹ اسے اندازے سے معلوم نہیں کر سکتا۔
نمبر پر کارروائی کرنے والا ہر ٹول connection_id لیتا ہے، اور یہ صرف list_numbers سے ملتا ہے۔ عملی طور پر اس کا مطلب ہے کہ میسج بھیجنے کو کہا جائے تو اسسٹنٹ پہلے list_numbers چلائے گا، اسی لیے سیشن کی پہلی درخواست اکثر باقی درخواستوں سے سست ہوتی ہے۔
اس کا یہ مطلب بھی ہے کہ کئی نمبرز والے اکاؤنٹ میں انتخاب شروع ہی سے واضح رہتا ہے۔ کوئی ڈیفالٹ نمبر یا خودکار انتخاب نہیں ہوتا، اس لیے جو ہدایت یہ نہ بتائے کہ کس نمبر کی بات ہو رہی ہے، اس پر سوال کیا جاتا ہے، اندازہ نہیں لگایا جاتا۔
بلنگ رکنے پر کیا ہوتا ہے؟
چھ ٹولز محدود ہو جاتے ہیں: بیرونی دنیا میں کارروائی کرنے والے send_message، send_template، create_template اور set_webhook_destination؛ get_api_credentials، کیونکہ یہ اکاؤنٹ کا access token واپس کرتا ہے جس سے محدود اکاؤنٹ براہ راست Graph API کے ذریعے بھیج سکتا؛ اور نیا نمبر جوڑنے والا create_connect_link۔ باقی تمام پڑھنے والے ٹولز دستیاب رہتے ہیں، اور Partner API سیٹ اپ بھی: get_partner_setup، create_api_key، revoke_api_key اور set_partner_events_url۔
یہ جان بوجھ کر ایسا رکھا گیا ہے، کوئی بھول نہیں۔ جو اکاؤنٹ یہ نہ دیکھ سکے کہ وہ کیوں محدود ہے یا اس کے نمبرز درست حالت میں ہیں یا نہیں، اس کے پاس سپورٹ ٹکٹ کے سوا واپسی کا راستہ نہیں رہتا۔ یہی پڑھنے والے ٹولز ہیلتھ مانیٹرنگ کے لیے بھی ضروری ہیں، اس لیے انہیں محدود کرنے سے مانیٹرنگ عین اس وقت بند ہو جاتی جب اس کی سب سے زیادہ ضرورت ہو۔
عملی نتیجہ یہ ہے کہ بلنگ رکے ہوئے اکاؤنٹ کی اپنی حالت سے متعلق سوالات کے جواب ملتے رہتے ہیں اور اس کی مانیٹرنگ بھی جاری رہتی ہے۔ صرف وہ کام رک جاتا ہے جو کسی صارف تک پہنچتا ہے۔
عام غلطیاں
- کنیکٹر سے میسجز وصول ہونے کی توقع رکھنا۔ MCP درخواست اور جواب پر مبنی ہے؛ آنے والی ٹریفک کے لیے ویب ہک درکار ہے۔
- connection_id کو ہارڈ کوڈ کرنا۔ یہ list_numbers سے ملتا ہے اور لکھ کر رکھنے والی قدر نہیں ہے۔
- یہ سمجھنا کہ بلنگ رکنے والا اکاؤنٹ مکمل طور پر آف لائن ہے۔ پڑھنا اور مانیٹرنگ جان بوجھ کر جاری رہتے ہیں، سوائے credentials کے، جن میں بھیجنے والا access token ہوتا ہے۔
ایک کنیکٹر اکاؤنٹ کے ہر نمبر کا احاطہ کرتا ہے، OAuth کے ذریعے اجازت ملتی ہے اور کوئی key پیسٹ نہیں کرنی پڑتی۔ فی نمبر ماہانہ US$ 9 سے شروع، نمبر بڑھنے کے ساتھ US$ 0.75 تک کم، اور پہلے 3 دن مفت۔
اکثر پوچھے جانے والے سوالات
کیا مجھے خود طے کرنا ہوتا ہے کہ کون سا ٹول چلانا ہے؟
نہیں۔ آپ عام زبان میں کہیں، اسسٹنٹ خود انتخاب کرتا ہے، اور ٹول کی تفصیلات اسی مقصد کے لیے لکھی گئی ہیں۔
کیا یہ میری گفتگو پڑھ سکتا ہے؟
نہیں۔ آنے والے میسجز آپ کے منتخب کردہ ویب ہک ڈیسٹینیشن تک پہنچتے ہیں۔ کنیکٹر اکاؤنٹ اور نمبر کی حالت پڑھتا ہے۔
کیا get_docs واقعی مفید ہے؟
جتنی بات لگتی ہے، اس سے زیادہ۔ یہ اسسٹنٹ کو ہماری دستاویزات markdown میں دیتا ہے، اس لیے Coexistence کے قواعد سے متعلق جوابات یادداشت کے بجائے ہماری دستاویزات سے آتے ہیں۔
کیا ایک کنیکٹر کئی کلائنٹس کا احاطہ کرتا ہے؟
ہاں۔ ایک اکاؤنٹ میں جتنے نمبرز چاہیں رکھ سکتے ہیں، اور list_numbers ان سب کو واپس کرتا ہے۔
مزید پڑھیں
شروع کرنے کے لیے تیار ہیں؟
WhatsApp Coexistence چند منٹ میں سیٹ اپ کریں، مہینوں میں نہیں۔ ایپ فون پر کام کرتی رہتی ہے۔
فری ٹرائل شروع کریںتصدیق شدہ تاریخ