WhatsApp

يوضح هذا الدليل كيفية ربط وكيل Quickchat AI بـWhatsApp. تنقسم العملية إلى خطوتين بسيطتين:

• الخطوة 0: المتطلبات
• الخطوة 1: ربط WhatsApp

إذا واجهت مشكلة في الربط أو احتجت إلى المساعدة، انتقل إلى قسم استكشاف الأخطاء والأسئلة الشائعة أو تواصل معنا.

أدوات إعداد اختيارية

• تحقق من متطلبات إعداد WhatsApp. راجع تفاصيل الرقم ومزود الخدمة التي تقدمها بمقارنتها بمتطلبات الإعداد الموثقة. لا يصل هذا الفحص إلى حساب WhatsApp ولا يربطه.

• تحقق من نافذة خدمة WhatsApp. افحص نافذة الـ24 ساعة انطلاقًا من توقيت الرسالة الواردة والرد الذي تقدمه، مع فروق المناطق الزمنية. لا يتحقق هذا من القوالب أو الموافقة أو صلاحيات الحساب، ولا يرسل رسالة.

• قدّر تكاليف الاستخدام. احسب رصيد نماذج Quickchat AI وإجماليًا منفصلًا لبنود الرسوم التي تقدمها. لا يبحث هذا عن أسعار مزودي الخدمة، ولا يدمج الرصيد مع المبالغ المالية، ولا يفحص حسابك.

شاهد الفيديو

Play

الخطوة 0: المتطلبات

أ. رقم هاتف النشاط التجاري

حدد رقم الهاتف الذي ستستخدمه مع WhatsApp. يمكنك قراءة المزيد في وثائق WhatsApp أو الاطلاع على الأسئلة الشائعة أدناه:

ما الأرقام التي يمكن استخدامها مع WhatsApp Cloud API؟

• تحتاج إلى رقم هاتف مخصص للنشاط التجاري يمكنه استقبال الرسائل النصية أو المكالمات الصوتية للتحقق.
• يجب أن يكون الرقم صالحًا ومملوكًا لك، وأن يتضمن رمز البلد والمنطقة.

هل يمكنني استخدام رقم مستخدم بالفعل في WhatsApp Messenger؟

• لا. يمكنك الاستمرار في استخدام هذا الرقم للمكالمات والرسائل النصية، ولكن ليس في WhatsApp Messenger.
• إذا كان الرقم مستخدمًا في WhatsApp Messenger، فاحذفه أولًا. لا تنسَ نسخ سجل محادثات WhatsApp احتياطيًا.
• يجب رفع الحظر عن الأرقام المحظورة قبل تسجيلها.

هل يمكنني استخدام رقم مستخدم بالفعل في تطبيق WhatsApp Business؟

• لا يوفر مسار الربط الحالي في Quickchat AI مسار Coexistence مُتحققًا منه لرقم موجود في تطبيق WhatsApp Business. توضح Meta كيفية عمل الاستخدام المتزامن في التكاملات المدعومة ضمن دليل إعداد مستخدمي تطبيق Business.
• إذا كنت تحتاج إلى الاحتفاظ برقمك الحالي وحساب تطبيق Business وسجل المحادثات، فراسل support@quickchat.ai قبل المتابعة. لا تحذف حساب تطبيق Business أو تفصله، ولا تنقل الرقم، كخطوة لاستكشاف الأخطاء.

هل يمكنني استخدام رقم هاتف جديد؟

• نعم، إذا كنت تفضل عدم استخدام رقمك الحالي، فاحصل على رقم جديد (شريحة SIM فعلية أو رقم افتراضي). يمكنك شراء رقم هاتف افتراضي من خدمات مثل Hushed.

ب. معلومات النشاط التجاري

جهّز التفاصيل التالية (ستدخلها أثناء عملية الربط لدى Meta):

• اسم النشاط التجاري
• الموقع الإلكتروني للنشاط التجاري
• فئة النشاط التجاري
• وصف النشاط التجاري

تنبيه

حتى إذا بدت بعض الحقول اختيارية، املأها بدقة. قد تؤخر المعلومات الناقصة أو غير الدقيقة الموافقة أو تؤدي إلى فرض قيود على الحساب.

الخطوة 1: ربط WhatsApp

افتح تطبيق Quickchat AI ← External Apps ← WhatsApp ← اضغط زر Connect WhatsApp واتبع الخطوات في نافذة Meta المنبثقة:

