Guía de solución de problemas de RBM

Sigue esta guía para proporcionar la información necesaria para solucionar problemas relacionados con RBM.

Problemas con el formato y la entrega de mensajes

Se trata de problemas con la transmisión y recepción reales de mensajes, incluidos los problemas de formato de los mensajes.

No se pueden enviar mensajes de RBM

Comparte la mayor cantidad posible de los siguientes detalles para habilitar una solución de problemas más rápida:

  • IDs de mensajes de muestra con marcas de tiempo
  • ID del socio (consulta la captura de pantalla)
  • Cantidad de agentes afectados
  • IDs de agentes (separados por comas)
  • Cantidad estimada de mensajes afectados o potencialmente afectados
  • Métodos de la API con los que tienes problemas (por ejemplo, subir archivos, crear mensajes de agente a usuario, crear eventos de agente a usuario, borrar mensajes de agente a usuario, obtener capacidades, obtener por lotes)
  • Ejemplo de carga útil JSON de solicitudes fallidas
  • Para problemas del cliente: Informe de errores del cliente

  • Registros de errores (errores que se ven en la terminal cuando se llama a las APIs de RBM), incluidos el código y el mensaje de error Por ejemplo:

    "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",
}

    No se reciben eventos ni mensajes en el webhook

Para que los mensajes se entreguen sin problemas, verifica que todos los webhooks de agente de tu cuenta de socio funcionen correctamente y puedan procesar mensajes de Google. Todos los agentes de una cuenta de socio comparten un solo canal para los mensajes y eventos entrantes, por lo que un webhook que no funcione correctamente puede interrumpir las entregas de todos los agentes.

Si el problema persiste, comparte los siguientes detalles para que la solución de problemas sea más rápida:

  • ¿Cuándo comenzó el problema? ¿Recibías mensajes y eventos correctamente antes de eso?
  • ID de socio
  • IDs de agentes
  • URL de webhook
  • IDs de mensajes con marcas de tiempo

Mensajes de RBM enviados como JSON o convertidos a SMS

Comparte la mayor cantidad posible de los siguientes detalles para habilitar una solución de problemas más rápida:

  • IDs de mensajes con marcas de tiempo
  • Carga útil de tipo JSON
  • Pasos para reproducir el problema en el dispositivo (si se conocen)
  • Informe de errores del dispositivo que recibe los mensajes
  • Detalles sobre el dispositivo y la versión de la app de mensajería que se usaron
  • Captura de pantalla o grabación de video del problema

No se pueden recibir mensajes en un dispositivo compatible con RCS

Comparte la mayor cantidad posible de los siguientes detalles para habilitar una solución de problemas más rápida:

  • Informe de errores del dispositivo que no recibe los mensajes de RBM
  • Número de teléfono
  • Detalles sobre el dispositivo y el SO
  • Versión de la app de mensajería que se usó
  • Pasos para reproducir el problema (si se conocen)
  • Captura de pantalla que muestra el estado de los RCS
  • Captura de pantalla o grabación de video del problema
  • Nombre y país del operador

Problemas de configuración o conectividad del cliente y el dispositivo

Estos problemas incluyen la configuración del cliente, la conexión y los problemas específicos de la plataforma.

No se pudo generar la URL o el código QR de P2A

Comparte la mayor cantidad posible de los siguientes detalles para habilitar una solución de problemas más rápida:

Comparte la mayor cantidad posible de los siguientes detalles para habilitar una solución de problemas más rápida:

  • ID del agente
  • Número de teléfono
  • Pasos para reproducir el problema (si se conocen)
  • Informe de errores del dispositivo en el que se abrió el vínculo
  • Captura de pantalla o grabación de video del problema

Problemas con las verificaciones de capacidad

Comparte los siguientes detalles para habilitar una solución de problemas más rápida:

  • Lista de números de teléfono con códigos de país incluidos en un archivo CSV
  • IDs de agentes
  • Registros de errores
  • Estado de los RCS del dispositivo
  • Fecha y hora de la prueba realizada

El dispositivo de prueba no recibe la invitación ni los mensajes del verificador

Sigue los pasos que se indican en Cómo configurar un dispositivo de prueba.

