الحساب والتكاملات

ربط نظام خارجي أو مساعد

أنشئ مفتاحًا محدود الصلاحيات على Pro أو Agency، وانشر محتوى حديثًا أو اربط مساعدًا.

قبل البدء

يتلقى webhook إشعارات الرسائل الواردة من خدمة WhatsApp. إعداد الخادم من مسؤولية مشغّل التكامل. لا يحتاج مستخدمو اللوحة إلى تغيير إعدادات الخادم. يتيح MCP للمساعد طلب أدوات الحساب.

ما عليك فعله

للرسائل الواردة، افتح الإعدادات وابحث عن عنوان URL للـWebhook.
اختر نسخ للحصول على عنوان تثبيت حسابك الدقيق.
اطلب من المسؤول ضبط الأحداث الواردة للجهاز المطلوب باستخدام ذلك العنوان.
رتّب رسالة تجريبية واردة من رقمك بعدما يؤكد المسؤول الجاهزية.
تحقق من النتيجة المتوقعة، مثل رد تلقائي مطابق أو رسالة مجموعة جديدة مسجلة عند تفعيل السجل.
لتوصيل مساعد، ادخل عبر شاشة التفويض التي يفتحها برنامج MCP.
راجع اسم التطبيق والحساب قبل الموافقة على الوصول.
لتكامل الإرسال، افتح الإعدادات ← التكاملات الخارجية. أنشئ مفتاحًا باسم لحساب متصل واحد ومجموعات محددة صراحةً. احفظ المفتاح فورًا؛ فهو يظهر مرة واحدة فقط. انسخ عنوان URL الأساسي لواجهة 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. قد تصبح النتيجة غير مؤكدة عند انتهاء المهلة بعد بدء الإرسال؛ لا تُعد الإرسال تلقائيًا بمفتاح آخر.

مشكلات شائعة

ما تراه: لا يظهر رد أو سجل جديد بعد الاختبار.
ما عليك فعله: راجع اتصال الجهاز والقاعدة أو إعداد السجل المعني، ثم اطلب من المسؤول مراجعة إعداد الأحداث الواردة.
ما تتوقعه: تستطيع ميزة مضبوطة بشكل صحيح معالجة حدث مطابق جديد.

ما تراه: لا يستطيع المساعد التفويض أو يعرض حسابًا آخر.
ما عليك فعله: عد إلى الدخول واختر الحساب المقصود؛ أبلغ المسؤول بأخطاء التفويض المتكررة.
ما تتوقعه: تخص شاشة التفويض والسجلات المسترجعة الحساب المقصود.

مساعدة إضافية

أعطِ المسؤول الميزة والخطأ الظاهر. لا تشارك بيانات دخول الخادم في محادثات المساعد.

فتح هذه الميزة