respond-io
New
🚀 TikTok Business Messaging مباشرة! تحويل المحادثات إلى تحويلات بسلاسة. اعرف المزيد.
arrow-icon

الصفحة الرئيسية >

القنوات >
WhatsApp >
واتسآب API السحابي

واتسآب API السحابي

Avatar
JQ Lee
· 23 Jul 2024
less than a minute read

يمكنك الآن ترحيل حسابك المتصل بواجهة برمجة تطبيقات WhatsApp 360dialog إلى واجهة برمجة تطبيقات WhatsApp للأعمال respond.io للاستمتاع بمستوى أعلى من الموثوقية، وتقليل التكاليف، والوصول إلى ميزات جديدة. تعرف على المزيد حول عملية الترحيل هنا.

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

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

تتمتع هذه القناة بفترة مراسلة محدودة تبلغ 24 ساعة بسبب لوائح WhatsApp. تعرف على المزيد حول سياسة الأعمال لـ WhatsApp هنا.

توصيل واجهة برمجة تطبيقات WhatsApp Cloud.

شاهد الفيديو أدناه للحصول على دليل خطوة بخطوة حول كيفية توصيل واجهة برمجة تطبيقات WhatsApp Cloud بـ respond.io.

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

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

الخطوة 1: انتقل إلى إعدادات مساحة العمل > انقر أضف قناة.

الخطوة 2: حدد موقع قناة واجهة برمجة تطبيقات WhatsApp Cloud > انقر اتصال..

الخطوة 3: انقر على زر الاتصال مع فيسبوك.

الخطوة 4: قم بتسجيل الدخول باستخدام حساب فيسبوك الذي يملك حق الوصول كمشرف إلى تطبيق فيسبوك وحساب الأعمال Meta.

الخطوة 5: في القائمة المنسدلة، حدد اسم WABA مع رقم WhatsApp الذي ترغب في الاتصال به.

الخطوة 6: إضافة رابط الاستدعاء. ارجع إلى قسم WhatsApp في تطبيق مطور الفيسبوك. انتقل إلى القسم الفرعي الإعدادات وقم بإعداد رابط الاستدعاء. أضف رابط الاستدعاء الذي تم إنشاؤه وتحقق من الرمز المميز من respond.io إلى الحقول المقابلة في مربع الحوار الخاص بـ webhook.

الخطوة 7: على تطبيق الفيسبوك، تحقق من التغييرات في التطبيق واحفظها.

الخطوة 8: الاشتراك في حدث webhook. على تطبيق فيسبوك الخاص بك، حدد علامة التبويب الويب هوك تحت لوحة المنتجات واختر حساب WhatsApp Business من القائمة المنسدلة. انقر على حدث الاشتراك في الرسائل.

الخطوة 9: انقر فوق الزر في الجزء العلوي من الصفحة لتفعيل الوضع المباشر.

تذكر أن تملأ رابط سياسة الخصوصية الخاصة بك. إذا كان هذا فارغاً، فلن يُسمح لك بتشغيل الوضع المباشر.

الخطوة 10: انقر فوق حفظ التغييرات لإكمال الإعداد.

بمجرد اكتمال الإعداد، سيتم الآن استقبال أي رسائل مرسلة إلى رقم WhatsApp الخاص بك في مساحة العمل الخاصة بك.

تكوين القناة.

يمكن تكوين قناة واجهة برمجة تطبيقات WhatsApp Cloud باسم قناة فريد.

الخطوة 1: انتقل إلى إعدادات مساحة العمل > انقر القنوات.

الخطوة 2: حدد موقع قناة واجهة برمجة تطبيقات WhatsApp Cloud > انقر إدارة..

الخطوة 3: قم بتكوين اسم القناة، والذي يستخدم داخليًا لتحديد الحساب.

الخطوة 4: انقر حفظ التغييرات لتحديث تكوين القناة.

بيانات التعريف المستلمة بواسطة القناة.

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

  • رقم الهاتف

  • معرّف الهاتف.

  • اسم الملف الشخصي.

  • معرّف WhatsApp.

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

