Crea agentes para administrar las marcas

Elige si quieres administrar los agentes con la consola para desarrolladores o la API de Business Communications.

Play Console API

Después de registrarte como socio, puedes habilitar las conversaciones de las marcas que administras creando agentes de Business Messages para ellas.

Agente: Es una representación conversacional de una marca, administrada por un socio. Incluye cualquier interfaz con la que los usuarios interactúen y el código o la infraestructura necesarios para potenciar la interacción.

Un agente es una entidad conversacional con la que los usuarios interactúan. Creas un agente para cada marca que administras. Puedes crear y administrar agentes con la API de Business Communications y controlar los mensajes para tus agentes con la API de Business Messages.

Un agente abarca las funciones comerciales de una marca, como la asistencia en línea y las ubicaciones físicas (si las hubiera). Cada mensaje contiene el contexto desde el que el usuario inició la conversación. Tu infraestructura de enrutamiento de mensajes puede detectar si el usuario vio una ubicación específica de la empresa o buscó asistencia general, y puede enrutar mensajes al destino correcto.

Por ejemplo, si administras la marca Growing Tree Bank, que tiene un sitio web y dos ubicaciones, creas un solo agente de “Growing Tree Bank”. Los usuarios pueden encontrarse con el agente a través de búsquedas generales o basadas en la ubicación, y el contexto en el que el usuario encontró el agente se pasa junto con cada mensaje a tu webhook. Usa ese contexto para enrutar el mensaje al personal de una ubicación o al equipo de asistencia al cliente del sitio web, que crean una respuesta y continúan la conversación con el usuario.

Expectativas

Antes de crear un agente, debes comprender las expectativas de los agentes en Business Messages.

• Los agentes deben seguir las pautas de diseño descritas en Diseño de conversaciones para Business Messages.

• Los agentes deben tener representantes humanos disponibles para responder preguntas cuando la automatización no puede cumplir una solicitud o cuando los usuarios lo solicitan.

  Nota: Si tu agente no admite representantes humanos, no se puede iniciar desde puntos de entrada basados en la ubicación ni puntos de entrada no locales. Especifica un tipo de interacción humana para tu agente, de modo que pueda aparecer en los puntos de entrada administrados por Google.

• Los agentes deben mantener una calificación de satisfacción del cliente (CSAT) del 80% como mínimo y una tasa de respuesta del comercio (MRR) del 95% como mínimo, como se describe en la sección Métricas.

Crea un agente

Cuando creas un agente, puedes habilitar el bot de ayuda de Business Messages para que te ayude a explorar la plataforma. El bot de ayuda te permite iniciar una conversación con tu agente con rapidez para que puedas probar las funciones disponibles y encontrar recursos que te ayuden a implementarlas. Esto es muy útil cuando creas tu primer agente.

Para crear un agente, debes recopilar y enviar información sobre la marca y cómo quieres que se muestre el agente a los usuarios.

Nota: Necesitas una Cuenta de Google de Business Messages para crear agentes. Si deseas registrarte para obtener una cuenta, consulta Regístrate para usar Business Messages y revisa las expectativas para los agentes operativos.

Si administras varias marcas, repite los pasos para crear un agente para cada una.

Requisitos previos

Antes de crear agentes para las marcas que administras, debes recopilar la siguiente información:

• Marca
• Nombre del agente

Crea el agente

Una vez que hayas recopilado la información, es hora de crear el agente.

Nota: Para habilitar el bot de ayuda de Business Messages para tu agente, primero debes inhabilitar cualquier webhook o integraciones de Dialogflow existentes.

1. Abre la Consola para desarrolladores de Business Communications y accede con tu Cuenta de Google de Business Messages.
2. Haz clic en Create Agent.
3. En Tipo de agente, selecciona Business Messages.
4. Ingresa los valores de Nombre de la marca y Nombre del agente.
5. Realiza una de las siguientes acciones:
   • Para experimentar una conversación con tu agente en la que puedas explorar las funciones disponibles, selecciona Habilitar el bot de ayuda de Business Messages.
   • Para personalizar tu agente y prepararlo para la administración de mensajes, anula la selección de Habilitar el bot de ayuda de Business Messages.
6. Haz clic en Create Agent.

Si habilitaste el bot de ayuda de Business Messages, puedes iniciar una conversación de inmediato. De lo contrario, continúa con la configuración de tu webhook.

Configurar un webhook a nivel del agente

Recibes mensajes enviados a tu agente en tu webhook. Si deseas que los mensajes para un agente específico lleguen a un webhook diferente, puedes configurar un webhook a nivel de agente.

Nota: Si habilitaste el bot de ayuda de Business Messages, debes inhabilitarlo para poder recibir mensajes en tu webhook.

