اتّبِع هذا الدليل لتقديم المعلومات اللازمة لتحديد المشاكل وحلّها في RBM.
المشاكل المتعلّقة بتسليم الرسائل وتنسيقها
وهي مشاكل في عملية إرسال الرسائل واستلامها، بما في ذلك مشاكل تنسيق الرسائل.
يتعذّر إرسال رسائل RBM
يُرجى مشاركة أكبر قدر ممكن من التفاصيل التالية لتسريع عملية تحديد المشاكل وحلّها:
- عيّنات من معرّفات الرسائل مع الطوابع الزمنية
- معرّف الشريك (راجِع لقطة الشاشة)
- عدد الموظفين المتأثرين
- أرقام تعريف الوكلاء (مفصولة بفواصل)
- العدد المقدَّر للرسائل المتأثرة أو التي يُحتمَل أن تتأثر
- طُرق واجهة برمجة التطبيقات التي تواجه مشاكل معها (على سبيل المثال: تحميل الملفات، وإنشاء رسالة من الوكيل إلى المستخدم، وإنشاء حدث من الوكيل إلى المستخدم، وحذف رسالة من الوكيل إلى المستخدم، والحصول على الإمكانات، والحصول على البيانات دفعة واحدة)
- نموذج لحِمل JSON للطلبات التي تعذّر تنفيذها
- بالنسبة إلى مشاكل العميل: تقرير أخطاء العميل
سجلات الأخطاء (الأخطاء التي تظهر في نافذة الأوامر عند طلب بيانات من واجهات برمجة تطبيقات RBM)، بما في ذلك رمز الخطأ ورسالة الخطأ على سبيل المثال:
"error": { "code": 403, "message": "There was an error looking up the RBM agent (ID: [email protected]) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.", "status": "PERMISSION_DENIED", }عدم تلقّي الأحداث أو الرسائل في Webhook
لضمان تسليم الرسائل بسلاسة، تأكَّد من أنّ جميع خطافات الويب الخاصة بوكلاء حساب الشريك تعمل بشكل صحيح ويمكنها معالجة الرسائل الواردة من Google. تتشارك جميع برامج الدردشة الآلية في حساب الشريك قناة واحدة لتلقّي الرسائل والأحداث الواردة، لذا يمكن أن يؤدي خلل في رمز ربط إلى تعطيل عمليات التسليم لجميع برامج الدردشة الآلية.
إذا استمرت المشكلة، يُرجى مشاركة التفاصيل التالية لتسريع عملية تحديد المشكلة وحلّها:
- متى بدأت المشكلة؟ هل كنت تتلقّى الرسائل والأحداث بنجاح قبل ذلك؟
- رقم تعريف الشريك
- معرّفات الوكلاء
- عنوان URL للردّ التلقائي على الويب
- معرّفات الرسائل مع الطوابع الزمنية
رسائل RBM المُرسَلة بتنسيق JSON أو المحوَّلة إلى رسائل SMS
يُرجى مشاركة أكبر قدر ممكن من التفاصيل التالية لتسريع عملية تحديد المشاكل وحلّها:
- معرّفات الرسائل مع الطوابع الزمنية
- حِمل JSON
- خطوات إعادة إظهار المشكلة على الجهاز، إذا كانت معروفة
- تقرير خطأ من الجهاز الذي يتلقّى الرسائل
- تفاصيل حول الجهاز وإصدار تطبيق المراسلة المستخدَم
- لقطة شاشة أو تسجيل فيديو للمشكلة
تعذُّر تلقّي الرسائل على جهاز متوافق مع خدمات الاتصالات التفاعلية (RCS)
يُرجى مشاركة أكبر قدر ممكن من التفاصيل التالية لتسريع عملية تحديد المشاكل وحلّها:
- تقرير خطأ من الجهاز الذي يتعذّر عليه تلقّي رسائل RBM
- رقم الهاتف
- تفاصيل حول الجهاز ونظام التشغيل
- إصدار تطبيق المراسلة المستخدَم
- خطوات إعادة إظهار المشكلة إذا كانت معروفة
- لقطة شاشة تعرض حالة RCS
- لقطة شاشة أو تسجيل فيديو للمشكلة
- اسم شركة النقل والبلد
مشاكل في إعداد/اتصال الأجهزة والبرامج
وتشمل هذه المشاكل عملية الإعداد من جهة العميل، والاتصال، والمشاكل الخاصة بالنظام الأساسي.
تعذُّر إنشاء عنوان URL أو رمز استجابة سريعة من نوع P2A
يُرجى مشاركة أكبر قدر ممكن من التفاصيل التالية لتسريع عملية تحديد المشاكل وحلّها:
- معرّف الوكيل
- تفاصيل خطأ JavaScript الذي يظهر في وحدة تحكّم المطوّرين في Business Communications
تعذُّر فتح رابط لصفحة معيّنة في تطبيق RBM
يُرجى مشاركة أكبر قدر ممكن من التفاصيل التالية لتسريع عملية تحديد المشاكل وحلّها:
- معرّف الوكيل
- رقم الهاتف
- خطوات إعادة إظهار المشكلة إذا كانت معروفة
- تقرير خطأ من الجهاز الذي تم فتح الرابط عليه
- لقطة شاشة أو تسجيل فيديو للمشكلة
مشاكل متعلقة بعمليات التحقّق من الإمكانات
شارِك التفاصيل التالية لتسريع عملية تحديد المشاكل وحلّها:
- قائمة بأرقام الهواتف مع رموز البلدان مضمّنة في ملف CSV
- معرّفات الوكلاء
- سجلّات الأخطاء
- حالة خدمات RCS على الجهاز
- تاريخ ووقت الاختبار الذي تم إجراؤه
عدم تلقّي الجهاز الاختباري دعوة أو رسائل من المختبِر
اتّبِع الخطوات الواردة في مقالة إعداد جهاز اختباري.
إذا استمرت المشكلة، يُرجى مشاركة التفاصيل التالية لتسريع عملية تحديد المشكلة وحلّها:
- معرّف الوكيل
- رقم الهاتف
- معرّف الرسالة مع الطابع الزمني
- تقرير خطأ خلال 5 دقائق من إرسال دعوة الاختبار
مشاكل RCS/RBM على أجهزة iOS
على الرغم من أنّ Apple اعتمدت معيار خدمات الاتصالات التفاعلية (RCS) للمراسلة، اختارت تطوير تنفيذ فريد خاص بها. ويشمل ذلك ميزات مثل "الرسائل من الشركات من RCS" (RBM).
إذا واجهت أي مشاكل في استخدام ميزة "المراسلة الغنية" على جهاز iOS، ننصحك بالإبلاغ عنها مباشرةً إلى Apple من خلال تطبيق Feedback Assistant. سيساعد ذلك شركة Apple في تحديد أي مشاكل خاصة بتنفيذها وحلّها.
- افتح تطبيق Feedback Assistant على جهاز iOS.
- اختَر موضوعًا مناسبًا للبدء، ويكون مرتبطًا بمشاكل في تطبيق مراسلة.
- اكتب ملاحظاتك وأرسِلها.
- لإبقاء فريق دعم ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" على اطّلاع، يُرجى أيضًا مشاركة النتائج التي توصلت إليها معنا. نشكرك على مساعدتنا في تحسين تجربة RCS للجميع.
توفُّر خدمات RCS/RBM على أجهزة iOS
تختار Apple مشغّلي شبكات الجوّال الذين ستتوفّر لهم خدمة RCS/RBM على أجهزة iOS. للاستفسار عن مدى التوفّر على مستوى العالم أو خطط Apple المستقبلية، يُرجى التواصل مع Apple مباشرةً. يمكنك أيضًا التواصل مع مشغل شبكة الجوّال الذي يهمّك لمعرفة حالة إطلاق خدمات RCS/RBM على أجهزة iOS.
للاطّلاع على معلومات حول دعم مشغّل شبكة الجوّال اللاسلكية وميزات iPhone حسب البلد، انتقِل إلى صفحة دعم Apple.
مشاكل في الأداء والعرض
هذه هي المشاكل المتعلّقة بأداء RBM وعرضها.
وقت الاستجابة عند تنفيذ إجراءات RBM
يُرجى التحقّق ممّا يلي أولاً:
| السؤال | الإجراء المقترَح |
|---|---|
هل وقت الاستجابة <5s؟ |
إذا كان الأمر كذلك، يكون هذا ضمن النطاق المقبول. |
| هل حدث أي تراجع في وقت الاستجابة؟ | إذا كان الأمر كذلك، متى بدأت؟ ما هو معدّل وقت الاستجابة المعتاد قبل مقارنته بالمعدّل الحالي؟ |
| هل تستخدم واجهة برمجة التطبيقات لتحميل الملفات؟ | جرِّب استخدام أرقام تعريف الملفات بدلاً من إرسال عناوين URL مباشرةً، لأنّ معالجة عناوين URL الجديدة للوسائط تتضمّن تنزيلها ومعالجتها وإنشاء صور مصغّرة لها وتوفير الحماية من إساءة الاستخدام والفيروسات، علمًا بأنّ الحماية من الفيروسات تستغرق حوالي% 50 من الوقت. |
| هل حمّلت وسائط الرسالة مسبقًا؟ | لتسريع عملية المعالجة، ننصحك بإجراء ذلك باستخدام طلب البيانات التالي من واجهة برمجة التطبيقات: https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create |
| هل أجريت عمليات تحقّق من الإمكانات؟ | للحدّ من وقت الاستجابة عند إرسال الرسائل إلى المستخدمين الذين لا يمكن الوصول إليهم من خلال خدمات الاتصالات التفاعلية (RCS)، عليك إجراء عمليات التحقّق من الإمكانات أولاً. |
في حال استمرار المشكلة، يُرجى تقديم أكبر قدر ممكن من التفاصيل الإضافية التالية لتسريع عملية تحديد المشكلة وحلّها:
- عدد الرسائل المتأثرة
- مصدر وقت الاستجابة (على سبيل المثال: تحميل الملفات، وإنشاء رسالة من الوكيل إلى المستخدم، وإنشاء حدث من الوكيل إلى المستخدم، وحذف رسالة من الوكيل إلى المستخدم، والحصول على الإمكانات، والحصول على مجموعة)
- نقطة نهاية الخدمة
- توزيع وقت الاستجابة (p50 وp95 وp99)
- التغيير في وقت الاستجابة والإطار الزمني
- رقم تعريف الشريك
- أرقام تعريف الوكلاء المتأثرة
- معرّفات الرسائل مع الطوابع الزمنية
- حِمل JSON
مشاكل في عرض منصّة العرض الدوّارة والبطاقات التفاعلية
تشمل أمثلة هذه المشكلة عدم التحميل، وعرض شاشة سوداء، والاقتصاص، وعدم ظهور الإجراءات المقترَحة.
يُرجى مشاركة أكبر قدر ممكن من التفاصيل التالية لتسريع عملية تحديد المشاكل وحلّها:
- معرّفات الرسائل مع الطوابع الزمنية
- حِمل JSON
- خطوات إعادة إظهار المشكلة على الجهاز، إذا كانت معروفة
- تقرير خطأ من الجهاز الذي يتلقّى الرسائل
- تفاصيل حول الجهاز وإصدار تطبيق المراسلة المستخدَم
- لقطة شاشة أو تسجيل فيديو للمشكلة
مشاكل إدارة الحسابات والوكلاء وشركات النقل
وهي مشاكل متعلّقة بإدارة الحساب وإعداد التقارير، بما في ذلك الاستفسارات المتعلّقة بالفوترة.
يتعذّر إضافة مختبِر
اتّبِع الخطوات الواردة في مقالة إعداد جهاز اختباري.
إذا استمرت المشكلة، يُرجى مشاركة التفاصيل التالية لتسريع عملية تحديد المشكلة وحلّها:
- معرّف الوكيل
- رقم الهاتف
- اسم شركة النقل والبلد
تعذُّر موافقة مشغّل شبكة الجوّال على تشغيل الوكلاء
يمكنك الإبلاغ عن المشكلة من خلال وحدة التحكم الإدارية لميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" (راجِع لقطة الشاشة).
بالنسبة إلى عمليات الإطلاق العاجلة، يُرجى تقديم ما يلي:
- اسم شركة النقل والبلد
- معرّف الوكيل الذي سيتم إطلاقه
- تفويض مشغّل شبكة الجوّال لإطلاق الفيديو
طلب تعديل تفاصيل الوكيل
شارِك التفاصيل التالية لتلقّي تحديثات أسرع:
- معرّفات الوكلاء
- التفاصيل التي تريد تغييرها
- تأكيدك على إلغاء إطلاق الوكيل
بالنسبة إلى الحقول التالية، سيوقف فريق دعم RBM إطلاق الوكيل. يمكنك بعد ذلك إجراء تغييرات على الوكيل وإعادة إرساله لإطلاقه.
- الاسم المعروض
- الوصف
- اللون
- صور الشعار وإعلان البانر
- معلومات الاتصال بالوكيل، مثل رقم الهاتف والموقع الإلكتروني وعنوان البريد الإلكتروني
- الخصوصية وبنود الخدمة
بالنسبة إلى الحقول التالية، سيوقف فريق دعم RBM إطلاق الوكيل كما سيعدّل الحقول (لا يمكن لشركاء RBM تعديل هذه الحقول مباشرةً):
- فئة الفوترة
- حالة الاستخدام
- اسم العلامة التجارية
- اسم جهة الاتصال لدى العلامة التجارية
- رقم تعريف عنوان البريد الإلكتروني الخاص بجهة الاتصال لدى العلامة التجارية
- عنوان URL للموقع الإلكتروني الخاص بالعلامة التجارية
- اسم جهة اتصال شريك المراسلة
- عنوان البريد الإلكتروني الخاص بجهة اتصال شريك المراسلة
إذا أردت تعديل معلومات الوكيل بدون إلغاء إطلاقه، يجب الحصول على موافقة عبر البريد الإلكتروني من جهات الاتصال في الشبكات التي تديرها شركات الاتصالات والتي تم إطلاق الوكيل فيها حاليًا. بعد جمع كل رسائل الموافقة الإلكترونية، شارِكها مع فريق دعم RBM، بالإضافة إلى تفاصيل التعديلات المطلوبة.
سيتحقّق فريق دعم RBM من الموافقات، وإذا كان كل شيء على ما يرام، سيُجري التغييرات ويؤكّدها لك وللمشغّلين المعنيين. يُرجى العِلم أنّ هذه العملية قد تختلف حسب إجراءات مشغّل شبكة الجوّال في البلدان المختلفة.
طلب إجراء تغييرات على حساب شريك في "إدارة الإعلانات على الأجهزة الجوّالة"
إذا كان لدى شريك RBM أي وكلاء تم إطلاقهم على شبكات تديرها شركات الاتصالات، اتّبِع الخطوات التالية:
- الحصول على موافقات عبر البريد الإلكتروني من جهات الاتصال في الشبكات التي يديرها مشغّل شبكة الجوّال والتي يتم فيها إطلاق أي من وكلائك
- يُرجى مشاركة التفاصيل التالية مع فريق دعم ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)":
- معرّف شريك "المراسلة الغنية"
- التفاصيل التي تريد تغييرها
بعد التحقّق من الموافقات والتفاصيل، سيُرسل فريق الدعم في RBM إشعارًا إلى مشغّلي شبكات الجوّال بشأن التغييرات المعلّقة. سيتم تنفيذ هذه التغييرات وتأكيدها خلال 24 ساعة من تلقّي إشعار شركة النقل.
طلب نقل وكيل من شريك RBM (أ) إلى شريك (ب)
إذا تم إطلاق الوكيل على شبكات يديرها مشغّل شبكة جوّال، اتّبِع الخطوات التالية:
- الحصول على موافقات عبر البريد الإلكتروني من جهة الاتصال الخاصة بالعلامة التجارية وجهات الاتصال في الشبكات التي تديرها شركات الاتصالات
- تأكَّد من إرسال نسخة من رسائل الموافقة الإلكترونية هذه إلى شريك RBM الجديد.
- يُرجى مشاركة التفاصيل التالية مع فريق دعم ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)":
- معرّفات الوكلاء
- الموافقات عبر البريد الإلكتروني من جهة الاتصال لدى العلامة التجارية ومن شركات النقل
- معرّف الشريك الجديد
بعد التحقّق من الموافقات والتفاصيل، سيُرسل فريق الدعم في RBM إشعارًا إلى مشغّلي شبكات الجوّال بشأن التغييرات المعلّقة. سيتم تنفيذ هذه التغييرات وتأكيدها خلال 24 ساعة من تلقّي إشعار شركة النقل.
طلب نقل وكلاء إلى حساب شريك آخر
شارِك التفاصيل التالية لتلقّي تحديثات أسرع:
- قائمة بمعرّفات الوكلاء
- رقم تعريف الشريك القديم
- معرّف الشريك الجديد
معلومات غير متوفّرة في تقارير أحداث الفوترة
شارِك التفاصيل التالية لتسريع عملية تحديد المشاكل وحلّها:
- التواريخ التي لا تتوفّر فيها الملفات
- معرّفات الوكلاء