يمكنك أيضًا البدء من ChatGPT أو Claude أو تطبيق AI متصل آخر: اطلب رابطًا لربط هذا الوكيل بـWhatsApp. يظل الرابط صالحًا لمدة 10 دقائق ويعمل مرة واحدة، ولحساب Quickchat الذي طلبه فقط. افتحه في متصفح سجّلت فيه الدخول إلى ذلك الحساب، واتبع إعداد Meta، وأكمل أي اختيار للحساب أو الهاتف عند عودة Quickchat للظهور. ثم اطلب من تطبيق AI التحقق من الإعداد، وأرسل رسالة WhatsApp حقيقية للتأكد من وصول رد AI. اختبر كل رقم مفعّل إذا ربطت أكثر من رقم. توافق على وصول Meta في المتصفح دون مشاركة رموز الوصول في المحادثة.

1. سجّل الدخول إلى حسابك في Meta (Facebook).
2. راجع الصلاحيات التي ستمنحها لـQuickchat AI (الوصول إلى حساب WhatsApp Business وإلى ملف الأعمال) ثم تابع.
3. أدخل معلومات دقيقة عن نشاطك التجاري (ملف الأعمال، واسم النشاط، والموقع الإلكتروني، والبلد، وغيرها).
4. أنشئ حساب WhatsApp Business أو اختر حسابًا موجودًا.
5. اختر اسم عرض وفئة لـWhatsApp Business.
6. أضف رقم هاتف نشاطك التجاري وتحقق منه عبر رسالة نصية أو مكالمة صوتية حسب التعليمات.
7. اضغط Confirm لمنح Quickchat AI الصلاحيات المطلوبة.
8. عندما تؤكد Meta اكتمال الإعداد، اضغط Finish. تعرض النافذة المنبثقة تأكيدًا من Quickchat AI بأن حساب WhatsApp قد تم ربطه، ثم تُغلق تلقائيًا.

إذا منحت Meta تطبيق Quickchat AI الوصول إلى أكثر من حساب، تعرض لوحة WhatsApp عبارة Choose your WhatsApp Business Account بدلًا من الربط الفوري. اختر الحساب الذي يجب أن يرد عليه وكيل AI واضغط Use this account. إذا كنت تعيد الربط، يظل إعداد WhatsApp الحالي كما هو حتى تؤكد.

عند العودة إلى تطبيق Quickchat AI، تعرض لوحة WhatsApp حالة Finish setup حتى يتم التحقق من تبادل ناجح للرسائل على رقم نشاطك التجاري. إذا لم تُحدَّث اللوحة بعد نحو 30 ثانية، فاضغط أيقونة التحديث.

الربط بـMeta واستقبال رسالة ليسا إلا جزءًا من الإعداد. تعرض اللوحة الخطوة التالية لكل رقم مفعّل:

• Waiting for your first message: أرسل رسالة WhatsApp إلى الرقم المعروض من هاتف آخر، ثم اضغط Refresh. تأكد من أنك تراسل رقم النشاط التجاري الذي سيستخدمه عملاؤك.
• Waiting for the AI reply to be delivered: استقبل Quickchat رسالتك، لكن WhatsApp لم يؤكد بعد تسليم رد AI. تحقق مما إذا كان الرد قد وصل إلى الهاتف الآخر. إذا لم يصل، فتحقق من رصيد AI ومن أي تحذيرات في اللوحة، ثم أرسل رسالة اختبار أخرى.
• AI reply delivered: أكد WhatsApp تسليم رد AI على رسالة واردة عبر رقم النشاط التجاري هذا.
• Verification needs attention: عالج تحذيرات الاتصال، وأبقِ الرقم المقصود مفعّلًا، ثم أرسل رسالة اختبار جديدة.
• Display name: يعرض كل رقم مدرج أسفل اللوحة حالة اسم العرض الواردة من Meta (Approved أو Pending review أو Declined أو Expired أو No display name). لا تتطلب المراجعة الجارية إجراءً منك، وعادةً ما تنتهي خلال أيام قليلة. إذا كان اسم العرض مرفوضًا أو منتهي الصلاحية أو غير موجود، فسيُطلب منك تقديمه في WhatsApp Manager.
• Meta test number: أرقام +1 555 التي توفرها Meta وأرقام بيئة الاختبار لا تثبت تفعيل رقم نشاطك التجاري. أضف رقمك الخاص في WhatsApp Manager، وفعّله في Quickchat، ثم اختبره.

