اکاؤنٹ اور انضمام
بیرونی نظام یا معاون منسلک کریں
Pro یا Agency پر محدود اختیارات کی کلید بنائیں، تازہ مواد شائع کریں یا معاون منسلک کریں۔
شروع کرنے سے پہلے
ویب ہک WhatsApp سروس سے آنے والے پیغامات کی اطلاعات لیتا ہے۔ سرور کی ترتیب انضمام کے ذمہ دار کا کام ہے۔ پینل صارف کو سرور کی ترتیبات بدلنے کی ضرورت نہیں۔ MCP معاون کو اکاؤنٹ ٹولز کی درخواست کرنے دیتا ہے۔
کیا کرنا ہے
- آنے والے پیغامات کے لیے ترتیبات کھولیں اور Webhook URL تلاش کریں۔
- اپنے اکاؤنٹ کی تنصیب کا عین پتہ حاصل کرنے کے لیے کاپی کریں چنیں۔
- ذمہ دار سے اس پتے پر مطلوبہ ڈیوائس کے آنے والے واقعات ترتیب دینے کو کہیں۔
- ذمہ دار کی تیاری کی تصدیق کے بعد اپنے نمبر سے آنے والا آزمائشی پیغام طے کریں۔
- مطلوبہ نتیجہ دیکھیں، مثلاً متعلقہ خودکار جواب یا لاگ فعال ہونے پر نیا ریکارڈ شدہ گروپ پیغام۔
- معاون منسلک کرنے کے لیے MCP ایپ کی کھولی گئی اجازت اسکرین سے سائن اِن کریں۔
- رسائی منظور کرنے سے پہلے ایپ کا نام اور اکاؤنٹ دیکھیں۔
- بھیجنے کے انضمام کے لیے ترتیبات ← بیرونی انضمام کھولیں۔ ایک منسلک اکاؤنٹ اور واضح طور پر منتخب گروپس کے لیے نام والی کلید بنائیں۔ کلید فوراً محفوظ کریں؛ یہ صرف ایک بار دکھائی جاتی ہے۔ API کا بنیادی URL کاپی کریں۔
- مثال: Abacus.AI کو America/Sao_Paulo میں روزانہ اشاعت کے آٹھ اوقات میں سے ہر وقت تازہ مواد تیار کرنے کے لیے ترتیب دیں۔ ہر اشاعت تین اجازت یافتہ گروپس میں نئے Idempotency-Key کے ساتھ بھیجیں۔ اسی درخواست کو بالکل یکساں دہرانے کے لیے ہی کلید دوبارہ استعمال کریں۔
- فوراً قطار میں شامل کرنے کے لیے scheduled_at چھوڑ دیں، یا اگلے 30 دن تک کا مطلق وقت -03:00 یا Z (UTC) کے ساتھ دیں۔ پروسیسر ہر منٹ جانچ کرتا ہے؛ scheduled_at سب سے پہلا اہل وقت ہے، عین اسی سیکنڈ ترسیل کی ضمانت نہیں۔
- دوبارہ کوشش سے پہلے کام کی حالت اور ہر گروپ کا نتیجہ دیکھیں۔ صرف وہ ارسال منسوخ کریں جو ابھی روانہ نہیں ہوئے۔ افشا شدہ کلید ترتیبات میں منسوخ کریں، پھر متبادل بنا کر محفوظ کریں؛ پرانے کام نئی کلید کے ساتھ دوبارہ شروع نہیں ہوتے۔
عملی مثال
نمونہ جگہ دار قدروں والی درخواستیں؛ بھیجنے سے پہلے شناختیں بدلیں اور مستقبل کی تاریخ منتخب کریں۔ یہ درخواستیں حقیقی پیغامات شائع کرتی ہیں۔ curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'
کامیابی کیسے جانچیں
کام کی قبولیت اور گروپس کے قبول شدہ نتائج گیٹ وے کی قبولیت کی تصدیق کرتے ہیں۔ یہ ترسیل یا پڑھنے کی تصدیق نہیں کرتے۔ رسائی، کلید، اکاؤنٹ یا گروپس کی اجازتیں بدلنے پر طے شدہ کام رک سکتا ہے۔
کیا جاننا ضروری ہے
- معاون دستیاب ریکارڈ پڑھ سکتے اور درخواست پر متن بھیج سکتے ہیں۔ ترسیل مانگنے سے پہلے معاون ٹولز کا رہنما دیکھیں۔
- MCP سے غیر دستیاب ترمیم کے لیے پینل استعمال کریں۔
- API تک رسائی Pro اور Agency کے ماہانہ یا سالانہ منصوبوں میں شامل ہے۔ Starter کے لیے اپ گریڈ ضروری ہے۔ کلیدیں صرف منتخب اکاؤنٹ اور گروپس کی اجازت دیتی ہیں؛ WhatsApp اکاؤنٹ بدلنے سے ارسال رک جاتا ہے۔ سرور کی اسناد کبھی شیئر نہ کریں۔
- متن میں 4,096 حروف اور کیپشن میں 1,024 حروف کی گنجائش ہے۔ 5 MiB تک کی JPEG، PNG یا WebP فائل multipart کے payload اور image فیلڈز میں اپ لوڈ کریں۔ دور دراز تصاویر کے URLs قبول نہیں کیے جاتے۔
- نیا کام HTTP 202 لوٹاتا ہے۔ اسی Idempotency-Key کے ساتھ یکساں درخواست دہرانے پر اصل کام HTTP 200 کے ساتھ ملتا ہے؛ اسی کلید کے ساتھ مختلف مواد 409 لوٹاتا ہے۔ روانگی کے بعد وقت ختم ہونے پر نتیجہ غیر مصدقہ ہو سکتا ہے؛ دوسری کلید سے خودکار طور پر دوبارہ نہ بھیجیں۔
عام مسائل
- آپ کو کیا نظر آتا ہے
- آزمائش کے بعد جواب یا نیا ریکارڈ نہیں آتا۔
- کیا کرنا ہے
- ڈیوائس کا رابطہ اور متعلقہ اصول یا لاگ ترتیب دیکھیں، پھر ذمہ دار سے آنے والے واقعات کی ترتیب جانچنے کو کہیں۔
- کیا توقع رکھیں
- درست ترتیب والی سہولت نئے متعلقہ واقعے پر کارروائی کر سکتی ہے۔
- آپ کو کیا نظر آتا ہے
- معاون اجازت نہیں لے سکتا یا دوسرا اکاؤنٹ دکھاتا ہے۔
- کیا کرنا ہے
- سائن اِن پر واپس جاکر مطلوبہ اکاؤنٹ چنیں؛ بار بار اجازت کی خرابی ذمہ دار کو بتائیں۔
- کیا توقع رکھیں
- اجازت کی اسکرین اور واپس آنے والے ریکارڈ مطلوبہ اکاؤنٹ کے ہیں۔
مزید مدد حاصل کریں
ذمہ دار کو سہولت اور نظر آنے والی خرابی بتائیں۔ معاون کی گفتگو میں سرور کی اسناد شامل نہ کریں۔