WhatsApp Cloud API

أعلن Facebook عن إطلاق WhatsApp Cloud API في 20 مايو ، وهو متاح لأي شركة من أي حجم ، كبيرها وصغيرها للتواصل مع العملاء باستخدام WhatsApp API الرسمي.

ربط WhatsApp Cloud API

للدردشة مع عملائك عبر WhatsApp Cloud API ، قم بتوصيل ملف تعريف WhatsApp Business وحساب Meta Business.

الخطوة 1: انتقل إلى إعدادات القناة

من وحدة الإعدادات ، انتقل إلى عنصر القائمة ، القنوات .

الخطوة الثانية: إضافة قناة

انقر فوق إضافة قناة واختر WhatsApp Business API . انقر فوق التالي ويفتح مربع حوار Connecting WhatsApp Business API .

الخطوة 3: الاتصال بحساب WhatsApp Cloud API

انقر فوق الارتباط الموجود في "هل لديك بالفعل حساب WhatsApp Cloud API عبر Meta للمطورين؟ انقر هنا." رسالة. يجب أن يفتح مربع حوار Connecting WhatsApp Cloud API .

الخطوة 4: تواصل مع Facebook

انقر فوق الزر Connect With Facebook .

الخطوة 5: قم بتسجيل الدخول باستخدام حساب Facebook

قم بتسجيل الدخول باستخدام حساب Facebook مع وصول المسؤول إلى تطبيق Facebook وحساب Meta business.

الخطوة 6: حدد رقم WhatsApp

في القائمة المنسدلة ، حدد اسم WABA برقم WhatsApp الذي ترغب في الاتصال به.

الخطوة 7: أضف عنوان URL لمعاودة الاتصال

ارجع إلى قسم WhatsApp في تطبيق Facebook Developer. انتقل إلى قسم التكوين الفرعي وقم بإعداد عنوان URL لمعاودة الاتصال. أضف عنوان URL الذي تم إنشاؤه لرد الاتصال وتحقق من الرمز المميز من response.io إلى الحقول المقابلة في مربع حوار الرد التلقائي على الويب.

الخطوة 8: التحقق من التغييرات وحفظها

في تطبيق Facebook ، تحقق من التغييرات في التطبيق واحفظها.

الخطوة 9: الاشتراك في حدث webhook

في تطبيق Facebook الخاص بك ، حدد علامة التبويب Webhooks ضمن لوحة المنتجات وحدد WhatsApp Business Account في القائمة المنسدلة. انقر على اشتراك الرسائل الحدث.

الخطوة 10: بدّل وضع التطبيق من التطوير إلى الوضع المباشر

انقر فوق زر التبديل أعلى الصفحة لتشغيل الوضع المباشر.

الخطوة 11: أكمل الإعداد على response.io

انقر فوق تم لإكمال الإعداد.

تكوين القناة

الخطوة 1: انتقل إلى إعدادات القناة

من وحدة الإعدادات ، انتقل إلى عنصر القائمة ، القنوات .

الخطوة 2: حدد موقع قناة WhatsApp Cloud API

بمجرد تحديد موقع قناة WhatsApp Cloud API ، انقر فوق تكوين .

الخطوة 3: قم بإجراء التكوين اللازم

يمكنك تكوين ما يلي:

• اسم القناة - الاسم المستخدم داخليًا لتعريف الحساب.

الخطوة 4: قم بتحديث التكوين

انقر فوق تم لتحديث تكوين القناة.

البيانات الوصفية التي تلقتها القناة

توفر القنوات المختلفة مجموعات مختلفة من البيانات الوصفية لجهة الاتصال لمنصة response.io. فيما يلي قائمة ببيانات جهات الاتصال التي يمكنك الحصول عليها من هذه القناة:

• رقم التليفون
• معرف رقم الهاتف
• اسم الشخصية
• معرف Whatsapp

إدارة ملف تعريف WhatsApp Cloud API

الخطوة 1: انتقل إلى إعدادات القناة

من وحدة الإعدادات ، انتقل إلى عنصر القائمة ، القنوات .

الخطوة 2: حدد موقع قناة WhatsApp Cloud API

بمجرد تحديد موقع قناة WhatsApp Cloud API ، انقر فوق الملف الشخصي .

الخطوة 3: مزامنة الملف الشخصي

إذا لم تتم مزامنة الملف الشخصي ، فانقر فوق مزامنة الملف الشخصي للحصول على أحدث معلومات ملف تعريف WhatsApp للأعمال من WhatsApp.

الخطوة 4: قم بإجراء التغييرات اللازمة

