Руководство по устранению неполадок 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. Все агенты в партнерской учетной записи используют один канал для входящих сообщений и событий, поэтому неисправный веб-перехватчик может нарушить доставку для всех агентов.

Если проблема не устранена, поделитесь следующей информацией, чтобы ускорить устранение неполадок:

  • Когда возникла проблема? Успешно ли вы получали сообщения и события до этого?
  • Идентификатор партнера
  • Идентификаторы агентов
  • URL вебхука
  • Идентификаторы сообщений с метками времени

Примеры этой проблемы включают сбой при загрузке, отображение черного экрана, обрезку и отсутствие предлагаемых действий.

Поделитесь как можно большим количеством следующих сведений, чтобы ускорить устранение неполадок:

  • Идентификаторы сообщений с метками времени
  • Полезная нагрузка 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. Все агенты в партнерской учетной записи используют один канал для входящих сообщений и событий, поэтому неисправный веб-перехватчик может нарушить доставку для всех агентов.

Если проблема не устранена, поделитесь следующей информацией, чтобы ускорить устранение неполадок:

  • Когда возникла проблема? Успешно ли вы получали сообщения и события до этого?
  • Идентификатор партнера
  • Идентификаторы агентов
  • URL вебхука
  • Идентификаторы сообщений с метками времени

Примеры этой проблемы включают сбой при загрузке, отображение черного экрана, обрезку и отсутствие предлагаемых действий.

Поделитесь как можно большим количеством следующих сведений, чтобы ускорить устранение неполадок:

  • Идентификаторы сообщений с метками времени
  • Полезная нагрузка JSON
  • Действия устройства для воспроизведения, если они известны
  • Отчет об ошибке с устройства, получающего сообщения
  • Подробная информация об устройстве и используемой версии приложения для обмена сообщениями.
  • Скриншот или видеозапись проблемы

Сообщения RBM, отправленные в формате JSON или преобразованные в SMS.

Поделитесь как можно большим количеством следующих сведений, чтобы ускорить устранение неполадок:

  • Идентификаторы сообщений с метками времени
  • Полезная нагрузка JSON
  • Действия устройства для воспроизведения, если они известны
  • Отчет об ошибке с устройства, получающего сообщения
  • Подробная информация об устройстве и используемой версии приложения для обмена сообщениями.
  • Скриншот или видеозапись проблемы

Не удалось создать URL-адрес P2A или QR-код.

Поделитесь как можно большим количеством следующих сведений, чтобы ускорить устранение неполадок:

Поделитесь как можно большим количеством следующих сведений, чтобы ускорить устранение неполадок:

  • Идентификатор агента
  • Номер телефона
  • Действия по воспроизведению, если известно
  • Отчет об ошибке (с устройства, на котором была открыта ссылка)
  • Скриншот или видеозапись проблемы

Невозможно получать сообщения на устройстве с поддержкой RCS

Поделитесь как можно большим количеством следующих сведений, чтобы ускорить устранение неполадок:

  • Отчет об ошибке с устройства, которое не получает сообщения RBM.
  • Номер телефона
  • Подробности об устройстве и ОС
  • Используемая версия приложения для обмена сообщениями
  • Действия по воспроизведению, если известно
  • Снимок экрана, показывающий статус RCS
  • Скриншот или видеозапись проблемы
  • Название оператора связи и страна

Не могу добавить тестера

Выполните действия, описанные в разделе «Настройка тестового устройства» .

Если проблема не устранена, поделитесь следующей информацией, чтобы ускорить устранение неполадок:

  • Идентификатор агента
  • Номер телефона
  • Название оператора связи и страна

Тестовое устройство не получает приглашение или сообщения тестировщика

Выполните действия, описанные в разделе «Настройка тестового устройства» .

Если проблема не устранена, поделитесь следующей информацией, чтобы ускорить устранение неполадок:

  • Идентификатор агента
  • Номер телефона
  • Идентификатор сообщения с отметкой времени
  • Отчет об ошибке в течение 5 минут после отправки приглашения на тестирование.

Проблемы с проверкой возможностей

Поделитесь следующей информацией, чтобы ускорить устранение неполадок:

  • Список телефонных номеров с кодами стран, заключенный в файл CSV.
  • Идентификаторы агентов
  • Журналы ошибок
  • Статус RCS устройства

Отсутствует информация в отчетах о событиях выставления счетов

Поделитесь следующей информацией, чтобы ускорить устранение неполадок:

  • Даты, за которые отсутствуют файлы
  • Идентификаторы агентов

Перевозчик не может одобрить запуск агентов

Сообщите о проблеме из консоли администрирования RBM (см. снимок экрана ).

Для срочных запусков просьба предоставить:

  • Название оператора связи и страна
  • Идентификатор агента, который будет запущен
  • Разрешение перевозчика на запуск

Запрос на обновление данных агента

Поделитесь следующей информацией, чтобы обеспечить более быстрое обновление:

  • Идентификатор агента
  • Детали метаданных, которые необходимо обновить (например: имя, логотип, баннер, описание, контактные данные, ссылка на политику конфиденциальности или ссылку на условия обслуживания).

Запрос на перенос агентов на другой партнерский аккаунт

Поделитесь следующей информацией, чтобы обеспечить более быстрое обновление:

  • Список идентификаторов агентов
  • Старый идентификатор партнера
  • Новый идентификатор партнера