WhatsApp

اربط بوتك بـ WhatsApp Business ليتمكن العملاء من مراسلته مباشرة عبر WhatsApp.

صفحة تهيئة تكامل WhatsApp

يربط تكامل WhatsApp بوت شاور الخاص بك بـ WhatsApp Business API. بعد التهيئة، يمكن للعملاء مراسلة رقم WhatsApp Business الخاص بك وتلقي ردود تلقائية من قاعدة معرفة البوت.

المتطلبات الأساسية

قبل البدء، تحتاج إلى:

  1. حساب Meta Business مع صلاحية الوصول إلى منصة WhatsApp Business
  2. رقم هاتف WhatsApp Business مسجّل في لوحة تحكم Meta Business
  3. رمز وصول مستخدم النظام مع صلاحية whatsapp_business_management

الإعداد

انتقل إلى صفحة التكاملات > WhatsApp الخاصة ببوتك.

الخطوة 1: أدخل بيانات الاعتماد

املأ الحقول التالية:

  • Phone Number ID — يوجد في لوحة تحكم Meta Business تحت WhatsApp > API Setup. هذا معرّف رقمي وليس رقم هاتفك
  • Business Account ID — معرّف حساب WhatsApp Business الخاص بك من Meta
  • Access Token — رمز وصول دائم لمستخدم النظام مع صلاحية whatsapp_business_management. يُخفى هذا الرمز بعد الحفظ (تظهر آخر 8 أحرف فقط)
  • Webhook Verify Token — نص عشوائي تنشئه بنفسك. يجب أن يتطابق مع WHATSAPP_WEBHOOK_VERIFY_TOKEN في إعدادات البيئة

الخطوة 2: احفظ واحصل على رابط Webhook

بعد حفظ بيانات الاعتماد، يُنشئ شاور رابط Webhook. انسخ هذا الرابط — ستحتاجه في الخطوة التالية.

الخطوة 3: هيّئ Webhook في Meta

  1. اذهب إلى إعدادات تطبيق Meta الخاص بك
  2. انتقل إلى إعدادات منتج WhatsApp
  3. تحت Webhooks، الصق رابط Webhook من شاور
  4. أدخل نفس Verify Token الذي هيّأته في شاور
  5. اشترك في حقل webhook الخاص بـ messages

الخطوة 4: اختبر

أرسل رسالة إلى رقم WhatsApp Business الخاص بك. يجب أن يرد البوت باستخدام قاعدة معرفتك وقواعد السلوك.

إدارة التكامل

  • تعديل — حدّث بيانات الاعتماد أو الرموز في أي وقت. يمكنك ترك حقل Access Token فارغًا عند التعديل للاحتفاظ بالرمز الحالي
  • حذف — احذف التكامل لفصل WhatsApp

استكشاف الأخطاء وإصلاحها

المشكلةالسببالحل
البوت لا يرد على رسائل WhatsAppWebhook غير مهيّأ بشكل صحيح في Metaتحقق من تطابق رابط webhook ورمز التحقق
أخطاء "Unauthorized"رمز الوصول منتهي الصلاحية أو يفتقر للصلاحياتأنشئ رمز وصول جديدًا لمستخدم النظام بالصلاحيات الصحيحة
الرسائل تصل لكن لا يوجد ردالبوت غير نشطفعّل البوت من صفحة قائمة البوتات