ربط واجهة برمجة تطبيقات WhatsApp Business Cloud بـ AssistFlow: دليل خطوة بخطوة

الوقت: ~10 دقائق · مستوى المهارة: متوسط · التكلفة: مجاني مع الرقم التجريبي المقدم من Meta

في هذا الدليل، سنقوم بإنشاء تطبيق واجهة برمجة تطبيقات WhatsApp Business Cloud على Meta للمطورين، وربطه بـ AssistFlow، وتفعيل الردود التلقائية بالذكاء الاصطناعي للرسائل الواردة. تم اختبار كل خطوة بشكل مباشر.

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

• حساب Meta (Facebook) نشط مع حساب أعمال Meta
• رقم هاتف غير مسجل حاليًا على WhatsApp (تقدم Meta أيضًا رقمًا تجريبيًا مجانيًا)
• حساب AssistFlow مع الوصول إلى لوحة تحكم المطور (/dashboard/whatsapp-settings)

1. إنشاء تطبيق Meta للمطورين

1. اذهب إلى developers.facebook.com/apps وانقر على إنشاء تطبيق.
2. اختر حالة الاستخدام "أخرى" ونوع التطبيق "أعمال".
3. أدخل اسم التطبيق (مثل "AssistFlow WhatsApp") وبريدك الإلكتروني للاتصال، ثم اختر حساب الأعمال الخاص بك.

2. إضافة منتج WhatsApp

1. من شريط لوحة تحكم التطبيق الجانبي، انقر على "إضافة منتج" واضغط على "إعداد" على بطاقة WhatsApp.
2. اختر محفظة أعمال (أو أنشئ واحدة).
3. ستقوم Meta بتوفير رقم هاتف تجريبي وحساب أعمال WhatsApp (WABA) تلقائيًا — يمكنك إرسال رسائل مجانية به أثناء التطوير.

3. احصل على معرف رقم الهاتف، معرف WABA والرقم المعروض

من الشريط الجانبي افتح WhatsApp → إعداد API:

• معرف رقم الهاتف — سلسلة أرقام طويلة تحت "من" (مثل 527144740475098)
• معرف حساب أعمال WhatsApp — في الأعلى، بجانب القائمة المنسدلة
• رقم الهاتف المعروض — رقمك التجريبي أو الموثق بصيغة E.164 (مثل +90 555 724 22 44)
• اسم الأعمال الموثق — اسم شركتك في مدير الأعمال

انسخ هذه القيم الأربعة في مكان آمن — سنلصقها في AssistFlow لاحقًا.

4. إنشاء رمز وصول دائم

ينتهي صلاحية "رمز الوصول المؤقت" في إعداد API خلال 24 ساعة. للإنتاج، أنشئ مستخدم نظام في Meta Business وأصدر رمزًا دائمًا له:

1. business.facebook.com → الإعدادات → المستخدمون → مستخدمو النظام
2. إضافة → اسمه (مثل "رمز AssistFlow")، حدد الدور كـ مسؤول.
3. اختر المستخدم الجديد → إضافة الأصول → التطبيقات → اختر تطبيق AssistFlow الخاص بك → امنح إدارة التطبيق.
4. أضف حسابات WhatsApp كأصل أيضًا → امنح إدارة حساب WhatsApp.
5. إنشاء رمز جديد → اختر تطبيقك → فعّل على الأقل:
   • whatsapp_business_management
   • whatsapp_business_messaging
   • business_management
6. قم بتفعيل "لا تنتهي صلاحيته أبدًا" → إنشاء → انسخ الرمز فورًا (لن تعرضه Meta مرة أخرى).

5. لصق بيانات الاعتماد في AssistFlow

1. سجل الدخول إلى لوحة تحكم مطوري AssistFlow → WhatsApp AI → إعدادات WhatsApp.
2. في بطاقة بيانات اعتماد Meta Cloud API، الصق:
   • معرف رقم الهاتف
   • معرف حساب أعمال WhatsApp
   • رمز الوصول الدائم
   • رقم الهاتف المعروض
   • اسم الأعمال الموثق
