راهنمای عیب یابی RBM

برای ارائه اطلاعات لازم برای عیب یابی مشکلات RBM، این راهنما را دنبال کنید.

امکان ارسال پیام های RBM وجود ندارد

برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:

  • نمونه شناسه پیام با مهر زمان
  • شناسه شریک (نگاه کنید به اسکرین شات )
  • تعداد عوامل تحت تأثیر
  • شناسه های عامل (با کاما از هم جدا شده اند)
  • تعداد تخمینی پیام‌هایی که تحت تأثیر قرار می‌گیرند یا احتمالاً تأثیر می‌گذارند
  • روش های API که با آنها مشکل دارید (به عنوان مثال: آپلود فایل ها، ایجاد پیام عامل به کاربر، ایجاد رویداد عامل به کاربر، حذف عامل به پیام کاربر، دریافت قابلیت ها، دریافت دسته ای)
  • نمونه بارگیری JSON از درخواست های ناموفق
  • برای مشکلات مشتری: گزارش اشکال مشتری
  • گزارش های خطا (خطایی که در ترمینال هنگام فراخوانی API های RBM مشاهده می شود)، از جمله کد خطا و پیام خطا. به عنوان مثال:

    "error": {
    "code": 403,
    "message": "There was an error looking up the RBM agent (ID: my-test-agent@rbm.goog) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.",
    "status": "PERMISSION_DENIED",
    }
    

تأخیر در انجام اقدامات 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

عدم دریافت رویدادها یا پیام ها در وب هوک

برای اطمینان از ارسال بی‌نظیر پیام، بررسی کنید که همه وبک‌هک‌های نماینده حساب شریک شما به درستی کار می‌کنند و می‌توانند پیام‌های Google را پردازش کنند. همه نمایندگان در یک حساب شریک یک کانال واحد را برای پیام‌ها و رویدادهای دریافتی به اشتراک می‌گذارند، بنابراین یک وب هوک نادرست می‌تواند تحویل همه نمایندگان را مختل کند.

اگر مشکل همچنان ادامه داشت، جزئیات زیر را به اشتراک بگذارید تا عیب‌یابی سریع‌تر فعال شود:

  • موضوع از چه زمانی شروع شد؟ آیا قبل از آن پیام ها و رویدادها را با موفقیت دریافت می کردید؟
  • شناسه شریک
  • شناسه های نماینده
  • آدرس وب هوک
  • شناسه پیام با مهر زمانی

نمونه هایی از این مشکل عبارتند از بارگیری نشدن، نمایش صفحه سیاه، برش و نمایش ندادن اقدامات پیشنهادی.

برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:

  • شناسه پیام با مهر زمانی
  • محموله JSON
  • مراحل دستگاه برای تکثیر در صورت شناخته شدن
  • گزارش اشکال از دستگاهی که پیام ها را دریافت می کند
  • جزئیات مربوط به دستگاه و نسخه برنامه پیام‌رسانی مورد استفاده
  • اسکرین شات یا ضبط ویدیو از مشکل

پیام‌های RBM به صورت JSON ارسال می‌شوند یا به SMS تبدیل می‌شوند

برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:

  • شناسه پیام با مهر زمانی
  • محموله JSON
  • مراحل دستگاه برای تکثیر در صورت شناخته شدن
  • گزارش اشکال از دستگاهی که پیام ها را دریافت می کند
  • جزئیات مربوط به دستگاه و نسخه برنامه پیام‌رسانی مورد استفاده
  • اسکرین شات یا ضبط ویدیو از مشکل

عدم ایجاد URL P2A یا کد QR

برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:

برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:

  • شناسه نماینده
  • شماره تلفن
  • مراحل تکثیر در صورت اطلاع
  • گزارش اشکال (از دستگاهی که پیوند باز شد)
  • اسکرین شات یا ضبط ویدیو از مشکل

دریافت پیام در دستگاه دارای RCS امکان پذیر نیست

برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:

  • گزارش اشکال از دستگاهی که پیام‌های RBM را دریافت نمی‌کند
  • شماره تلفن
  • جزئیات در مورد دستگاه و سیستم عامل
  • نسخه برنامه پیام رسانی استفاده شده است
  • مراحل تکثیر در صورت اطلاع
  • تصویر صفحه نمایش وضعیت RCS
  • اسکرین شات یا ضبط ویدیو از مشکل
  • نام شرکت و کشور

امکان افزودن آزمایشگر وجود ندارد

مراحل تنظیم یک دستگاه آزمایشی را دنبال کنید.

اگر مشکل همچنان ادامه داشت، جزئیات زیر را به اشتراک بگذارید تا عیب‌یابی سریع‌تر فعال شود:

  • شناسه نماینده
  • شماره تلفن
  • نام شرکت و کشور

