برای ارائه اطلاعات لازم برای عیب یابی مشکلات RBM، این راهنما را دنبال کنید.
مشکلات ارسال و قالب پیام
اینها مشکلات مربوط به ارسال و دریافت واقعی پیام ها از جمله مشکلات قالب بندی پیام هستند.
امکان ارسال پیام های RBM وجود ندارد
برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:
- نمونه شناسه پیام با مهر زمان
- شناسه شریک (به تصویر صفحه مراجعه کنید)
- تعداد عوامل تحت تأثیر
- شناسه‌های نماینده (با کاما از هم جدا شده‌اند)
- تعداد تخمینی پیام‌هایی که تحت تأثیر قرار می‌گیرند یا احتمالاً تأثیر می‌گذارند
- روش های API که با آنها مشکل دارید (به عنوان مثال: آپلود فایل ها، ایجاد پیام عامل به کاربر، ایجاد رویداد عامل به کاربر، حذف عامل به پیام کاربر، دریافت قابلیت ها، دریافت دسته ای)
- نمونه بارگیری JSON از درخواست های ناموفق
- برای مشکلات مشتری: گزارش اشکال مشتری
گزارش های خطا (خطایی که در ترمینال هنگام فراخوانی API های 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", }عدم دریافت رویدادها یا پیام ها در وب هوک
برای ارسال یکنواخت پیام، بررسی کنید که همه وبکهک‌های عامل حساب شریک شما به درستی کار می‌کنند و می‌توانند پیام‌های Google را پردازش کنند. همه نمایندگان در یک حساب شریک یک کانال واحد را برای پیام‌ها و رویدادهای دریافتی به اشتراک می‌گذارند، بنابراین یک وب هوک نادرست می‌تواند تحویل همه نمایندگان را مختل کند.
اگر مشکل همچنان ادامه داشت، جزئیات زیر را به اشتراک بگذارید تا عیب‌یابی سریع‌تر فعال شود:
- موضوع از چه زمانی شروع شد؟ آیا قبل از آن پیام ها و رویدادها را با موفقیت دریافت می کردید؟
- شناسه شریک
- شناسه های نماینده
- آدرس وب هوک
- شناسه پیام با مهر زمانی
پیام‌های RBM به صورت JSON ارسال می‌شوند یا به SMS تبدیل می‌شوند
برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:
- شناسه پیام با مهر زمانی
- بار JSON
- مراحل دستگاه برای تکثیر در صورت شناخته شدن
- گزارش اشکال از دستگاهی که پیام ها را دریافت می کند
- جزئیات مربوط به دستگاه و نسخه برنامه پیام‌رسانی مورد استفاده
- اسکرین شات یا ضبط ویدئو از مشکل
دریافت پیام در دستگاه دارای RCS امکان پذیر نیست
برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:
- گزارش اشکال از دستگاهی که پیام‌های RBM را دریافت نمی‌کند
- شماره تلفن
- جزئیات در مورد دستگاه و سیستم عامل
- نسخه برنامه پیام رسانی استفاده شده است
- مراحل تکثیر در صورت اطلاع
- تصویر صفحه نمایش وضعیت RCS
- اسکرین شات یا ضبط ویدیو از مشکل
- نام شرکت و کشور
مشکلات راه اندازی/اتصال کلاینت و دستگاه
این مسائل شامل راه اندازی سمت مشتری، اتصال، و مشکلات خاص پلت فرم است.
عدم ایجاد URL P2A یا کد QR
برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:
- شناسه نماینده
- جزئیات خطای جاوا اسکریپت که در کنسول توسعه‌دهنده Business Communications مشاهده می‌شود
پیوند عمیق RBM باز نمی شود
برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:
- شناسه نماینده
- شماره تلفن
- مراحل تکثیر در صورت اطلاع
- گزارش اشکال از دستگاهی که پیوند در آن باز شده است
- اسکرین شات یا ضبط ویدیو از مشکل
مسائل مربوط به بررسی توانایی
برای فعال کردن عیب‌یابی سریع‌تر، جزئیات زیر را به اشتراک بگذارید:
- فهرست شماره‌های تلفن همراه با کدهای کشور در یک فایل CSV
- شناسه های نماینده
- گزارش های خطا
- وضعیت RCS دستگاه
- تاریخ و زمان آزمون انجام شده
دستگاه آزمایشی دعوت یا پیام آزمایش‌کننده را دریافت نمی‌کند
مراحل تنظیم یک دستگاه آزمایشی را دنبال کنید.
اگر مشکل همچنان ادامه داشت، جزئیات زیر را به اشتراک بگذارید تا عیب‌یابی سریع‌تر فعال شود:
- شناسه نماینده
- شماره تلفن
- شناسه پیام با مهر زمان
- گزارش اشکال در عرض 5 دقیقه پس از ارسال دعوتنامه آزمایشی
مشکلات RCS/RBM در دستگاه های iOS
در حالی که اپل استاندارد خدمات ارتباطی غنی (RCS) را برای پیام رسانی پذیرفته است، آنها تصمیم گرفته اند پیاده سازی منحصر به فرد خود را توسعه دهند. این شامل ویژگی هایی مانند RCS Business Messaging (RBM) می شود.
اگر با مشکلی در RBM در دستگاه iOS خود مواجه شدید، توصیه می کنیم آن را مستقیماً از طریق برنامه Feedback Assistant به اپل گزارش دهید. این به اپل کمک می‌کند تا مشکلات مربوط به اجرای آنها را شناسایی و برطرف کند.
- برنامه Feedback Assistant را در دستگاه iOS باز کنید.
- یک موضوع شروع مناسب، مربوط به مشکلات برنامه پیام‌رسانی را انتخاب کنید.
- بازخورد خود را بنویسید و ارسال کنید.
- برای در جریان نگه داشتن تیم پشتیبانی RBM، لطفاً یافته‌های خود را نیز با ما به اشتراک بگذارید . ما از کمک شما در بهبود تجربه RCS برای همه قدردانی می کنیم.
در دسترس بودن حامل RCS/RBM در دستگاه‌های iOS
اپل اپراتورهای خود را برای راه اندازی RCS/RBM در iOS دارد. برای پرس و جو در مورد در دسترس بودن جهانی یا برنامه های آینده اپل، مستقیماً با اپل تماس بگیرید. همچنین می‌توانید با شرکت مخابراتی مورد علاقه خود تماس بگیرید تا در مورد وضعیت راه‌اندازی RCS/RBM آنها در iOS سؤال کنید.
برای یافتن اطلاعات در مورد پشتیبانی و ویژگی های اپراتور بی سیم برای iPhone بر اساس کشور، از صفحه پشتیبانی اپل دیدن کنید.
مشکلات عملکرد و نمایش
اینها مشکلات مربوط به عملکرد و نمایش RBM است.
تأخیر در انجام اقدامات RBM
به یاد داشته باشید که ابتدا موارد زیر را بررسی کنید:
| سوال | توصیه |
|---|---|
آیا تاخیر <5s است؟ | اگر چنین است، این در محدوده قابل قبول قرار می گیرد. |
| آیا رگرسیون در تأخیر رخ داده است؟ | اگر چنین است، چه زمانی شروع شد؟ تأخیر معمولی قبلا در مقایسه با الان چقدر بود؟ |
| آیا از API آپلود فایل استفاده می کنید؟ | سعی کنید به جای ارسال URL های مستقیم از شناسه فایل استفاده کنید. پردازش URL های رسانه های جدید شامل دانلود، پردازش، ریز عکس ها، محافظت در برابر سوء استفاده و محافظت از ویروس است – که مورد دوم تقریباً 50٪ زمان را می گیرد. |
| آیا رسانه پیام را از قبل آپلود کرده اید؟ | برای سرعت بخشیدن به پردازش، توصیه می کنیم این کار را با تماس API زیر انجام دهید: https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create |
| آیا بررسی قابلیت ها را انجام داده اید؟ | برای کاهش تأخیر در ارسال پیام به کاربرانی که از طریق RCS قابل دسترسی نیستند، ابتدا بررسی های قابلیت را اجرا کنید. |
اگر مشکل همچنان ادامه داشت، لطفاً تا حد امکان جزئیات اضافی را برای عیب‌یابی سریع‌تر ارائه دهید:
- تعداد پیام های تحت تاثیر
- منبع تأخیر (به عنوان مثال: آپلود فایل ها، ایجاد پیام عامل به کاربر، ایجاد رویداد عامل به کاربر، حذف عامل به پیام کاربر، دریافت قابلیت ها، دریافت دسته ای)
- نقطه پایان خدمات
- توزیع تأخیر (p50، p95، p99)
- تغییر تاخیر و بازه زمانی
- شناسه شریک
- شناسه های عامل تحت تأثیر
- شناسه پیام با مهر زمانی
- محموله JSON
مشکلات رندر کارت و چرخ فلک
نمونه هایی از این مشکل عبارتند از بارگیری نشدن، نمایش صفحه سیاه، برش و نمایش ندادن اقدامات پیشنهادی.
برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:
- شناسه پیام با مهر زمانی
- محموله JSON
- مراحل دستگاه برای تکثیر در صورت شناخته شدن
- گزارش اشکال از دستگاهی که پیام ها را دریافت می کند
- جزئیات مربوط به دستگاه و نسخه برنامه پیام‌رسانی مورد استفاده
- اسکرین شات یا ضبط ویدیو از مشکل
مسائل مربوط به مدیریت حساب، نماینده و شرکت مخابراتی
اینها مشکلات مربوط به مدیریت و گزارش حساب، از جمله درخواست های صورتحساب است.
امکان افزودن آزمایشگر وجود ندارد
مراحل تنظیم یک دستگاه آزمایشی را دنبال کنید.
اگر مشکل همچنان ادامه داشت، جزئیات زیر را به اشتراک بگذارید تا عیب‌یابی سریع‌تر فعال شود:
- شناسه نماینده
- شماره تلفن
- نام شرکت و کشور
شرکت مخابراتی نمی‌تواند راه‌اندازی عامل را تأیید کند
مشکل را از کنسول مدیریت RBM گزارش کنید (نگاه کنید به تصویر صفحه ).
برای راه اندازی های فوری، لطفاً ارائه دهید:
- نام شرکت و کشور
- شناسه عامل راه اندازی می شود
- مجوز حامل برای راه اندازی
درخواست به روز رسانی جزئیات نماینده
برای فعال کردن به‌روزرسانی‌های سریع‌تر، جزئیات زیر را به اشتراک بگذارید:
- شناسه(های) نماینده
- جزئیاتی که می خواهید تغییر دهید
- تایید شما برای راه اندازی عامل
برای فیلدهای زیر، تیم پشتیبانی RBM عامل را راه اندازی می کند. سپس می‌توانید تغییراتی در عامل ایجاد کنید و دوباره آن را برای راه‌اندازی ارسال کنید .
- نام نمایشی
- توضیحات
- رنگ
- تصاویر لوگو و بنر
- اطلاعات تماس نماینده مانند شماره تلفن، وب سایت و آدرس ایمیل
- حریم خصوصی و شرایط خدمات
برای فیلدهای زیر، تیم پشتیبانی RBM عامل را راه‌اندازی می‌کند و همچنین فیلدها را اصلاح می‌کند (شریک‌های RBM نمی‌توانند مستقیماً این فیلدها را تغییر دهند):
- دسته صورتحساب
- مورد استفاده
- نام برند
- نام تماس با برند
- شناسه ایمیل تماس با برند
- آدرس وب سایت برند
- نام تماس شریک پیام رسانی
- ایمیل تماس شریک پیام رسانی
اگر می‌خواهید اطلاعات نماینده را بدون راه‌اندازی عوامل تغییر دهید، تأیید ایمیل را از مخاطبین شبکه‌های تحت مدیریت شرکت مخابراتی که نماینده در حال حاضر راه‌اندازی می‌کند، دریافت کنید. پس از جمع‌آوری ایمیل‌های تأیید، آنها را با تیم پشتیبانی RBM به همراه مشخصات تغییرات مورد نیاز به اشتراک بگذارید.
تیم پشتیبانی RBM تأییدیه‌ها را تأیید می‌کند و اگر همه چیز درست باشد، تغییرات را اجرا کرده و با شما و اپراتورهای مربوطه تأیید می‌کند. توجه داشته باشید که این فرآیند ممکن است بسته به رویه های حامل فردی در کشورهای مختلف متفاوت باشد .
درخواست تغییرات در حساب شریک RBM
اگر شریک RBM هر عاملی را در شبکه های مدیریت شده توسط شرکت مخابراتی راه اندازی کرده است، این مراحل را دنبال کنید:
- تأییدیه‌های ایمیلی را از مخاطبین شبکه‌های تحت مدیریت شرکت مخابراتی که هر یک از نمایندگان شما راه‌اندازی شده‌اند، دریافت کنید.
- جزئیات زیر را با پشتیبانی RBM به اشتراک بگذارید:
- شناسه شریک RBM
- جزئیاتی که می خواهید تغییر دهید
پس از بررسی تاییدیه ها و جزئیات، تیم پشتیبانی RBM تغییرات معلق را به اپراتورها اطلاع می دهد. این تغییرات ظرف 24 ساعت پس از اطلاع رسانی آن شرکت مخابراتی اجرا و تأیید می شود.
درخواست مهاجرت یک عامل از شریک RBM A به شریک B
اگر عامل قبلاً در شبکه های مدیریت شده توسط شرکت مخابراتی راه اندازی شده است، مراحل زیر را دنبال کنید:
- تأییدیه‌های ایمیلی را از مخاطبین برند و مخاطبین در شبکه‌های تحت مدیریت شرکت مخابراتی دریافت کنید.
- مطمئن شوید که شریک جدید RBM در این ایمیل‌های تأیید کپی شده است.
- جزئیات زیر را با پشتیبانی RBM به اشتراک بگذارید:
- شناسه های نماینده
- تأییدیه های ایمیل از مخاطبین برند و شرکت های مخابراتی
- شناسه شریک جدید
پس از بررسی تاییدیه ها و جزئیات، تیم پشتیبانی RBM تغییرات معلق را به اپراتورها اطلاع می دهد. این تغییرات ظرف 24 ساعت پس از اطلاع رسانی آن شرکت مخابراتی اجرا و تأیید می شود.
درخواست انتقال نمایندگان به حساب شریک دیگر
برای فعال کردن به‌روزرسانی‌های سریع‌تر، جزئیات زیر را به اشتراک بگذارید:
- لیست شناسه های نماینده
- شناسه شریک قدیمی
- شناسه شریک جدید
اطلاعات از دست رفته در گزارش رویدادهای صورتحساب
برای فعال کردن عیب‌یابی سریع‌تر، جزئیات زیر را به اشتراک بگذارید:
- تاریخ هایی که فایل ها برای آنها گم شده است
- شناسه های نماینده