WhatsApp

يوصّل GetMyBot قناة WhatsApp عبر WhatsApp Cloud API (Meta Graph API). بعد التوصيل يستقبل البوت الرسائل الواردة من WhatsApp ويطبّق عليها تفاعلاتك، ويمكن للمشغّلين إدارة المراسلة في الحوارات. النظرة العامة على تعدد القنوات في صفحة القنوات.

توصيل قناة WhatsApp

يتطلب التوصيل خمسة بيانات من تطبيق Meta الخاص بك (WhatsApp Cloud API). كلها إلزامية:

  • Phone number ID — معرّف رقم WhatsApp Business.
  • WABA ID — معرّف WhatsApp Business Account.
  • Access token — رمز وصول تطبيق Meta.
  • Verify token — سلسلة اختيارية تحدّدها بنفسك. تُستخدم عند التحقق من webhook في Meta (انظر أدناه).
  • App secret — سر تطبيق Meta. يلزم للتحقق من توقيع HMAC للـ webhooks الواردة (الترويسة X-Hub-Signature-256).

الخطوات في الواجهة:

  1. افتح البوتات ← «إضافة قناة» ← WhatsApp.
  2. املأ الحقول الخمسة أعلاه، وإن رغبت اسم القناة (اختياري).
  3. اضغط «تحقق» — يتحقق GetMyBot من البيانات عبر Meta.
  4. اضغط «توصيل».

إعداد webhook في Meta

بعد التوصيل يظهر للقناة Callback URL بالصيغة {العنوان}/ch/{channelID} (في الواجهة — أيقونة webhook 🔗). أدخله مع Verify token الخاص بك في تطبيق Meta: WhatsApp → Configuration → Webhook.

كيف يعمل ذلك:

  1. ترسل Meta إلى Callback URL طلب تحقق وتقارن verify_token المُمرَّر بـVerify token لديك. عند التطابق يُعتبر الـ webhook مؤكداً.
  2. بعد ذلك ترسل Meta إلى هذا العنوان الأحداث (الرسائل الواردة، وحالات التسليم، وأحكام الإشراف على القوالب).
  3. كل طلب وارد موقّع بالترويسة X-Hub-Signature-256؛ يتحقق GetMyBot من التوقيع باستخدام App secret — لذلك يُطلب هذا البيان عند التوصيل.

نافذة الجلسة مدتها 24 ساعة

يقيّد WhatsApp المراسلة المبادِرة: الرسائل الحرة لا يمكن إرسالها إلى المستخدم إلا خلال 24 ساعة من آخر رسالة واردة منه. كل رسالة واردة جديدة من المستخدم تُحدّث النافذة.

خارج نافذة الـ24 ساعة لا يمكن إرسال رسالة حرة — والطريقة الوحيدة لمعاودة الكتابة للمستخدم (re-engage) هي قالب رسالة معتمد. لذلك تُعد القوالب الأداة الأساسية للبث والتذكيرات في WhatsApp.

قوالب الرسائل

القالب (message template) رسالة متفق عليها مسبقاً مع Meta ويمكن إرسالها خارج نافذة الجلسة. تُدار القوالب من واجهة GetMyBot.

أين تُدار القوالب

البوتات ← عند قناة WhatsApp أيقونة «قوالب الرسائل» (📄) ← حوار «قوالب قناة WhatsApp». في الحوار أزرار:

  • «إنشاء قالب» — تجميع قالب جديد.
  • «مزامنة» — سحب كتالوج القوالب من Meta (تحديث الحالات والقائمة).

فئات القوالب

  • MARKETING (تسويق) — عروض وإعلانات وبث.
  • UTILITY (خدمي) — إشعارات بناءً على إجراءات المستخدم (حالات الطلبات، التذكيرات).
  • AUTHENTICATION (مصادقة) — رموز التأكيد.

حقول القالب

  • الاسم — أحرف لاتينية صغيرة وأرقام و_، حتى 512 حرفاً.
  • اللغة — لغة Meta.
  • الفئة — إحدى الفئات الثلاث أعلاه.

لفئتَي التسويق والخدمي إضافةً إلى ذلك:

  • الرأس — لا شيء / نص / صورة / فيديو / مستند. لرأس الوسائط يُرفع ملف مثال.
  • الجسم — إلزامي، حتى 1024 حرفاً. تُشار المتغيرات بـ{{1}} و{{2}} … بالترتيب الصارم من 1 إلى N دون تخطٍّ.
  • التذييل — حتى 60 حرفاً.
  • الأزرار — حتى 10: رد سريع، ورابط (حتى 2)، وهاتف (1)، ونسخ رمز (1).
  • لكل متغير {{n}} يجب تحديد قيمة مثال — وهو شرط Meta للإشراف.

لفئة المصادقة يكون الجسم ثابتاً من Meta نفسها؛ ويُضبط: مدة صلاحية الرمز (1–90 دقيقة)، وتوصية أمنية، ونص زر نسخ الرمز.

الإشراف

يرسل زر «إنشاء» القالب فوراً إلى إشراف Meta — لا توجد خطوة منفصلة «أرسل للمراجعة». يصل الحكم بشكل غير متزامن (عبر webhook)، وتتحدث قائمة القوالب تلقائياً. الحالات:

  • PENDING (قيد المراجعة)
  • APPROVED (معتمد)
  • REJECTED (مرفوض) — مع ذكر السبب
  • وكذلك PAUSED وDISABLED وIN_APPEAL وPENDING_DELETION.

يمكن تعديل القوالب في الحالات APPROVED وREJECTED وPAUSED. لا يمكن تغيير الاسم واللغة؛ وفي القوالب المعتمدة تكون الفئة محظورة أيضاً.

استخدام القالب في تفاعل

إرسال القالب إجراء ضمن التفاعل:

  1. في منشئ التفاعل افتح «الإجراءات» ← «إضافة إجراء» ← «إرسال قالب WhatsApp».
  2. يتاح الإجراء فقط إذا كان للبوت قناة WhatsApp موصولة تدعم القوالب.
  3. يُختار قالب معتمد (APPROVED) فقط.
  4. تُملأ المعاملات: قيم متغيرات {{n}} في الجسم، ورأس نصي، ورأس وسائط عبر رابط، ومعاملات أزرار URL. ويمكن في المعاملات استخدام متغيرات الاستبدال.

تُحدَّد قناة الإرسال الفعلية بقناة الحدث: إذا جاء الحدث من WhatsApp فسيذهب القالب إلى WhatsApp.

الحوارات والمرفقات

يمكن للمشغّل الرد في حوار WhatsApp وإرسال المرفقات — صورة أو فيديو أو مستند — مع مراعاة نافذة الـ24 ساعة (خارج النافذة تتعذر المراسلة الحرة). تُسحب الوسائط الواردة من المشتركين عبر بروكسي وتُعرض في الحوار.

التسعير

يتتبع GetMyBot محادثات WhatsApp (conversations) حسب الفئات — marketing / utility / authentication / service. في النسخة الحالية هذا تسجيل للمراقبة فقط (record-only): لا يُخصم الرصيد مقابل المحادثات.

الخطوات التالية