تعرض اللوحة حالة Live عندما يكون قد تم التحقق من تبادل للرسائل عبر كل رقم تجاري مفعّل وتكون فحوصات الاتصال سليمة. إذا فعّلت عدة أرقام تجارية، فاختبر كل واحد منها. لا يكفي لإكمال هذا الفحص نجاح تبادل عبر رقم اختبار أو إرسال قالب أو وصول إشعار بنفاد حصة الرسائل.

نصيحة

أبقِ التكامل مفعّلًا أثناء الاختبار. أرسل رسالة من هاتف آخر إلى كل رقم تجاري تريد استخدامه، وتأكد من وصول رد AI، ثم اضغط Refresh. ينبغي أن تظهر المحادثة أيضًا في صندوق الوارد في تطبيق Quickchat AI. قد يطلب اتصال موجود تبادلًا تجريبيًا جديدًا للتحقق من التسليم؛ ويمكنه مواصلة استقبال الرسائل والرد عليها أثناء إتمام هذه الخطوة.

إذا كانت لدى Meta خطوات إعداد متبقية، فأكملها من Setup guidance في WhatsApp Manager. يرسل Quickchat AI أيضًا تذكيرًا بالبريد الإلكتروني إلى مالك الحساب عندما تظل خطوات إعداد Meta غير مكتملة.

استكشاف الأخطاء والأسئلة الشائعة

كيف تعمل أسعار WhatsApp Business API؟

• يعتبر WhatsApp الردود على استفسارات العملاء التي يبدأها المستخدم (الواردة) رسائل خدمة. تتيح هذه الرسائل للشركات التعامل مع استفسارات العملاء الواردة، سواء عبر موظف بشري أو بوت محادثة يعمل بالذكاء الاصطناعي.
• عندما يرسل المستخدم رسالة إلى نشاط تجاري، تُفتح نافذة خدمة عملاء مدتها 24 ساعة يمكن خلالها للنشاط الرد برسائل خدمة دون رسوم. تبدأ هذه النافذة من جديد مع كل رسالة من المستخدم.
• بعد مرور 24 ساعة، يجب استخدام قوالب رسائل معتمدة (التسويق، والخدمات، والمصادقة، وغيرها)، والدفع مقابل كل رسالة وفق أسعار رسائل منصة WhatsApp Business.
• تتولى Meta تصنيف المحادثات واحتساب رسومها. تأكد من وجود وسيلة دفع صالحة في حساب WhatsApp Business للرسائل التي يبدأها النشاط التجاري ورسائل القوالب.

زر Connect WhatsApp لا يعمل، ولا أرى نافذة Meta المنبثقة.

• إذا حظر متصفحك النافذة المنبثقة، فاسمح بالنوافذ المنبثقة لتطبيق Quickchat AI واضغط Try again. يمكنك أيضًا الضغط على Continue on Meta in this tab لإكمال الإعداد نفسه دون نافذة منبثقة.

Quickchat couldn’t confirm the WhatsApp connection

يعرض Quickchat رسالة الاستعادة هذه عندما لا تُرجع نافذة Meta نتيجة، ولا يزال Quickchat غير قادر على التحقق من الاتصال. لا تعني الرسالة أن Meta لم تُجرِ أي تغييرات.

1. تأكد من أنك مشرف في نشاط Meta Business الذي يملك حساب WhatsApp Business. إن لم تكن كذلك، فاطلب من مشرف ربطه باستخدام تسجيل دخوله إلى Facebook.
2. اضغط Try again. إذا عرقلت أداة حظر نافذة Meta، فاستخدم نافذة تصفح خاص مع تعطيل الإضافات مؤقتًا، أو اضغط Continue on Meta in this tab.
3. إذا كان الرقم نشطًا في WhatsApp Messenger، فأزله منه أولًا أو استخدم رقمًا آخر. إذا كان نشطًا في تطبيق WhatsApp Business، فتوقف هنا وراسل support@quickchat.ai قبل المتابعة. لا يوفر مسار الربط الحالي في Quickchat AI مسار Coexistence مُتحققًا منه. لا تحذف حساب تطبيق Business أو تفصله، ولا تنقل الرقم، لمعالجة هذه الرسالة.
4. إذا كان حساب WhatsApp Business يستخدم Aircall أو Twilio أو 360dialog أو MessageBird أو مزودًا آخر، فأضف Quickchat AI كشريك في إعدادات النشاط التجاري لدى Meta:
   1. افتح إعدادات النشاط التجاري لدى Meta وانتقل إلى Accounts ← WhatsApp Accounts.
   2. اختر حساب WhatsApp Business، وافتح Partners، ثم اضغط Add Partners.
   3. أدخل معرّف النشاط التجاري لـQuickchat AI: 270696274483463.
   4. امنح صلاحية Manage WhatsApp accounts، ثم عُد إلى Quickchat AI وحدّث الحالة.

