Crea agentes para administrar las marcas

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

API de Play Console

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

Agente: Es una representación de una marca mediante conversaciones que administra un socio. Incluye cualquier interfaz con la que interactúan los usuarios y cualquier código o infraestructura necesarios para potenciar la interacción.

Un agente es una entidad de conversación con la que interactúan los usuarios. Creas un agente para cada marca que administras. Creas y administras agentes con la API de Business Communications y controlas los mensajes de 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 hay). 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 los 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 "Growing Tree Bank". Los usuarios pueden encontrar al agente a través de búsquedas generales o basadas en la ubicación, y el contexto en el que el usuario encontró al agente se pasa junto con cada mensaje a tu webhook. Usas ese contexto para enrutar el mensaje al personal de una ubicación o al equipo de asistencia al cliente del sitio web, que crea una respuesta y continúa la conversación con el usuario.

Expectativas

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

• Los agentes deben seguir la guía de diseño que se describe en Diseño de conversaciones para Business Messages.

• Los agentes deben tener representantes humanos disponibles para responder preguntas cuando la automatización no puede completar 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) de al menos el 80% y una tasa de respuesta del comercio (MRR) de al menos el 95%, como se describe en Métricas.

Crear un agente

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

Para crear un agente, debes recopilar y enviar información sobre la marca y cómo deseas que el agente aparezca para los usuarios.

Nota: Necesitas una Cuenta de Google de Business Messages para crear agentes. Para registrarte en una cuenta, consulta Cómo registrarse en 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:

• Nombre de la marca
• Nombre del agente

Crea el agente

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

Nota: Para habilitar el bot de ayuda de Business Messages para tu agente, primero debes inhabilitar cualquier webhook o integración de Dialogflow existente.

1. Abre la consola de desarrollador 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 Mensajes de clientes.
4. Ingresa los valores de Nombre de la marca y Nombre del agente.
5. Realiza alguna de las siguientes acciones:
   • Para tener una conversación con tu agente en la que puedas explorar las funciones disponibles, selecciona Habilitar bot de ayuda de Business Messages.
   • Para personalizar tu agente y prepararlo para el control de mensajes, anula la selección de la opción 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 del webhook.

Configura un webhook a nivel del agente

Recibirás los mensajes que se envíen a tu agente en tu webhook. Si quieres que los mensajes de un agente específico lleguen a un webhook diferente, puedes configurar un webhook a nivel del agente.

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

1. Abre la consola de desarrollador de Business Communications y accede con tu Cuenta de Google de Business Messages.
2. Haz clic en tu agente.
3. Haz clic en Integrations.
4. En Webhook, haz clic en Configurar.
5. En URL del extremo del webhook, ingresa la URL de tu webhook, que debe comenzar con "https://".
6. Anota el valor de clientToken. La necesitas 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íe una respuesta 200 OK con el valor del parámetro secret.

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

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

   Tu webhook debe confirmar el valor de 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 los Mensajes para Negocio verifiquen tu webhook, se cerrará el diálogo.

Prueba un agente

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

Para probar un agente, haz lo siguiente:

1. Abre la consola de desarrollador 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 URLs 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 Copiar URL de Android o Copiar URL de iOS 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 tu agente interactuando con las vistas previas del agente en la consola para desarrolladores de Business Communications.

Actualiza la información del agente

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

• Nombre de la marca
• Nombre del agente

• Logotipo del agente (1,024 × 1,024 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 muestre bien como un círculo.

  Prueba tu logotipo

  Ingresa una URL para tu logotipo para ver cómo se vería para 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 a través de interacciones principales y secundarias

En las páginas Descripción general y Información del agente, 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). Para registrarte, consulta Cómo registrarse con Mensajes para Negocio.

Borra un agente

Cuando borras un agente, Business Messages borra todos sus datos. Business Messages no borra los mensajes que envía tu agente que están 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 verificarlo una o más veces. Para actualizar las ubicaciones, consulta Cómo agregar ubicaciones.

No puedes borrar un agente verificado. Para borrar un agente que verificaste o intentaste verificar, comunícate con nosotros. (Primero debes acceder con una Cuenta de Google de Business Messages). Para registrarte, consulta Cómo registrarse con Mensajes para Negocio.

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

Para borrar un agente, haz lo siguiente:

1. Abre la consola de desarrollador 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 la marca asociados. Usa la API de Business Communications para borrar una marca.

Próximos pasos

Ahora que tienes un agente, puedes seguir estos pasos:

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