الانتقال إلى المحتوى الرئيسي
نظرة عامة على جدولة الرسائل في GOWA يمكن جدولة أي طلب إرسال بدلاً من إرساله فوراً. إضافة scheduled_at و timezone؛ تقوم GOWA بتخزين الطلب ويقوم عامل خلفية بإرساله في ذلك الوقت. الجداول الزمنية تبقى على قيد الحياة لإعادة التشغيل وانتظر جهاز غير متصل. أنواع الرسائل القابلة للجدول: النصوص، الصورة، الملف، الفيديو، الصوت، الملصق، جهة الاتصال، الرابط، الموقع، الاستطلاع والمرسل (/message/{id}/forward). لا يمكن جدولة الحضور والمؤشرات المكتوبة والنقطة النهائية التجريبية /send/interactive.

جدولة الحقول

بدون scheduled_at، يُرسل الطلب فورًا كالمعتاد.

أمثلة

الردود المجدولة لها schedule_id بدلا من message_id.
تُحتفظ بالملفات المرفوعة على الخادم حتى انتهاء الجدول. في أجسام الطلبات متعددة الأجزاء، أرسل weekdays كحقول متكررة (-F weekdays=1 -F weekdays=3).

إدارة الجداول الزمنية

الجداول تنتمي إلى جهاز؛ أرسل نفس X-Device-Id.
ترجع القائمة results.data وresults.pagination (limit، الافتراضي 25؛ offset؛ total).

Statuses

سلوك التسليم

  • ويقوم العامل بالتحقق من الجداول الزمنية الواجبة كل 5 ثوان.
  • الجهاز غير متصل أو غير مسجل الدخول: التشغيل ينتظر و يعيد المحاولة كل 30 ثانية. الانتظار لا يعتبر محاولة فاشلة، لذا فإن الجدول ينجو من حالات انقطاع طويلة.
  • أخطاء الإرسال: تُعاد المحاولة بفترات انتظار متزايدة تبدأ من 15 ثانية ولا تتجاوز 5 دقائق، بحد أقصى 10 محاولات لكل موعد تنفيذ. ينتقل الجدول المتكرر بعد ذلك إلى موعده التالي؛ أما الجدول الذي يُنفَّذ مرة واحدة فتتغير حالته إلى failed.
  • طلب غير صالح (على سبيل المثال مستلم سيئ): فشل فورا دون إعادة المحاولة.
  • التشغيل المتأخر: لم يتم إرسال الحدث المتأخر الماضي end_at.
  • الأعطال وإعادة التشغيل: إيقاف التشغيل لا يؤدي إلى إجهاض إرسال بالفعل في الرحلة. قبل المحاولة الأولى، تحافظ GOWA على معرف رسالة WhatsApp للحدث. وبعد انتهاء مدة مطالبتها التي تبلغ دقيقتين، يتكرر حدوث توقف بذات الهوية ويحسب في ميزانية المحاولة. وتحتفظ استطلاعات الرأي أيضا بسرية التشفير عبر المحاولات. وهذا يحافظ على هوية الرسالة بعد إقرار غامض، ولكنه لا يضمن التسليم مرة واحدة تماما.
  • محاولات انقطاع قديمة: محاولات الإرث التي لم تعرف نتيجتها تحتفظ باستعادة محافظة. يتخطى العامل هذا الحدث لجدول زمني متكرر أو يفشل جدولاً لمرة واحدة بدلاً من تعيينه هوية رسالة جديدة.

أكثر من MCP

أداة MCP whatsapp_send تقبل نفس حقول الجدول، وقوائم whatsapp_schedule و تحصل على إيقاف مؤقت و تستأنف و تلغي الجداول. انظر MCP server.
تحقق من GET /app/info: results.scheduled_sends هو true عندما يقبل الخادم حقول الجدول ويكشف /send/schedules.