لا تفصل مزود الخدمة الآخر إلا إذا كانت Meta لا تسمح بوجود الشريكين على الحساب نفسه. إذا لم تكن متأكدًا، فتواصل مع الدعم قبل فصل مزود مراسلة يعمل حاليًا.

فشل التحقق من الرقم.

• تأكد من أن الرقم يمكنه استقبال الرسائل النصية أو المكالمات الصوتية.
• لا تحدد رسالة Ineligible العامة أو التلميح This number can’t be shared with this app سبب المشكلة أو ما إذا كانت متطلبات الاستخدام المتزامن لدى Meta مستوفاة. أرسل إلى support@quickchat.ai نص الرسالة بالضبط والخطوة التي ظهرت فيها.
• إذا كان الرقم مستخدمًا في تطبيق WhatsApp Business وتحتاج إلى الاحتفاظ بالحساب وسجله، فتواصل مع الدعم قبل المتابعة. لا تحذف الحساب أو تفصله، ولا تنقل الرقم، في محاولة لإزالة الخطأ.

ربطت الحساب الخطأ.

• يحتفظ Reconnect بالحساب المرتبط حاليًا. لنقل وكيل AI إلى حساب WhatsApp Business مختلف، اضغط Disconnect في لوحة WhatsApp، ثم Connect WhatsApp مجددًا، واختر حساب Meta Business وحساب WhatsApp الصحيحين في نافذة Meta.

We could not tell which WhatsApp Business Account to connect

• يتيح تسجيل دخولك إلى Meta الوصول إلى عدة حسابات WhatsApp Business تحتوي على أرقام هواتف، ولم يتمكن Quickchat من تحديد الحساب المقصود. راسل support@quickchat.ai برقم الهاتف الذي تريد ربطه، وسنكمل الإعداد لك.

الرسائل لا تظهر في صندوق الوارد في Quickchat AI.

• تأكد من أن النافذة المنبثقة عرضت رسالة التأكيد النهائية: “WhatsApp account connected!”.
• تحقق مجددًا من ربط حساب WhatsApp المقصود ومن اختيار وكيل AI الصحيح.
• تعرض بطاقة Waiting for your first message الرقم الذي يرد عليه وكيل AI. تأكد من أنك أرسلت الرسالة إلى هذا الرقم تحديدًا وأنه مفعّل في اللوحة، ثم اضغط Refresh.
• إذا كنت ترسل رسائل بعد مرور 24 ساعة دون رسالة من المستخدم، فاستخدم قوالب معتمدة وتأكد من إعداد وسيلة دفع في WhatsApp Manager.

يتعذر إرسال ردود AI على WhatsApp.

إذا تعذر تسليم ردود AI، يعرض Quickchat AI تنبيه “WhatsApp replies are failing” في لوحة WhatsApp ضمن External Apps، وإشعارًا في لوحة التحكم. إليك الأسباب الأكثر شيوعًا وحلولها:

• لم يُعتمد اسم العرض لرقم اختبار Meta: تحجب Meta الردود الصادرة من رقم +1 555 الذي توفره حتى يُعتمد اسم عرضه. يتحول تنبيه اسم العرض في اللوحة إلى اللون الأحمر ويحدد الرقم. انتظر انتهاء المراجعة (عادةً بضعة أيام)، أو قدّم اسم عرض جديدًا في WhatsApp Manager إذا رُفض، ثم أرسل رسالة اختبار. وجود اسم عرض قيد المراجعة على رقمك الخاص لا يمنع الردود بحد ذاته؛ وتعرضه اللوحة كملاحظة.
• انتهت صلاحية الاتصال أو أُلغي: لم يعد اتصال WhatsApp صالحًا. افتح لوحة WhatsApp واضغط Reconnect لاستئناف إرسال الردود.
• الرقم مقيّد: فرضت Meta قيودًا على رقمك بسبب تقييم الجودة أو مشكلة متعلقة بالسياسات. تحقق من حالته في WhatsApp Manager لاستعادة الإرسال.
• حساب النشاط التجاري مقفل (الخطأ 131031): حظرت Meta الردود من حساب WhatsApp Business. يوضح خطأ التسليم في صندوق الوارد ولوحة WhatsApp هذا القيد. افتح Business Support Home، واختر حساب WhatsApp، ثم المخالفة واضغط Request Review: لا ترفع Meta قفل الحساب إلا عبر هذه المراجعة. إعادة ربط Quickchat لا ترفع القيد.