يمكنك تعديل المعلومات حسب الحاجة.

الخطوة 5: احفظ التغييرات

راجع المعلومات وانقر فوق "حفظ" عندما تكون جاهزة.

إدارة قوالب رسائل WhatsApp

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

الخطوة 1: انتقل إلى إعدادات القناة

من وحدة الإعدادات ، انتقل إلى عنصر القائمة ، القنوات .

الخطوة 2: حدد موقع قناة WhatsApp Cloud API

بمجرد تحديد موقع قناة WhatsApp Cloud API ، انقر فوق القوالب .

الخطوة 3: إرسال النموذج

انقر فوق إرسال نموذج لإرسال قالب رسالة للموافقة عليه.

الخطوة 4: املأ المعلومات المطلوبة

املأ المعلومات المطلوبة لإنشاء نموذج.

الخطوة 5: ابدأ في إنشاء الرسالة

قم بإنشاء الرسالة عن طريق ملء المكونات الضرورية ، ثم قم بمراجعة الرسالة في قسم المعاينة.

الخطوة 6: تقديم قيمة العينة

لا ينطبق هذا إلا إذا قمت بتضمين أي معلمات في محتوى قالب رسالتك.

ارتباط هام

• إرشادات قالب رسائل WhatsApp

مزامنة قوالب الرسائل

الخطوة 1: انتقل إلى إعدادات القناة

من وحدة الإعدادات ، انتقل إلى عنصر القائمة ، القنوات .

الخطوة 2: حدد موقع قناة WhatsApp Cloud API

بمجرد تحديد موقع قناة WhatsApp Cloud API ، انقر فوق القوالب .

الخطوة 3: مزامنة القوالب

انقر فوق Sync Templates لبدء عملية المزامنة.

الخطوة 4: اكتملت المزامنة

عند اكتمال المزامنة ، سيتم سرد قوالب الرسائل مع الحالات المطابقة لها وسيتم تحديث وقت التاريخ الأخير الذي تمت مزامنته. سيتم عرض سبب الرفض أسفل نموذج الرسالة المرفوضة.

يسرد الجدول التالي الحالات المحتملة لقوالب الرسائل:

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

تعذر إرسال الرسائل

تأكد من أن الرقم الذي قمت بتوصيله بالمنصة هو رقم WhatsApp Cloud API.

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

الخطوة 1: انتقل إلى صفحة Webhook لتطبيق Facebook

افتح تطبيق Facebook وانتقل إلى صفحة Webhooks .

الخطوة 2: تحقق من الحدث المشترك

حدد Whatsapp Business Account وتحقق مما إذا كان حدث الرسائل مشتركًا.

الخطوة 3: إرسال رسالة اختبار

أرسل رسالة اختبار إلى رقم هاتف WhatsApp وتحقق من وصولها.

غير قادر على تلقي إعلامات القراءة

عندما يقوم المستخدم المتصل بـ WhatsApp Cloud API بتغيير كلمة مرور Facebook الخاصة به ، ستكون الأذونات قديمة وتحتاج إلى تحديث.

الخطوة 1: انتقل إلى إعدادات القناة

من وحدة الإعدادات ، انتقل إلى عنصر القائمة ، القنوات .

الخطوة 2: حدد موقع قناة WhatsApp Cloud API

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

الخطوة 3: تحديث الإذن

انقر فوق تحديث الإذن لتحديث أذونات WhatsApp.

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

أرسل رسالة اختبار إلى رقم هاتف WhatsApp وتحقق من وصولها.

تعذر إرسال الرسائل الصادرة: التحقق من خطأ رمز الوصول

يمكن أن يحدث هذا لعدة أسباب:

• عندما تنتهي صلاحية جلسة التحقق من رمز الوصول.
• تم تغيير امتياز المسؤول الخاص بالمستخدم في Meta Business Manager.
• تم تغيير كلمة المرور في Meta Business Manager.

لحل هذا الخطأ ، يجب عليك تحديث أذونات قناة WhatsApp Cloud API الخاصة بك وإرسال رسالة اختبار مرة أخرى.

جهة الاتصال لا تتلقى الرسائل

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

ما هي متطلبات رقم الهاتف المطلوب استخدامه للتسجيل في WhatsApp Cloud API؟

