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