Business Messages proporciona una interfaz de usuario web llamada Consola para desarrolladores de Business Communications. Puedes usarla para crear, administrar y lanzar agentes.
La Consola para desarrolladores de Comunicaciones empresariales es diferente de Google Cloud Platform. (GCP) Console. Usas la Consola de desarrollador de Comunicaciones comerciales para administrar los agentes de mensajes comerciales, mientras que usas GCP Console para administrar la configuración específica de GCP (por ejemplo, la facturación y las APIs) y otros recursos de GCP.
Si bien puedes usar la Consola de desarrollador de Comunicaciones empresariales para crear y administrar tus agentes, también puedes usar la API de Comunicaciones empresariales para crear y administrar agentes en situaciones avanzadas, como una integración en tu propio producto.
Las guías de inicio rápido y prácticas te guían a través de los pasos para usar la consola y las APIs. En esta página, se proporciona un resumen de alto nivel del diseño de la interfaz de usuario y de los usos de la consola.
Cómo se usa la consola
La consola se usa para crear, administrar, actualizar, verificar y lanzar tus agentes. Con él, puedes hacer lo siguiente:
- Configura tu webhook y otros parámetros de configuración de la cuenta de socio.
- Crea y administra agentes, que contienen todas las propiedades y los datos que definen la representación conversacional de una marca.
- Configura la configuración del agente no local y la disponibilidad de los mensajes.
- Crea y administra ubicaciones que representen las ubicaciones físicas de una empresa.
- Recupera las URLs de prueba de tu agente y ubicación para ver cómo se muestra una conversación con tu agente a los usuarios.
- Integra Dialogflow para responder preguntas frecuentes.
- Verifica tu agente y tus ubicaciones.
- Inicia tu agente y ubicaciones.
Pantalla principal de la consola
Cuando cargues la consola por primera vez, verás la pantalla de selección de agentes. En esta página, el vínculo Configuración de la cuenta de socio abre la página de configuración de la cuenta de tu socio.
Además, la pantalla principal se usa para lo siguiente:
- Selecciona un agente existente.
- Crear agentes nuevos
- Ordena los agentes.
- Filtra los agentes por cuenta de socio.
De forma predeterminada, los agentes se muestran en una vista de tarjeta. Los agentes se ordenan según la fecha en la que se actualizaron por última vez. Para cambiar a una vista de lista, usa las opciones Ver como a la derecha. Con la vista de lista, los agentes se pueden ordenar por nombre, tipo, estado y fecha de actualización más reciente.
Si tienes varias cuentas de socios, hay un selector desplegable de cuentas de socios en el que puedes filtrar la selección de agentes por una cuenta de socio.
Configuración de la cuenta
En la página Configuración, puedes actualizar la siguiente información:
- Nombre de la empresa
- Nombre visible
- Punto de contacto técnico
- Webhook
En el panel de navegación lateral, puedes acceder a la administración de marcas y usuarios, así como a tus cuentas de servicio.
Administración de marcas
Una marca es una empresa, una organización o un grupo. Un agente es la representación de una marca mediante conversaciones.
Usa esta página para agregar, editar y quitar marcas. Si quitas una marca, también se borrarán todos los agentes asociados. No se puede quitar una marca si está asociada con un agente lanzado.
Administración de usuarios
Usa esta página para agregar y quitar acceso a tus cuentas de socios registradas. Para cambiar de cuenta, usa el menú desplegable de la barra de navegación superior.
Agrega un usuario
Para agregar un usuario, ingresa su dirección de correo electrónico en el campo de entrada y selecciona el rol.
Los usuarios nuevos pueden tener los roles de Administrador o Lector. Un rol de administrador tiene acceso a todas las funciones de la consola, mientras que un rol de lector proporciona acceso de solo lectura a la información del agente y la ubicación.
Cuando agregues un usuario nuevo, este recibirá un correo electrónico en el que se le notificará que ahora tiene acceso a la cuenta de socio.
La dirección de correo electrónico que registró originalmente la cuenta de socio tiene el rol de propietario.
Quitar un usuario
Sigue estos pasos para quitar usuarios:
- Busca el usuario que quieres quitar en la lista.
- Haz clic en el botón .
- Selecciona Quitar usuario.
- Confirma la eliminación.
El usuario que quitaste recibirá una notificación por correo electrónico en la que se le informará que ya no tiene acceso a la cuenta.
No puedes quitar a un usuario con el rol de propietario. Para cambiar o quitar a un propietario, debes comunicarte con el equipo de asistencia.
Cómo cambiar el rol de un usuario
Para actualizar el rol de un usuario, sigue estos pasos:
- Busca el usuario que deseas actualizar.
- Haz clic en el botón .
- Selecciona Editar rol.
- Elige un nuevo rol en el menú desplegable.
- Haga clic en Guardar.
Cuentas de servicio
Cuando realizas llamadas a las APIs de Business Communications y Business Messages, autenticas las llamadas con una clave de cuenta de servicio. Las claves de cuenta de servicio te permiten crear y administrar marcas, agentes y ubicaciones, así como enviar mensajes y solicitudes como tu agente.
Para generar una clave de cuenta de servicio, selecciona Cuentas de servicio en la navegación lateral. Se abrirá GCP Console para el proyecto de GCP asociado con la cuenta de socio seleccionada actualmente.
Para crear una cuenta de servicio y una clave, haz lo siguiente:
- Haga clic en Crear cuenta de servicio.
- En Nombre de la cuenta de servicio, ingresa el nombre de tu agente y, luego, haz clic en Crear.
- Haz clic en Listo.
- Busca la cuenta de servicio nueva en la tabla y, luego, haz clic en > Crear clave.
- Elige JSON y, luego, haz clic en Crear.
El navegador descarga la clave de la cuenta de servicio.
Selección de agentes
Después de seleccionar un agente, se te redireccionará a la página Resumen del agente selecionado.
En la descripción general, se muestra lo siguiente:
- Nombre de la marca
- Nombre del agente
- La cuenta de socio en la que se creó el agente
- El ID de la marca
- El ID del agente
- URLs de prueba de agentes que te permiten ver cómo aparece una conversación con ese agente para los usuarios y te brindan la oportunidad de verificar tu infraestructura de mensajería
- Estado de verificación del agente
- Una vista previa del agente
- Ubicaciones asociadas con el agente
- Vínculos a la documentación relevante
La barra de navegación de la izquierda te permite acceder a lo siguiente:
- Información del agente
- Ubicaciones
- Integraciones
- Preguntas de la encuesta
- Registros de depuración
- Verificación
- Lanzamiento
- Panel de métricas
- Vínculos a la documentación relevante
Información del agente
Usa la página de información del agente para actualizar las propiedades de un agente.
La página se divide en dos columnas. Usa los campos de entrada de la columna izquierda para actualizar los campos del agente, como el nombre, el logotipo, el mensaje de bienvenida, los activadores de conversación y las propiedades de la ubicación y los puntos de entrada no locales. No podrás actualizar algunos campos, como Nombre del agente y Logotipo, después de lanzar el agente.
Usa la columna derecha para obtener las URLs de prueba de tu agente y ver una vista previa de cómo se ve en el dispositivo de un usuario.
Administración de ubicaciones
Usa esta página para agregar ubicaciones, recuperar URLs de prueba para las ubicaciones de las empresas y verificar las ubicaciones una vez que hayas verificado tu agente.
Integraciones
Usa esta página para integrar Dialogflow y configurar un bot que responda preguntas frecuentes.
Encuestas
Usa esta página para personalizar la encuesta para clientes de tu agente.
Registros
Usa esta página para depurar problemas de entrega de mensajes. Los registros están disponibles durante 14 días. Filtra por ID de conversación, ID de mensaje, marca de tiempo, dirección o estado para encontrar los registros relevantes para los problemas de los usuarios. También puedes consultar esta página para verificar que no envíes mensajes no válidos por error.
Los registros incluyen la carga útil del mensaje, excepto los campos sensibles ocultados, como el contenido de texto del mensaje. Los mensajes rechazados y con errores tienen detalles de error adicionales para ayudar con la depuración.
Algunos eventos, como los indicadores de escritura, no tienen recibos de entrega, y su estado aparece como “Enviado”.
Verificación
Usa esta página para enviar tu agente para la verificación.
Lanzamiento
Usa esta página para iniciar tu agente en ubicaciones y puntos de entrada no locales, así como para iniciar ubicaciones individuales.