تختفي التنبيهات الأخرى تلقائيًا بمجرد نجاح إرسال رد مجددًا. يبقى تنبيه قفل الحساب حتى يُسلَّم رد AI بالكامل على رسالة جديدة من زائر حقيقي، لأن Meta قد تقبل الرد ثم تفشل في إرساله. إذا كانت أرقام اختبار Meta (+1 555) هي الوحيدة المفعّلة، فيُزال التنبيه عند نجاح إرسال رد AI التالي. يستطيع Support AI أيضًا شرح إخفاق حديث محفوظ متعلق بقفل الحساب، لكن الأدلة السابقة لا تثبت أن الحساب لا يزال مقفلًا.

تفشل رسائل القوالب أو الرسائل التي يبدأها النشاط التجاري.

• تحقق من أن قوالب الرسائل معتمدة وأن وسيلة الدفع مفعّلة في WhatsApp Manager.
• يبدأ المرسلون الجدد بـحدود للمراسلة تتوسع حسب الجودة والتحقق. إذا بلغت حدود الرسائل التي يبدأها النشاط التجاري، فراجع إرشادات Meta بشأن حدود المراسلة.
• تحقق من حدود المراسلة وتقييم الجودة في WhatsApp Manager إذا كان التسليم يخضع لتقييد المعدل.

كيف أنشئ رابط WhatsApp وزر “Chat on WhatsApp” خاصين بي؟

• اتبع هذا الدليل من WhatsApp.
• أو نزّل تصاميم أزرار علامة WhatsApp واستخدم أحد مقطعي الكود التاليين:

<!-- WhatsApp inline button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
    "
  />
</a>

أو

<!-- WhatsApp floating button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
  style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
      box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
      transition: all 0.3s ease;
    "
    onmouseover="this.style.transform = 'scale(1.05)'"
    onmouseout="this.style.transform = 'scale(1)'"
  />
</a>

كيف أنشئ رمز QR خاصًا بي لـWhatsApp؟

• افتح WhatsApp Manager ← Phone numbers ← اختر رقم هاتف نشاطك التجاري ← Message links ← Create Message Link.
• يمكنك أيضًا العثور عليه في تطبيق WhatsApp Business على هاتفك. اتبع هذا الدليل من WhatsApp.

هل أفصل حساب تطبيق WhatsApp Business لإصلاح الإعداد؟

• لا. لا تحذف حساب تطبيق Business أو تفصله، ولا تنقل رقمه، كخطوة لاستكشاف الأخطاء. لا يوفر مسار الربط الحالي في Quickchat AI مسار Coexistence مُتحققًا منه يحافظ على إعداد التطبيق الحالي وسجله.
• راسل support@quickchat.ai قبل تغيير حساب تطبيق Business يعمل حاليًا. يشرح دليل إعداد مستخدمي تطبيق Business من Meta الاستخدام المتزامن في التكاملات المدعومة، لكنه لا يؤكد توفره لإعداد Quickchat AI لديك.

ما نوع الوصول الذي يحصل عليه Quickchat AI إلى حساب WhatsApp Business؟

• وصول محدود عبر API، وليس ملكية للحساب. يبقى حساب WhatsApp Business ‏(WABA) ضمن Meta Business Manager الخاص بك. وفق نموذج WABA Sharing لدى Meta، تملك أنت الأصول ويُضاف Quickchat AI كشريك يمكنك إلغاء وصوله في أي وقت من Business Manager.
• يمكننا إرسال الرسائل واستقبالها عبر Cloud API، واستقبال أحداث الرسائل عبر webhook ما دام التكامل مفعّلًا.
• لا يمكننا إغلاق حسابك أو نقله أو تغيير علامته التجارية أو تعديل الفوترة أو إزالة المشرفين لديك.

هل تحتاج إلى مساعدة؟

تحدث مع Support AI من Quickchat على WhatsApp:
📱 +1 302-405-9992: ابدأ محادثة

أو امسح رمز QR: