دمج WhatsApp

اربط الـ Agent الخاص بك بـ WhatsApp Business للتواصل مع العملاء.

نظرة عامة

يوفّر دمج WhatsApp ما يلي:

• قدرات مراسلة الأعمال
• دعم الوسائط الغنية
• ردود آلية
• وصول عالمي
• الالتزام بنافذة المراسلة لمدة 24 ساعة

المتطلّبات المسبقة

• Agent ذكي نشط (مُنشأ في قسم Agents)
• WhatsApp Business Account (WABA)
• رقم هاتف مُتحقّق منه في WhatsApp Business
• الوصول إلى Meta Developer Portal

خطوات الإعداد

1. اربط عبر Embedded Signup (موصى به)

أسهل طريقة لربط WhatsApp هي عبر تدفّق التسجيل المدمج من Meta:

1. انتقل إلى Integrations في الشريط الجانبي
2. افتح بطاقة WhatsApp Business وانقر على Add WhatsApp
3. انقر على Connect with Facebook لفتح نافذة تسجيل Meta المنبثقة
4. سجّل الدخول بحساب Facebook/Meta الخاص بك
5. اختر أو أنشئ WhatsApp Business Account
6. اختر رقم الهاتف المراد ربطه
7. تُغلَق النافذة المنبثقة ويُنشأ اتصالك

2. التحقّق من الهاتف (إن لزم)

بعد إكمال تسجيل Meta، قد تحتاج إلى التحقّق من رقم هاتفك:

1. اختر كيفية تلقّي رمز التحقّق: SMS أو Voice Call
2. انقر على Send Code
3. أدخل الرمز المكوّن من 6 أرقام الذي تلقّيته
4. انقر على Verify

إذا لم تتلقَّ الرمز، انقر على “Didn’t receive the code? Send again” لإعادة المحاولة.

3. التحقّق بخطوتين (إن كان مُفعّلًا)

إذا كان حساب WhatsApp Business الخاص بك يحتوي على Two-Step Verification مُفعّلًا:

1. أدخل رمز PIN المكوّن من 6 أرقام عند المطالبة
2. انقر على Complete Registration

4. اضبط الـ Webhook (إن لزم)

بعد الإعداد، قد تحتاج إلى ضبط الـ webhook في Meta Business Suite:

1. انسخ عنوان الـ webhook المقدّم بعد الاتصال
2. في Meta Developer Portal، انتقل إلى WhatsApp ← Configuration
3. أضف عنوان الـ webhook
4. اشترك في حقل webhook المسمّى messages

استخدام الروبوت

رسائل العملاء

عندما يراسل العملاء رقم WhatsApp الخاص بك:

1. تصل الرسالة عبر WhatsApp
2. يعالج Cuneiform Chat الطلب
3. يولّد الـ Agent ردًا من المحتوى
4. يُرسَل الرد إلى العميل

تدفّق المحادثة

العميل → WhatsApp → Cuneiform Chat → الـ Agent → الرد → العميل

الميزات

نافذة المراسلة لمدة 24 ساعة

قواعد WhatsApp Business API:

• يمكنك الرد على الرسائل التي يبدأها العميل لمدة 24 ساعة
• بعد 24 ساعة، تُغلق النافذة حتى يراسل العميل مجددًا
• كل رسالة جديدة من العميل تعيد فتح النافذة

الوسائط الغنية

يمكن أن تتضمّن الردود:

• رسائل نصية
• روابط
• نص منسّق

تعدّد اللغات

يكتشف الـ Agent الخاص بك لغة العميل تلقائيًا ويردّ بها — 176 لغة مدعومة، بلا حاجة إلى إعداد.

إدارة الأرقام المرتبطة

يعرض كل رقم WhatsApp مرتبط:

• اسم العمل أو رقم الهاتف المعروض
• شارة الحالة - Active أو Inactive أو Error
• رقم الهاتف
• طابع زمني لـ Last activity

الإجراءات المتاحة

ادخل إليها عبر القائمة ثلاثية النقاط على بطاقة الدمج.

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

فشل الاتصال

1. تأكّد من امتلاكك WhatsApp Business Account صالحًا
2. تحقّق من أن رقم هاتفك مُتحقَّق منه
3. جرّب تدفّق التسجيل المدمج مرة أخرى

التحقّق من الهاتف لا يعمل

1. تأكّد من امتلاكك الوصول إلى رقم الهاتف لتلقّي SMS/Voice
2. انتظر بضع دقائق قبل طلب رمز جديد
3. تحقّق من أن رقم الهاتف غير مرتبط بالفعل في مكان آخر

خطأ التحقّق بخطوتين

1. أدخل رمز PIN المُعدّ في WhatsApp Business Manager ← Security Center
2. هذا مختلف عن رمز التحقّق عبر SMS
3. تواصل مع مسؤول WhatsApp Business لديك إذا كنت لا تعرف رمز PIN

الرسائل لا تصل

1. تحقّق من ضبط الـ webhook بشكل صحيح في Meta Business Suite
2. تحقّق من أن اشتراك الـ webhook يتضمّن messages
3. تأكّد من أن حالة عملية الدمج “Active”

فشل الردود

1. تحقّق من أن الـ Agent الخاص بك يعمل في الـ Playground
2. تحقّق من أن نافذة الـ 24 ساعة نشطة (راسل العميل مؤخرًا)
3. تحقّق من حالة عملية الدمج في لوحة الإدارة

الأمان

• تُشفَّر رموز الوصول وتُخزَّن بأمان
• تُعالَج الرسائل عبر اتصالات آمنة

الامتثال

لدى WhatsApp Business سياسات استخدام:

• ردّ فقط على المحادثات التي يبدأها العميل
• وفّر خيارات إلغاء الاشتراك
• اتبع سياسات Commerce وBusiness الخاصة بـ Meta

قطع الاتصال

لإزالة دمج WhatsApp:

1. انتقل إلى Integrations في الشريط الجانبي
2. انقر على القائمة ثلاثية النقاط على دمج WhatsApp الخاص بك
3. اختر Disconnect

يوقف ذلك الـ Agent عن الاستجابة. للإزالة الكاملة:

• احذف الـ webhook في Meta Developer Portal
• أزِل اختياريًا منتج WhatsApp من تطبيق Meta الخاص بك

أسئلة شائعة

س: كيف أربط WhatsApp؟ ج: استخدم التسجيل المدمج بالنقر على “WhatsApp” في تبويب Integrations، ثم “Connect with Facebook”. يرشدك هذا عبر عملية تسجيل Meta تلقائيًا.

س: لماذا يُطلب منّي رمز تحقّق؟ ج: يتطلّب WhatsApp التحقّق من الهاتف للاتصالات الجديدة. اختر SMS أو Voice Call لتلقّي رمز مكوّن من 6 أرقام، ثم أدخله لإكمال الإعداد.

س: ما هو رمز PIN للتحقّق بخطوتين؟ ج: إذا فعّلت Two-Step Verification في WhatsApp Business Manager، ستحتاج إلى إدخال رمز PIN المكوّن من 6 أرقام أثناء الإعداد. هذا مختلف عن رمز التحقّق عبر SMS.

س: هل يمكنني ربط أرقام WhatsApp متعدّدة؟ ج: نعم، يمكنك ربط أرقام WhatsApp Business متعدّدة. يمكن ربط كل رقم بـ Agent ذكي مختلف (أو نفسه).