Si el problema persiste, comparte los siguientes detalles para que la solución de problemas sea más rápida:

  • ID del agente
  • Número de teléfono
  • ID del mensaje con marca de tiempo
  • Informe de errores en un plazo de 5 minutos después de enviar la invitación de prueba

Problemas con los RCS o RBM en dispositivos iOS

Si bien Apple adoptó el estándar de los servicios de comunicación enriquecida (RCS) para la mensajería, decidió desarrollar su propia implementación única. Esto incluye funciones como RCS Business Messaging (RBM).

Si tienes problemas con RBM en tu dispositivo iOS, te recomendamos que los informes directamente a Apple a través de la app de Feedback Assistant. Esto ayudará a Apple a identificar y abordar cualquier problema específico de su implementación.

  1. Abre la app de Feedback Assistant en un dispositivo iOS.
  2. Selecciona un tema de inicio adecuado, relacionado con problemas con una app de mensajería.
  3. Escribe y envía tus comentarios.
  4. Para mantener al tanto al equipo de asistencia de RBM, comparte tus conclusiones con nosotros. Agradecemos tu ayuda para mejorar la experiencia de RCS para todos.

Disponibilidad de operadores de RCS/RBM en dispositivos iOS

Apple tiene su propia selección de operadores para los lanzamientos de RCS/RBM en iOS. Para consultar sobre la disponibilidad global o los planes futuros de Apple, comunícate directamente con Apple. También puedes comunicarte con el operador que te interese para preguntar sobre el estado de lanzamiento de RCS o RBM en iOS.

Para obtener información sobre la compatibilidad y las funciones de los operadores de telefonía celular inalámbrica para iPhone por país, visita la página de asistencia de Apple.

Problemas de rendimiento y visualización

Son problemas relacionados con el rendimiento y la visualización de RBM.

Latencia en la realización de acciones de RBM

Recuerda verificar lo siguiente primero:

Pregunta Recomendación
¿La latencia es <5s? Si es así, se encuentra dentro del rango aceptable.
¿Hubo alguna regresión en la latencia? Si es así, ¿cuándo comenzó? ¿Cuál era la latencia típica antes en comparación con la actual?
¿Estás usando la API de carga de archivos? Intenta usar IDs de archivos en lugar de enviar URLs directas. El procesamiento de URLs de contenido multimedia nuevo implica la descarga, el procesamiento, las miniaturas, la protección contra abuso y la protección contra virus, y esta última ocupa aproximadamente el 50% del tiempo.
¿Subiste el contenido multimedia del mensaje por adelantado? Para acelerar el procesamiento, te recomendamos que lo hagas con la siguiente llamada a la API: https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create
¿Ejecutaste verificaciones de capacidad? Para reducir la latencia en el envío de mensajes a los usuarios a los que no se puede llegar a través de RCS, primero ejecuta verificaciones de capacidades.

Si el problema persiste, proporciona la mayor cantidad posible de detalles adicionales para solucionar el problema más rápido:

  • Cantidad de mensajes afectados
  • Fuente de latencia (por ejemplo, subir archivos, crear un mensaje del agente al usuario, crear un evento del agente al usuario, borrar un mensaje del agente al usuario, obtener capacidades, obtener por lotes)
  • Extremo de servicio
  • Distribución de latencia (P50, P95 y P99)
  • Cambio en la latencia y período
  • ID de socio
  • IDs de los agentes afectados
  • IDs de mensajes con marcas de tiempo
  • Carga útil de tipo JSON

Entre los ejemplos de este problema, se incluyen la imposibilidad de cargar, la visualización de una pantalla negra, el recorte y la no aparición de acciones sugeridas.

Comparte la mayor cantidad posible de los siguientes detalles para habilitar una solución de problemas más rápida:

  • IDs de mensajes con marcas de tiempo
  • Carga útil de tipo JSON
  • Pasos para reproducir el problema en el dispositivo (si se conocen)
  • Informe de errores del dispositivo que recibe los mensajes
  • Detalles sobre el dispositivo y la versión de la app de mensajería que se usaron
  • Captura de pantalla o grabación de video del problema

Problemas con la administración de cuentas, agentes y operadores

Se trata de problemas relacionados con la administración de cuentas y la generación de informes, incluidas las consultas sobre facturación.