إذا كانت هناك حاجة لإجراء تغيير أو التحقق من ملف تعريف WhatsApp Cloud API الخاص بك، فيمكن القيام بذلك على منصة respond.io.

الخطوة 1: انتقل إلى إعدادات مساحة العمل > انقر القنوات.

الخطوة 2: حدد موقع قناة WhatsApp Cloud API > انقر إدارة > الملف الشخصي..

الخطوة 3: انقر على "مزامنة الملف الشخصي" للحصول على أحدث معلومات ملف تعريف WhatsApp Business من WhatsApp.

الخطوة 4: حرر المعلومات التالية حسب الحاجة.

الحقول.

الوصف.

صورة الملف الشخصي.

الصورة المعروضة كصورة شخصية لحساب WhatsApp للأعمال. يوصى بحجم صورة 640x640.

حول.

النص حول العمل. يظهر هذا النص في الملف الشخصي للعمل تحت صورة الملف الشخصي، ورقم الهاتف، وأزرار الاتصال.

العنوان.

عنوان العمل. الحد الأقصى 256 حرفاً.

الوصف.

وصف العمل. حد أقصى 512 حرفاً.

البريد الإلكتروني.

عنوان البريد الإلكتروني (بتنسيق بريد إلكتروني صالح) للاتصال بالشركة. الحد الأقصى 128 حرفاً.

عمودي.

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

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