دستگاه آزمایشی دعوت یا پیام آزمایش‌کننده را دریافت نمی‌کند

مراحل تنظیم یک دستگاه آزمایشی را دنبال کنید.

اگر مشکل همچنان ادامه دارد، جزئیات زیر را برای فعال کردن عیب‌یابی سریع‌تر به اشتراک بگذارید:

  • شناسه نماینده
  • شماره تلفن
  • شناسه پیام با مهر زمان
  • گزارش اشکال در عرض 5 دقیقه پس از ارسال دعوتنامه آزمایشی

مسائل مربوط به بررسی توانایی

برای فعال کردن عیب‌یابی سریع‌تر، جزئیات زیر را به اشتراک بگذارید:

  • فهرست شماره‌های تلفن همراه با کدهای کشور در یک فایل CSV
  • شناسه های نماینده
  • گزارش های خطا
  • وضعیت RCS دستگاه

اطلاعات از دست رفته در گزارش رویدادهای صورتحساب

برای فعال کردن عیب‌یابی سریع‌تر، جزئیات زیر را به اشتراک بگذارید:

  • تاریخ هایی که فایل ها برای آنها گم شده است
  • شناسه های نماینده

شرکت مخابراتی نمی‌تواند راه‌اندازی عامل را تأیید کند

مشکل را از کنسول مدیریت RBM گزارش کنید (نگاه کنید به تصویر صفحه ).

برای راه اندازی های فوری، لطفا ارائه دهید:

  • نام شرکت و کشور
  • شناسه عامل راه اندازی می شود
  • مجوز حامل برای راه اندازی

درخواست به روز رسانی جزئیات نماینده

برای فعال کردن به‌روزرسانی‌های سریع‌تر، جزئیات زیر را به اشتراک بگذارید:

  • شناسه نماینده
  • جزئیات فراداده ای که باید به روز شود (به عنوان مثال: نام، آرم، بنر، توضیحات، جزئیات تماس، پیوند خط مشی رازداری، یا پیوند شرایط خدمات)

درخواست انتقال نمایندگان به حساب شریک دیگر

برای فعال کردن به‌روزرسانی‌های سریع‌تر، جزئیات زیر را به اشتراک بگذارید:

  • لیست شناسه های نماینده
  • شناسه شریک قدیمی
  • شناسه شریک جدید
،

برای ارائه اطلاعات لازم برای عیب یابی مشکلات RBM، این راهنما را دنبال کنید.

امکان ارسال پیام های RBM وجود ندارد

برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:

  • نمونه شناسه پیام با مهر زمان
  • شناسه شریک (نگاه کنید به اسکرین شات )
  • تعداد عوامل تحت تأثیر
  • شناسه های عامل (با کاما از هم جدا شده اند)
  • تعداد تخمینی پیام‌هایی که تحت تأثیر قرار می‌گیرند یا احتمالاً تأثیر می‌گذارند
  • روش های API که با آنها مشکل دارید (به عنوان مثال: آپلود فایل ها، ایجاد پیام عامل به کاربر، ایجاد رویداد عامل به کاربر، حذف عامل به پیام کاربر، دریافت قابلیت ها، دریافت دسته ای)
  • نمونه بارگیری JSON از درخواست های ناموفق
  • برای مشکلات مشتری: گزارش اشکال مشتری
  • گزارش های خطا (خطایی که در ترمینال هنگام فراخوانی API های RBM مشاهده می شود)، از جمله کد خطا و پیام خطا. به عنوان مثال:

    "error": {
    "code": 403,
    "message": "There was an error looking up the RBM agent (ID: my-test-agent@rbm.goog) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.",
    "status": "PERMISSION_DENIED",
    }
    

تأخیر در انجام اقدامات 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

عدم دریافت رویدادها یا پیام ها در وب هوک

برای اطمینان از ارسال بی‌نظیر پیام، بررسی کنید که همه وبک‌هک‌های نماینده حساب شریک شما به درستی کار می‌کنند و می‌توانند پیام‌های Google را پردازش کنند. همه نمایندگان در یک حساب شریک یک کانال واحد را برای پیام‌ها و رویدادهای دریافتی به اشتراک می‌گذارند، بنابراین یک وب هوک نادرست می‌تواند تحویل همه نمایندگان را مختل کند.

اگر مشکل همچنان ادامه داشت، جزئیات زیر را به اشتراک بگذارید تا عیب‌یابی سریع‌تر فعال شود:

  • موضوع از چه زمانی شروع شد؟ آیا قبل از آن پیام ها و رویدادها را با موفقیت دریافت می کردید؟
  • شناسه شریک
  • شناسه های نماینده
  • آدرس وب هوک
  • شناسه پیام با مهر زمانی