1. Abre la Consola para desarrolladores de Business Communications y accede con tu Cuenta de Google de Business Messages.
2. Haz clic en tu agente.
3. Haga clic en Integrations.
4. En Webhook, haz clic en Configurar.
5. En URL del extremo de webhook (Webhook endpoint URL), ingresa la URL de tu webhook que comience con “https://”.
6. Anota tu valor de clientToken. Debes hacerlo para verificar que los mensajes que recibes provengan de Google.

7. Configura tu webhook para que acepte una solicitud POST con el parámetro clientToken especificado y envía una respuesta 200 OK con el valor del parámetro secret.

   Por ejemplo, si tu webhook recibe una solicitud POST con el siguiente contenido de cuerpo

   {
     "clientToken":"SJENCPGJESMGUFPY",
     "secret":"0123456789"
   }
   

   El webhook debe confirmar el valor clientToken y, si clientToken es correcto, mostrar una respuesta 200 OK con el parámetro de URL secret establecido en 0123456789.

8. En la consola, haz clic en Verificar.

   Cuando Business Messages verifica tu webhook, se cierra el diálogo.

Prueba un agente

Cada agente tiene URLs de prueba que te permiten ver cómo se muestra a los usuarios una conversación con ese agente y te brindan la oportunidad de verificar tu infraestructura de mensajería.

Para probar un agente,

1. Abre la Consola para desarrolladores de Business Communications y accede con tu Cuenta de Google de Business Messages.
2. Selecciona el agente.

3. En URLs de prueba del agente en la página Descripción general, elige cómo acceder a las URLs de prueba:

   • Para acceder a las URL en tu dispositivo móvil, haz clic en el botón Android o iOS. Luego, escanea el código QR con el dispositivo correspondiente y haz clic en Launch. Como alternativa, haz clic en Copy Android URL o Copy iOS URL para copiar la URL de prueba del agente en el portapapeles de tu dispositivo.
   • Para enviar las URLs a tu dirección de correo electrónico, haz clic en Enviar.

4. Abre la URL en tu dispositivo móvil. (Los dispositivos iOS requieren la app de Google Maps).

Nota: También puedes probar el agente si interactúas con las vistas previas del agente en la consola para desarrolladores de Business Communications.

Actualizar la información del agente

Después de crear el agente, puedes editar la información del agente en la página Información del agente:

• Marca
• Nombre del agente

• Logotipo del agente (1024 x 1024 px)

  En las conversaciones, los logotipos se muestran como círculos de 1,024 px de diámetro. Asegúrate de que tu logotipo se vea bien como un círculo.

  Prueba tu logotipo

  Ingrese la URL de su logotipo para visualizar cómo se mostrará a los usuarios.

  Nota: El servidor web que aloja la imagen debe permitir que se incorporen imágenes en otros sitios web.

• Número de teléfono

• URL de la Política de Privacidad

• Configuración regional predeterminada

• Mensaje de bienvenida

• Mensaje sin conexión

• Temas de conversación

• Disponibilidad de los mensajes mediante interacciones principales y secundarias

En las páginas de información del agente y Descripción general, se muestra una vista previa de cómo aparece tu agente en las conversaciones.

Después de verificar un agente, solo puedes actualizar los siguientes campos:

• Número de teléfono
• ID personalizado del agente
• Configuración regional predeterminada
• Mensaje de bienvenida
• Mensaje sin conexión
• Política de Privacidad
• Temas de conversación
• Interacción principal

Si necesitas actualizar otros campos después de verificar tu agente, comunícate con nosotros. (Primero debes acceder con una Cuenta de Google de Business Messages. Si deseas registrarte para obtener una cuenta, consulta Registrarse con Business Messages).

Borra un agente

Cuando borras un agente, Business Messages borra todos los datos del agente. Business Messages no borra los mensajes enviados por tu agente que se encuentren en tránsito hacia el dispositivo de un usuario o almacenados en él. Los mensajes a los usuarios no son datos del agente.

Las solicitudes de eliminación fallan si el agente tiene una ubicación asociada o si intentaste verificar el agente una o más veces. Para actualizar ubicaciones, consulta Cómo agregar ubicaciones.

No puedes borrar un agente verificado. Para borrar un agente que verificaste o que intentaste verificar, comunícate con nosotros. (Primero debes acceder con una Cuenta de Google de Business Messages. Si deseas registrarte para obtener una cuenta, consulta Registrarse con Business Messages).

Advertencia: Si borras un agente, se quitará de forma permanente toda la información sobre el agente de Business Messages.

Para borrar un agente,

1. Abre la Consola para desarrolladores de Business Communications y accede con tu Cuenta de Google de Business Messages.
2. Elige tu agente.
3. En la parte inferior de la página Descripción general, haz clic en Borrar agente.
4. Ingresa "BORRAR" y, luego, haz clic en Borrar agente.

Si borras un agente, no se borrarán los datos de marca asociados. Usa la API de Business Communications para borrar una marca.

Próximos pasos

Ahora que tienes un agente, puedes seguir estos pasos:

• Agrega ubicaciones a tu agente
• Diseña la experiencia de conversación
• Desarrolla tus flujos de mensajes