عناوين URL (بما في ذلك http:// أو https://) المرتبطة بالأعمال التجارية (على سبيل المثال، الموقع، صفحة الفيسبوك، Instagram). حد أقصى موقعين على الويب بحد أقصى 256 حرفاً لكل منهما.

الخطوة 5: راجع المعلومات وانقر على حفظ التغييرات.

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

قبل إرسال قالب رسالة إلى جهة اتصال على منصة respond.io، تأكد من أنك قد قمت بما يلي:

- قدم قالب الرسالة للموافقة- أضف قالب الرسالة الموافق عليه إلى مساحة العمل عن طريق مزامنة قالب الرسالة.

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

الخطوة 1: انتقل إلى إعدادات مساحة العمل > انقر قنوات.

الخطوة 2: حدد موقع قناة واجهة برمجة التطبيقات السحابية لواتساب > انقر إدارة.

الخطوة 3: انقر فوق القوالب > تقديم القالب لتقديم قالب رسالة للموافقة عليه.

الخطوة 4: ملء المعلومات المطلوبة لإنشاء قالب.

الحقل

الوصف

اسم القالب

يمكن أن يحتوي الاسم فقط على أحرف أبجدية رقمية صغيرة ورموز سفلية ( _ ) وذلك.

الفئة

الفئة التي ينتمي إليها قالب الرسالة.

اللغة

اللغة التي تم كتابة القالب بها.

الخطوة 5: إنشاء الرسالة عن طريق ملء المكونات الضرورية، ثم مراجعة الرسالة في قسم المعاينة. يمكنك تضمين البارامترات 1، 2، إلخ. كعناصر النائبة التي سيتم ملؤها بمحتوى شخصي.

كتلة بناء

الوصف

الجسم

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

رأس الصفحة

الترويسة اختيارية وهي تعمل كعنوان أو رأس للقالب الخاص بك. يدعم ما يلي:
- النص
- الصورة
- الفيديو
- المستند

* الرد. o المنصة تقبل تحميل ما يصل إلى 20 ميغابايت في الحجم.

تذييل

تذييل الصفحة اختياري ويدعم النص فقط. يمكن استخدامه لتوفير معلومات تكميلية في قالب الرسالة الخاص بك.

الزر

الزر اختياري ويضيف التفاعل إلى القوالب الخاصة بك. هناك نوعان متاحان:
Call to Action button
- يستخدم لإرسال عميلك إلى موقع ويب أو الاتصال برقم هاتف
- الحد الأقصى لعنوان URL ورقم الهاتف لكل قالب
- يمكن أن يحتوي عنوان URL على معلمة أو تخصيص سريع

زر الرد
- يستخدم للحصول على إجابات سريعة من العميل
- الحد الأقصى 3 أزرار الرد السريع لكل قالب
- كل زر الرد السريع لا يمكن أن يحتوي على أكثر من 20 حرف

* أزرار الرد السريع فقط على OiS اندرويد ومنصات الويب، ولكن ليس على منصة ويندوز. يرجى الرجوع إلى المزيد من التفاصيل هنا.

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

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

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

رابط هام: إرشادات قالب رسالة WhatsApp

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

الخطوة 2: حدد موقع قناة منصة الأعمال في WhatsApp (API) > انقر إدارة.

الخطوة 3: انقر فوق القوالب > مزامنة القالب.

الخطوة 3: انقر فوق القوالب > مزامنة القالب لبدء عملية المزامنة.

لقد اكتملت عملية المزامنة. وهذا يعني:

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

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

الحالة

الوصف

مُقدم

يتم إرسال قالب الرسالة وفي انتظار الموافقة.

معتمد

تمت الموافقة على قالب الرسالة ويمكن إرساله إلى جهات الاتصال.

مرفوض

تم رفض قالب الرسالة ولا يمكن استخدامه.

استخدم البحث والفلتر في الجزء العلوي الأيمن من القائمة للعثور بسهولة على القوالب الخاصة بك!

أنواع الملفات المدعومة

نوع الملف الذي يدعمه WhatsApp والحد الأقصى لحجم الملف لهذا النوع هو كما يلي:

  • الصوت & فيديو (16MB)

  • الوثيقة (100 ميغابايت)

  • صورة (5 ميغابايت)

  • ملصق (100 كيلو بايت)

الرسائل غير المدعومة سوف تحتوي على عرض احتياطي مع رسالة غير مدعومة أو نص الحمولة المخصصة ونوعها (إذا كانت متاحة). لأي نوع أو ملف غير مدعوم يتجاوز الحد الأقصى لحجم الملف المرسلة عبر واتسآب Cloud API سيتم تحويل الملف تلقائياً إلى رابط URL على الرد. o المنصة. بالنسبة للحملات المخصصة، يمكنك النقر فوق إظهار المزيد لرؤية حمولة JSON لهذه الرسالة. أمثلة للرسائل غير المدعومة ل WhatsApp Cloud API هي:
- بطاقة الاتصال
- ردود الفعل
- الرسالة المحذوفة
- استطلاعات الرأي
- رسالة زمرية

حدود المعدل

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

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

غير قادر على إرسال الرسائل

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

الرسائل ليست قادمة

هذا يمكن أن يحدث عندما لا يتم الاشتراك في الرسائل webhook.

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

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

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

حدد حساب أعمال WhatsApp والتحقق مما إذا كان الحدث الرسائل مشترك.

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

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

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

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

الخطوة 1: انتقل إلى إعدادات مساحة العمل > انقر على القنوات.

الخطوة 2: حدد موقع قناة منصة WhatsApp للأعمال (API) > انقر إدارة.

الخطوة 3: انقر فوق استكشاف الأخطاء >تحديث الإذنلتحديث أذونات WhatsApp.

الخطوة 4: أرسل رسالة اختبار إلى رقم هاتف WhatsApp وتحقق مما إذا كانت قد وصلت.

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

ويمكن أن يحدث ذلك لأسباب قليلة:

  • عند انتهاء صلاحية الجلسة للتحقق من صحة رمز الوصول.

  • حدث تغيير في امتيازات المشرف في إدارة أعمال ميتا.

  • تم تغيير كلمة المرور في Meta Business Manager.

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

يجب أن تكون مدير أعمال Meta لتتمكن من تحديث الإذن.

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

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

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

ما هي المتطلبات رقم الهاتف الذي يمكن استخدامه للتسجيل في واجهة برمجة التطبيقات السحابية لواتساب؟

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

  • لا يزال بإمكانك استخدام الرقم لأغراض أخرى، مثل الاتصال واستقبال الرسائل القصيرة بعد تسجيلها على منصة الأعمال في WhatsApp.

  • بمجرد استخدام هاتف لواتسآب API لم يعد بإمكانك استخدام هذا الرقم على تطبيق WhatsApp.

هل التحقق من الأعمال مطلوب لبدء استخدام API السحابية؟

ليس إلزامياً إكمال التحقق من أعمال الفيس بوك لبدء إرسال رسائل على WhatsApp. بدون التحقق من العمل التجاري، سيظل عملك قادرا على:

  • الرد على المحادثات غير المحدودة التي بدأها المستخدم.

  • إرسال محادثات(قوالب الرسائل) التجارية إلى 250 عميلا فريدا في فترة 24 ساعة.

  • تسجيل ما يصل إلى رقمي هاتف.

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

هل يمكنني عرض رؤى محادثتي لحسابي التجاري في WhatsApp؟

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

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

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

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

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

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

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

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

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

تعرف على المزيد حول WhatsApp Pricing هنا.

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

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

هل يمكنني استخدام جواب.io لإرسال واجهة برمجة تطبيقات WhatsApp Cloud بالبث باستخدام رقم اختبار Meta؟

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

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

هل يمكنني حذف رقم اختبار Meta من حسابي على واجهة برمجة التطبيقات السحابية؟

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

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

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

كيف يمكنني تغيير اسم عرض API الخاص بي السحابية؟

إلى قم بتغيير اسم عرض API السحابي، قم باتباع الخطوات التالية:

  1. انتقل إلى FBM > حساب WhatsApp > رقم الهاتف. تعرض هذه الصفحة حد الرسائل ونوعيتها.

  2. فوق رمز القلم الرصاص بجوار اسم العرض لتمكين التحرير.

  3. انقر فوق التالي لإرسال اسم العرض الجديد إلى Meta للموافقة عليه.

  4. في انتظار تأكيد الموافقة من ميتا.

ما هي الخطوات التي يجب أن أتخذها بمجرد الموافقة على اسم العرض الجديد لواجهة برمجة التطبيقات الخاصة بي السحابية؟

بعد تلقي الموافقة من Meta على اسم العرض الجديد الخاص بك، أكمل الخطوات التالية:

  1. أعد تسجيل رقم الهاتف الخاص بك باستخدام اسم العرض المعتمد حديثا.

  2. تنفيذ مكالمة API POST إلى التحقق من رقم هاتفك.

  3. إجراء مكالمة API POST أخرى إلى إعادة تسجيل رقم الهاتف المتحقق منه.

  4. بمجرد أن يكون ناجحًا، يكون تحديث اسم واجهة برمجة التطبيقات السحابية لديك مكتملًا.

لماذا واجهت الخطأ "خطأ في التحقق من صحة رمز الوصول: تم إبطال الجلسة لأن المستخدم قام بتغيير كلمة المرور الخاصة به أو قام الفيسبوك بتغيير الجلسة لأسباب أمنية" عند محاولة إرسال رسالة؟

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

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

مشاركة هذه المقالة
Telegram
Facebook
Linkedin
Twitter

المقالات ذات الصلة 👩‍💻

منصة أعمال WhatsApp (API) البداية السريعة
احصل على حساب API لمنصة أعمال WhatsApp بسرعة لبدء الدردشة مع عملائك.
التعايش عبر واتساب
تعرف على كيفية ربط تطبيق WhatsApp Business بـ response.io لتسهيل المراسلة والأتمتة.
جاهز للمحادثات الواردة
تعرف على نوافذ المحادثة، إرسال قوالب الرسائل وإعداد نقطة دخول بسيطة لإدارة رسائل واتساب من عملائك.
مستعد للرسائل الترويجية
تعلم كيفية بث الرسائل الترويجية باستخدام قوالب رسائل WhatsApp.
حساب الأعمال الرسمية في WhatsApp (علامة زرقاء)
تعلم كيفية الحصول على حساب الأعمال الرسمية في WhatsApp.

لا يمكن العثور على ما تبحث عنه؟ 🔎