كيفية إعداد WhatsApp Business Calling API

تفعيل WhatsApp Business Calling API لا يعني أن قناة الاتصال أصبحت جاهزة للعمل. قد يظهر زر الاتصال، لكن الإطلاق الحقيقي يحتاج رقماً مؤهلاً على Cloud API، وإعدادات واضحة، وربطاً للإشارات والصوت، وقواعد للإذن، وساعات عمل، ومالكاً لكل مكالمة، ومساراً مجرباً عندما لا يجيب أحد.

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

ابدأ ببوابة الرقم والحساب

توضح وثائق Meta الحالية لواجهة الاتصال أن رقم الشركة يجب أن يعمل على Cloud API لا على تطبيق WhatsApp Business. يجب أن يكون التطبيق المرتبط بالرقم مشتركاً في WhatsApp Business Account وفي حقل webhook المسمى calls، وأن يملك صلاحية whatsapp_business_messaging.

الاتصال معطل افتراضياً. وتشترط Meta أيضاً أن يكون حد المراسلة اليومي للشركة 2,000 مستلم فريد على الأقل قبل تفعيل الاتصال على رقم إنتاج. أما أرقام الاختبار العامة وحسابات sandbox المؤهلة فتسمح باختبار الميزة من دون بلوغ هذا الحد الإنتاجي.

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

حدد من يتصل بمن

تدعم الواجهة مسارين مختلفين. في المكالمة التي يبدأها المستخدم يتصل عميل WhatsApp بالشركة. وفي المكالمة التي تبدأها الشركة تتصل الشركة بالمستخدم.

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

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

اضبط تحكم العميل قبل إظهار زر الاتصال

زر الاتصال المرئي يوحي بأن شخصاً سيجيب. اضبط هذا الوعد قبل عرضه.

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

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

اربط الإشارات والوسائط بوضوح

تستخدم البنية الافتراضية Graph API وwebhooks للإشارات وWebRTC للصوت. كما توثق Meta خيارات SIP للفرق التي تربط منصة صوتية قائمة. اختر المسار مبكراً لأن تفعيل SIP يغير طريقة استخدام نقاط الاتصال وwebhooks.

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

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

اختبر مسار العميل كاملاً

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

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

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

أبق الاتصال مرتبطاً بالمحادثة

تقل فائدة الاتصال عندما تبقى النتيجة في أداة صوت منفصلة. يجب أن يرى الوكيل التالي أن مكالمة حدثت، ومن امتلكها، وكيف انتهت، وما الخطوة التالية. ملاحظة نتيجة قصيرة أنفع غالباً من مدة خام.

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

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

الأسئلة الشائعة

ما المطلوب لتفعيل WhatsApp Business Calling API

تحتاج رقماً مؤهلاً على WhatsApp Business Platform وCloud API، واشتراكات التطبيق وwebhooks المطلوبة، وصلاحية whatsapp_business_messaging، وحد إنتاج مناسب، وإعدادات اتصال مفعلة، ومسار إشارات وصوت يعمل.

هل تستطيع الشركة الاتصال بأي مستخدم WhatsApp

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

هل يختار الفريق WebRTC أم SIP

استخدم WebRTC عندما يدير التطبيق إشارات Graph API والوسائط مباشرة. وفكر في SIP عند ربط منصة صوتية قائمة. يؤثر الخيار في التشغيل ونقاط الاتصال والتصحيح، لذلك اتخذه قبل التنفيذ.

كيف يختبر الفريق الإعداد

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