حساب و یکپارچه‌سازی‌ها
اتصال یک سامانه خارجی یا دستیار
در Pro یا Agency یک کلید با دسترسی محدود بسازید، محتوای تازه منتشر کنید یا یک دستیار متصل کنید.
پیش از شروع
webhook اعلان پیام‌های ورودی را از سرویس واتساپ دریافت می‌کند. تنظیم سرور آن بر عهده مسئول یکپارچه‌سازی است. کاربران پنل نیازی به تغییر تنظیمات سرور ندارند. MCP به دستیار اجازه درخواست ابزارهای حساب را می‌دهد.
مراحل انجام کار
- برای پیام‌های ورودی، «تنظیمات» را باز کنید و «نشانی Webhook» را پیدا کنید.
- برای دریافت نشانی دقیق استقرار حساب خود، «کپی» را انتخاب کنید.
- از مسئول بخواهید رویدادهای ورودی دستگاه موردنظر را با آن نشانی تنظیم کند.
- پس از تأیید آمادگی توسط مسئول، دریافت پیام آزمایشی از شماره خود را هماهنگ کنید.
- نتیجه مورد انتظار، مانند پاسخ خودکار مطابق یا پیام گروه تازه ثبت‌شده هنگام فعال‌بودن «گزارش»، را بررسی کنید.
- برای اتصال دستیار، از صفحه مجوزی که برنامه MCP شما باز می‌کند وارد شوید.
- پیش از تأیید دسترسی، برنامه نام‌برده و حساب را بررسی کنید.
- برای یکپارچه‌سازی ارسال، تنظیمات ← یکپارچه‌سازی‌های خارجی را باز کنید. برای یک حساب متصل و گروه‌هایی که مشخصاً انتخاب کرده‌اید، کلیدی با نام بسازید. کلید را فوراً ذخیره کنید؛ فقط یک بار نمایش داده می‌شود. نشانی پایه API را کپی کنید.
- مثال: Abacus.AI را تنظیم کنید تا در هر یک از هشت زمان انتشار روزانه در America/Sao_Paulo محتوای تازه تولید کند. هر انتشار را با یک Idempotency-Key جدید به سه گروه مجاز ارسال کنید. فقط برای تکرار دقیق همان درخواست از کلید دوباره استفاده کنید.
- برای ورود فوری به صف، scheduled_at را حذف کنید، یا یک زمان مطلق با -03:00 یا Z (UTC) تا 30 روز آینده وارد کنید. پردازشگر هر دقیقه بررسی می‌کند؛ 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 نویسه پشتیبانی می‌کند. JPEG، PNG یا WebP تا 5 MiB را در فیلدهای multipart به نام payload و image بارگذاری کنید. نشانی‌های URL تصاویر راه دور پذیرفته نمی‌شوند.
- کار جدید HTTP 202 برمی‌گرداند. تکرار درخواست یکسان با همان Idempotency-Key، کار اصلی را با HTTP 200 برمی‌گرداند؛ محتوای متفاوت با همان کلید، 409 برمی‌گرداند. پایان مهلت پس از ارسال ممکن است نتیجه‌ای تأییدنشده داشته باشد؛ با کلید دیگری به‌طور خودکار دوباره ارسال نکنید.
مشکل‌های رایج
- آنچه می‌بینید
- پس از آزمایش، جواب یا سابقه جدیدی ظاهر نمی‌شود.
- کاری که باید انجام دهید
- اتصال دستگاه و قانون مربوط یا تنظیم «گزارش» را بررسی کنید، سپس از مسئول بخواهید تنظیم رویداد ورودی را بررسی کند.
- نتیجه مورد انتظار
- قابلیت درست تنظیم‌شده می‌تواند رویداد مطابق جدید را پردازش کند.
- آنچه می‌بینید
- دستیار مجوز نمی‌گیرد یا حساب دیگری نشان می‌دهد.
- کاری که باید انجام دهید
- به ورود برگردید و حساب موردنظر را انتخاب کنید؛ خطاهای تکراری مجوز را به مسئول گزارش دهید.
- نتیجه مورد انتظار
- صفحه مجوز و سوابق برگشتی متعلق به حساب موردنظر هستند.
دریافت راهنمایی بیشتر
قابلیت و خطای قابل‌مشاهده را به مسئول بگویید. اطلاعات ورود سرور را در گفت‌وگوهای دستیار نگذارید.