No se pudo agregar un verificador

Sigue los pasos que se indican en Cómo configurar un dispositivo de prueba.

Si el problema persiste, comparte los siguientes detalles para que la solución de problemas sea más rápida:

  • ID del agente
  • Número de teléfono
  • Nombre y país del operador

El operador no puede aprobar el lanzamiento del agente

Informa el problema desde la Consola del administrador de RBM (consulta la captura de pantalla).

Para los lanzamientos urgentes, proporciona la siguiente información:

  • Nombre y país del operador
  • ID del agente que se lanzará
  • Autorización del operador para el lanzamiento

Solicitud para actualizar los detalles del agente

Comparte los siguientes detalles para habilitar actualizaciones más rápidas:

  • IDs de agentes
  • Los detalles que quieres cambiar
  • Tu confirmación para anular el lanzamiento del agente

En el caso de los siguientes campos, el equipo de asistencia de RBM anulará el lanzamiento del agente. Luego, puedes hacer cambios en el agente y volver a enviarlo para su lanzamiento.

  • Nombre visible
  • Descripción
  • Color
  • Imágenes de logotipo y banner
  • Información de contacto del agente, como número de teléfono, sitio web y dirección de correo electrónico
  • Privacidad y Condiciones del Servicio

En el caso de los siguientes campos, el equipo de asistencia de RBM también anulará el lanzamiento del agente y modificará los campos (los socios de RBM no pueden modificar estos campos directamente):

  • Categoría de facturación
  • Caso de uso
  • Nombre de la marca
  • Nombre del contacto de la marca
  • ID del correo electrónico de contacto de la marca
  • URL del sitio web de la marca
  • Nombre de contacto del socio de mensajería
  • Correo electrónico de contacto del socio de mensajería

Si deseas modificar la información del agente sin anular el lanzamiento de los agentes, obtén la aprobación por correo electrónico de los contactos de las redes administradas por el operador en las que se lanzó el agente. Después de recopilar todos los correos electrónicos de aprobación, compártelos con el equipo de asistencia de RBM, junto con los detalles de las modificaciones requeridas.

El equipo de asistencia de RBM verificará las aprobaciones y, si todo está en orden, implementará los cambios y los confirmará contigo y con los operadores respectivos. Ten en cuenta que este proceso puede variar según los procedimientos de cada operador en diferentes países.

Solicita cambios en una cuenta de socio de RBM

Si el socio de RBM tiene agentes lanzados en redes administradas por el operador, sigue estos pasos:

  1. Obtén aprobaciones por correo electrónico de los contactos de las redes administradas por el operador en las que se lanza cualquiera de tus agentes.
  2. Comparte los siguientes detalles con el equipo de asistencia de RBM:

Después de verificar las aprobaciones y los detalles, el equipo de asistencia de RBM notificará a los operadores sobre los cambios pendientes. Estos cambios se implementarán y confirmarán en un plazo de 24 horas a partir de la notificación del operador.

Solicitud para migrar un agente del socio A de RBM al socio B

Si el agente ya se lanzó en redes administradas por el operador, sigue estos pasos:

  1. Obtén la aprobación por correo electrónico del contacto de la marca y de los contactos de las redes administradas por el operador.
    • Asegúrate de que el nuevo socio de RBM esté en copia en estos correos electrónicos de aprobación.
  2. Comparte los siguientes detalles con el equipo de asistencia de RBM:
    • IDs de agentes
    • Aprobaciones por correo electrónico del contacto de la marca y los operadores
    • Nuevo ID de socio

Después de verificar las aprobaciones y los detalles, el equipo de asistencia de RBM notificará a los operadores sobre los cambios pendientes. Estos cambios se implementarán y confirmarán en un plazo de 24 horas a partir de la notificación del operador.

Solicitud para migrar agentes a otra cuenta de socio

Comparte los siguientes detalles para habilitar actualizaciones más rápidas:

  • Lista de IDs de agentes
  • ID del socio anterior
  • ID de socio nuevo

Falta información en los informes de eventos de facturación

Comparte los siguientes detalles para habilitar una solución de problemas más rápida:

  • Fechas para las que faltan archivos
  • IDs de agentes