Следуйте этому руководству, чтобы получить необходимую информацию для устранения неполадок с 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. Все агенты в партнёрском аккаунте используют один канал для входящих сообщений и событий, поэтому неисправный вебхук может нарушить доставку сообщений для всех агентов.
Если проблема не устранена, предоставьте следующую информацию для более быстрого устранения неполадок:
- Когда возникла проблема? До этого вы успешно получали сообщения и события?
- Идентификатор партнера
- Идентификаторы агентов
- URL-адрес веб-перехватчика
- Идентификаторы сообщений с временными метками
Сообщения RBM отправляются в формате JSON или преобразуются в SMS
Предоставьте как можно больше из следующих сведений для более быстрого устранения неполадок:
- Идентификаторы сообщений с временными метками
- полезная нагрузка JSON
- Действия по воспроизведению устройства, если они известны
- Отчет об ошибке с устройства, получающего сообщения
- Подробная информация об используемом устройстве и версии приложения для обмена сообщениями
- Скриншот или видеозапись проблемы
Невозможно получать сообщения на устройстве с поддержкой RCS
Предоставьте как можно больше из следующих сведений для более быстрого устранения неполадок:
- Отчет об ошибке устройства, не получающего сообщения RBM
- Номер телефона
- Подробная информация об устройстве и ОС
- Используемая версия приложения для обмена сообщениями
- Действия по воспроизведению, если они известны
- Скриншот, показывающий статус RCS
- Скриншот или видеозапись проблемы
- Название и страна перевозчика
Проблемы с настройкой/подключением клиента и устройства
К этим проблемам относятся проблемы с настройкой на стороне клиента, подключением и проблемами, связанными с платформой.
Не удалось сгенерировать URL-адрес P2A или QR-код
Предоставьте как можно больше из следующих сведений для более быстрого устранения неполадок:
- Идентификатор агента
- Подробная информация об ошибке JavaScript, обнаруженной в консоли разработчика Business Communications
Невозможно открыть глубокую ссылку RBM
Предоставьте как можно больше из следующих сведений для более быстрого устранения неполадок:
- Идентификатор агента
- Номер телефона
- Действия по воспроизведению, если они известны
- Отчет об ошибке с устройства, на котором была открыта ссылка
- Скриншот или видеозапись проблемы
Проблемы с проверкой возможностей
Для более быстрого устранения неполадок предоставьте следующую информацию:
- Список телефонных номеров с кодами стран, включенный в CSV-файл
- Идентификаторы агентов
- Журналы ошибок
- Статус RCS устройства
- Дата и время проведения теста
Тестовое устройство не получает приглашения или сообщения тестировщика.
Следуйте инструкциям из раздела Настройка тестового устройства .
Если проблема не устранена, предоставьте следующую информацию для более быстрого устранения неполадок:
- Идентификатор агента
- Номер телефона
- Идентификатор сообщения с отметкой времени
- Отчет об ошибке в течение 5 минут после отправки приглашения на тестирование
Проблемы RCS/RBM на устройствах iOS
Хотя Apple внедрила стандарт Rich Communication Services (RCS) для обмена сообщениями, компания решила разработать собственную уникальную реализацию. Она включает такие функции, как RCS Business Messaging (RBM).
Если у вас возникнут какие-либо проблемы с RBM на вашем устройстве iOS, мы рекомендуем вам сообщить о них непосредственно в Apple через приложение Feedback Assistant. Это поможет Apple выявить и устранить любые неполадки, связанные с реализацией RBM.
- Откройте приложение Feedback Assistant на устройстве iOS.
- Выберите подходящую начальную тему, связанную с проблемами в приложении для обмена сообщениями.
- Напишите и отправьте свой отзыв.
- Чтобы держать службу поддержки RBM в курсе событий, пожалуйста, поделитесь с нами своими результатами . Мы ценим вашу помощь в улучшении работы RCS для всех.
Доступность оператора RCS/RBM на устройствах iOS
Apple самостоятельно выбирает операторов для запуска RCS/RBM на iOS. Чтобы узнать о глобальной доступности или планах Apple на будущее, свяжитесь напрямую с Apple. Вы также можете обратиться к интересующему вас оператору, чтобы узнать о статусе запуска RCS/RBM на iOS.
Информацию о поддержке операторов беспроводной связи и функциях iPhone в разных странах можно найти на странице поддержки Apple .
Проблемы с производительностью и отображением
Это проблемы с производительностью и отображением 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 не могут изменять эти поля напрямую):
- Категория выставления счетов
- Вариант использования
- Название бренда
- Контактное лицо бренда
- Идентификатор контактной электронной почты бренда
- URL-адрес веб-сайта бренда
- Контактное имя партнера по обмену сообщениями
- Контактный адрес электронной почты партнера по обмену сообщениями
Если вы хотите изменить информацию об агенте , не отключая его , получите электронное письмо с подтверждением от контактов в сетях оператора, где в настоящее время запущен агент. Собрав все письма с подтверждением, отправьте их службе поддержки RBM вместе с описанием необходимых изменений.
Служба поддержки RBM проверит все разрешения и, если всё в порядке, внесет изменения и подтвердит их с вами и соответствующими операторами. Обратите внимание, что этот процесс может различаться в зависимости от процедур, действующих у операторов в разных странах .
Запросить изменения в учетной записи партнера RBM
Если у партнера RBM запущены агенты в сетях, управляемых оператором, выполните следующие действия:
- Получайте одобрения по электронной почте от контактов в сетях оператора, где запущены все ваши агенты.
- Предоставьте следующую информацию службе поддержки RBM:
- Идентификатор партнера RBM
- Детали, которые вы хотите изменить
После проверки согласований и информации служба поддержки RBM уведомит операторов связи о предстоящих изменениях. Эти изменения будут реализованы и подтверждены в течение 24 часов с момента получения уведомления.
Запрос на миграцию агента от партнера RBM A к партнеру B
Если агент уже запущен в сетях, управляемых оператором, выполните следующие действия:
- Получайте подтверждения по электронной почте от представителя бренда и контактов в сетях, управляемых оператором.
- Убедитесь, что новому партнеру RBM отправлены копии этих писем с подтверждением.
- Предоставьте следующую информацию службе поддержки RBM:
- Идентификаторы агентов
- Подтверждения по электронной почте от представителя бренда и перевозчиков
- Новый идентификатор партнера
После проверки согласований и информации служба поддержки RBM уведомит операторов связи о предстоящих изменениях. Эти изменения будут реализованы и подтверждены в течение 24 часов с момента получения уведомления.
Запрос на миграцию агентов в другую партнерскую учетную запись
Для более быстрых обновлений предоставьте следующую информацию:
- Список идентификаторов агентов
- Старый идентификатор партнера
- Новый идентификатор партнера
Отсутствует информация в отчетах о событиях выставления счетов
Для более быстрого устранения неполадок предоставьте следующую информацию:
- Даты, для которых отсутствуют файлы
- Идентификаторы агентов