3. اضغط على حفظ في الأسفل. يقوم النظام تلقائيًا بإنشاء رمز تحقق من Webhook لك.

6. توصيل الويب هوك على جانب Meta

بعد الحفظ، تعرض بطاقة إعدادات Webhook قيمتين:

عنوان URL للاستدعاء: https://<project>.supabase.co/functions/v1/whatsapp-webhook رمز التحقق: (تم إنشاؤه تلقائيًا، انقر على "نسخ")

الآن عد إلى بوابة مطوري Meta:

1. الشريط الجانبي → WhatsApp → التكوين → Webhook.
2. الصق عنوان URL للاستدعاء ورمز التحقق → تحقق واحفظ.
3. في "حقول Webhook" اشترك في messages. (اختياري: اشترك أيضًا في message_template_status_update وaccount_update.)

7. تمكين الردود بالذكاء الاصطناعي

AssistFlow → إعدادات WhatsApp → بطاقة إعدادات الرد التلقائي:

• تفعيل التكامل → تشغيل
• الردود بالذكاء الاصطناعي نشطة → تشغيل
• الويدجت الافتراضي → اختر قاعدة المعرفة + الشخصية التي يجب أن يستخدمها الذكاء الاصطناعي (يمكنك اختيار الويدجت الحالي للدردشة).
• حد الرسائل اليومي → 1000 (أو ما يناسب خطتك).
• رسالة خارج ساعات العمل → نص يتم إرساله تلقائيًا خارج ساعات العمل الخاصة بك.

اضغط على حفظ مرة أخرى.

8. اختبره

1. من لوحة "إرسال واستقبال الرسائل" للرقم التجريبي، أرسل رسالة — اكتب إلى الرقم من WhatsApp الخاص بك.
2. خلال 30 ثانية، يجب أن ترى رد الذكاء الاصطناعي على WhatsApp الخاص بك.
3. افتح رسائل WhatsApp في AssistFlow → تأكد من تسجيل الرسالة كرسالة واردة وصادرة.

9. الانتقال إلى الإنتاج

1. بوابة مطوري Meta → مراجعة التطبيق → الأذونات والميزات → طلب الوصول المتقدم لـ whatsapp_business_messaging وwhatsapp_business_management.
2. WhatsApp → أرقام الهواتف → إضافة رقم هاتف → أضف رقم عملك الحقيقي، تحقق عبر SMS/الصوت.
3. تحديث معرف رقم الهاتف الجديد في AssistFlow (استبدل الرقم التجريبي).
4. قم بتغيير وضع التطبيق إلى مباشر.

المشكلات الشائعة

"فشل التحقق من Webhook"

رمز التحقق غير متطابق أو لم تحفظ AssistFlow أولاً. احفظ الإعدادات، ثم الصق في Meta.

الرسائل تصل لكن الذكاء الاصطناعي لا يرد

قد يكون "الردود بالذكاء الاصطناعي نشطة" مغلقًا. أيضًا إذا لم يتم تعيين "الويدجت الافتراضي"، فإن الذكاء الاصطناعي لا يعرف أي شخصية يستخدم.

خطأ "إعادة التفاعل" / نافذة 24 ساعة

سياسة WhatsApp: إذا لم يرسل العميل رسالة إليك خلال 24 ساعة، يمكنك الوصول إليهم فقط باستخدام قالب معتمد. قم بمزامنة القوالب من Meta في علامة التبويب القوالب.

انتهاء صلاحية الرمز

استخدمت الرمز المؤقت (24 ساعة). استخدم تدفق مستخدم النظام في الخطوة 4 للحصول على رمز دائم.

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

• قوالب WhatsApp: قم بمزامنة قوالب التسويق المعتمدة الخاصة بك في علامة التبويب القوالب.
• حملات WhatsApp: قم بتحميل قائمة العملاء وتشغيل حملات التنقيط.
• تحليلات المحادثة: تتبع الإرسال اليومي، الفتحات، والجلسات النشطة في علامة التبويب التحليلات.

تحتاج إلى مساعدة؟ راسل support@assistflow.ai — دعم الإعداد مشمول في خطتك.