نمونه هایی از این مشکل عبارتند از بارگیری نشدن، نمایش صفحه سیاه، برش و نمایش ندادن اقدامات پیشنهادی.

برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:

  • شناسه پیام با مهر زمانی
  • بار JSON
  • مراحل دستگاه برای تکثیر در صورت شناخته شدن
  • گزارش اشکال از دستگاهی که پیام ها را دریافت می کند
  • جزئیات مربوط به دستگاه و نسخه برنامه پیام‌رسانی مورد استفاده
  • اسکرین شات یا ضبط ویدیو از مشکل

پیام‌های RBM به صورت JSON ارسال می‌شوند یا به SMS تبدیل می‌شوند

برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:

  • شناسه پیام با مُهر زمان
  • بار JSON
  • مراحل دستگاه برای تکثیر در صورت شناخته شدن
  • گزارش اشکال از دستگاهی که پیام ها را دریافت می کند
  • جزئیات مربوط به دستگاه و نسخه برنامه پیام‌رسانی مورد استفاده
  • اسکرین شات یا ضبط ویدئو از مشکل

عدم ایجاد URL P2A یا کد QR

برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:

برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:

  • شناسه نماینده
  • شماره تلفن
  • مراحل تکثیر در صورت اطلاع
  • گزارش اشکال (از دستگاهی که پیوند باز شد)
  • اسکرین شات یا ضبط ویدئو از مشکل

دریافت پیام در دستگاه دارای RCS امکان پذیر نیست

برای فعال کردن عیب‌یابی سریع‌تر، تا حد امکان جزئیات زیر را به اشتراک بگذارید:

  • گزارش اشکال از دستگاهی که پیام‌های RBM را دریافت نمی‌کند
  • شماره تلفن
  • جزئیات در مورد دستگاه و سیستم عامل
  • نسخه برنامه پیام رسانی استفاده شده است
  • مراحل تکثیر در صورت اطلاع
  • تصویر صفحه نمایش وضعیت RCS
  • اسکرین شات یا ضبط ویدئو از مشکل
  • نام شرکت و کشور

امکان افزودن آزمایشگر وجود ندارد

مراحل تنظیم یک دستگاه آزمایشی را دنبال کنید.

اگر مشکل همچنان ادامه داشت، جزئیات زیر را به اشتراک بگذارید تا عیب‌یابی سریع‌تر فعال شود:

  • شناسه نماینده
  • شماره تلفن
  • نام شرکت و کشور

دستگاه آزمایشی دعوت یا پیام آزمایش‌کننده را دریافت نمی‌کند

مراحل تنظیم یک دستگاه آزمایشی را دنبال کنید.

اگر مشکل همچنان ادامه دارد، جزئیات زیر را برای فعال کردن عیب‌یابی سریع‌تر به اشتراک بگذارید:

  • شناسه نماینده
  • شماره تلفن
  • شناسه پیام با مهر زمان
  • گزارش اشکال در عرض 5 دقیقه پس از ارسال دعوتنامه آزمایشی

مسائل مربوط به بررسی توانایی

برای فعال کردن عیب‌یابی سریع‌تر، جزئیات زیر را به اشتراک بگذارید:

  • فهرست شماره‌های تلفن همراه با کدهای کشور در یک فایل CSV
  • شناسه های نماینده
  • گزارش های خطا
  • وضعیت RCS دستگاه

اطلاعات از دست رفته در گزارش رویدادهای صورتحساب

برای فعال کردن عیب‌یابی سریع‌تر، جزئیات زیر را به اشتراک بگذارید:

  • تاریخ هایی که فایل ها برای آنها گم شده است
  • شناسه های نماینده

شرکت مخابراتی نمی‌تواند راه‌اندازی عامل را تأیید کند

مشکل را از کنسول مدیریت RBM گزارش کنید (نگاه کنید به تصویر صفحه ).

برای راه اندازی های فوری، لطفاً ارائه دهید:

  • نام شرکت و کشور
  • شناسه عامل راه اندازی می شود
  • مجوز حامل برای راه اندازی

درخواست به روز رسانی جزئیات نماینده

برای فعال کردن به‌روزرسانی‌های سریع‌تر، جزئیات زیر را به اشتراک بگذارید:

  • شناسه نماینده
  • جزئیات فراداده ای که باید به روز شود (به عنوان مثال: نام، آرم، بنر، توضیحات، جزئیات تماس، پیوند خط مشی رازداری، یا پیوند شرایط خدمات)

درخواست انتقال نمایندگان به حساب شریک دیگر

برای فعال کردن به‌روزرسانی‌های سریع‌تر، جزئیات زیر را به اشتراک بگذارید:

  • لیست شناسه های نماینده
  • شناسه شریک قدیمی
  • شناسه شریک جدید