• لا يمكن استخدام رقم الهاتف المستخدم لـ WhatsApp Cloud API في تطبيق WhatsApp الشخصي أو التجاري. سيتعين عليك حذف الحساب على تطبيق WhatsApp الشخصي أو التجاري قبل أن تتمكن من استخدام الرقم للتسجيل في awhatsApp Cloud API.
• لا يزال بإمكانك استخدام الرقم لأغراض أخرى ، مثل الاتصال واستلام الرسائل القصيرة بعد تسجيله على WhatsApp Business Platform.
• بمجرد استخدام هاتف لـ WhatsApp Cloud API ، لن تتمكن من استخدام هذا الرقم في تطبيق WhatsApp Business.

هل يلزم التحقق من الأعمال لبدء استخدام Cloud API؟

ليس من الضروري إكمال التحقق من Facebook Business لبدء إرسال الرسائل على WhatsApp. بدون التحقق من النشاط التجاري ، سيظل نشاطك التجاري قادرًا على:

• الاستجابة للمحادثات غير المحدودة التي يبدأها المستخدم.
• أرسل المحادثات التي تبدأ بالعمل (قوالب الرسائل) إلى 50 عميلًا فريدًا في فترة 24 ساعة.

يمكن للشركات الشروع في التحقق من الأعمال فقط عندما تكون مستعدة لتوسيع نطاق المحادثات التجارية أو تريد أن تصبح حسابًا تجاريًا رسميًا.

هل يمكنني عرض رؤى المحادثة الخاصة بحسابي على WhatsApp Business؟

نعم ، يمكنك مراقبة رسائلك وتحليلات الإنفاق في الوقت الفعلي لحساب أعمال WhatsApp الخاص بك في علامة التبويب Insights في Meta WhatsApp Manager. اقرأ المزيد هنا .

ما هي حدود رسائل WhatsApp؟

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

كيف أضيف طريقة دفع إلى حساب WhatsApp Business الخاص بي؟

يمكنك إضافة طريقة دفع إلى حساب Whatsapp Business الخاص بك في Business Manager. تعرف على كيفية إضافة طريقة دفع إلى حساب WhatsApp Business الخاص بك هنا .

لماذا فشلت رسالتي في الإرسال مع ظهور الخطأ "مشكلة دفع أهلية العمل"؟

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

ما هو تسعير WhatsApp Cloud API؟

تنقسم محادثات WhatsApp Business Platform إلى فئتين يتم تسعيرهما بشكل مختلف:

• بدأها المستخدم: محادثة تبدأ استجابةً لرسالة مستخدم. عندما يرد نشاط تجاري على مستخدم خلال نافذة خدمة العملاء على مدار 24 ساعة ، سيتم ربط هذه الرسالة بمحادثة بدأها المستخدم. يمكن للشركات إرسال رسائل ذات شكل حر ضمن نافذة خدمة العملاء هذه على مدار 24 ساعة.
• بدء العمل: محادثة تبدأ من شركة ترسل للمستخدم رسالة خارج نافذة خدمة العملاء على مدار 24 ساعة. ستتطلب الرسائل التي تبدأ محادثة بمبادرة من العمل قالب رسالة .

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

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

كيف يمكنني حذف رقم هاتف من حساب تجاري؟

هناك بعض المتطلبات والخطوات اللازمة لحذف رقم هاتف ، اقرأ المزيد هنا .

هل يمكنني استخدام response.io لإرسال بث WhatsApp Cloud API برقم اختبار Meta؟

يمكنك إرسال بث اختباري من المنصة باستخدام رقم اختبار التعريف. ومع ذلك ، فإن البث باستخدام رقم الاختبار يقتصر على خمسة مستلمين. يجب عليك أولاً إضافة هؤلاء المستلمين الخمسة إلى قائمة أرقام الهاتف في أدوات Meta Developer.

إذا لم تقم بإضافة مستلمين إلى هذه القائمة أو إذا حاولت إرسال بث إلى مستلمين ليسوا في هذه القائمة ، فستتلقى رسالة الخطأ هذه:

هل يمكنني حذف رقم اختبار Meta من حساب Cloud API المتصل الخاص بي؟

لا ، يتم توفير هذا الرقم تلقائيًا لجميع الحسابات لاستخدامه في إرسال رسائل الاختبار ولا يمكن حذفه. فقط كن حذرًا لتلاحظ أن هذا رقم اختبار لا يجب استخدامه لأغراض أخرى.

لماذا أرى جهات اتصال مكررة من نفس قناة WhatsApp؟

يمرر WhatsApp رقم هاتف جهة الاتصال بتنسيق يختلف عن تنسيق E.164 الذي يستخدمه .io. يؤدي هذا الاختلاف إلى تكرار جهات الاتصال من بلدان معينة. في حالة حدوث ذلك ، تواصل معنا هنا .