Google Chat Trigger
Google Chat Trigger pone en marcha un flujo cada vez que alguien escribe un mensaje nuevo en Google Chat: en un espacio, en un chat de grupo o en un mensaje directo a la cuenta conectada. El flujo recibe el texto del mensaje, quién lo envía, el espacio y el hilo, todo lo necesario para contestar en el mismo sitio.
NappAI revisa Google Chat aproximadamente cada minuto y ejecuta el flujo una vez por cada mensaje nuevo, del más antiguo al más reciente. No tienes que crear una aplicación de Chat ni configurar nada en Google: basta con la credencial y con activar el disparador.
Cuándo usarlo
- Montar un asistente que conteste en Google Chat las dudas del equipo a partir de la documentación de la empresa.
- Abrir una incidencia en tu herramienta de soporte cada vez que alguien escribe en el espacio de incidencias.
- Que un agente responda solo cuando lo mencionan con @ en un espacio con mucho movimiento.
- Registrar en una hoja de cálculo las peticiones que llegan por mensaje directo.
Configuración
Necesitas una credencial Google Chat, que se conecta iniciando sesión con tu cuenta de Google. Los mensajes que se vigilan son los que esa cuenta puede ver. Consulta Credenciales y, si usas tu propio proyecto de Google Cloud, Conectar los servicios de Google.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Google Chat de la cuenta que recibe los mensajes. |
| Spaces | Los espacios, chats de grupo o mensajes directos que se vigilan. Al elegir la credencial, la lista muestra tus espacios, los más activos primero. Déjalo vacío para vigilarlos todos. |
| Ignore My Own Messages | Los mensajes que envía la propia cuenta no lanzan el flujo. Viene activado. Mantenlo así si el flujo contesta en Google Chat; si no, cada respuesta volvería a lanzarlo. |
| Only When Mentioned | En espacios y chats de grupo, solo lanzan el flujo los mensajes que mencionan a la cuenta con @. Los mensajes directos siempre lo lanzan. Viene desactivado. |
| Max Messages per Check (avanzado) | Cuántos mensajes se atienden como máximo en cada revisión; cada uno es una ejecución del flujo. Los que sobran esperan a la siguiente. Por defecto, 20. |
| Check Every (seconds) (avanzado) | Cada cuánto se revisa Google Chat. Entre 60 segundos y un día. Por defecto, 60. |
| Data | Campo de prueba. Te permite probar el flujo con un mensaje de ejemplo sin esperar a que alguien escriba. Déjalo vacío en el uso normal. |
Activar el disparador
El flujo solo recibe mensajes cuando el disparador está activado:
- Guarda el flujo y publica una versión. Consulta Versiones y publicación.
- En el panel de ajustes del nodo pulsa Activar, o abre Disparadores de elementos nuevos y pulsa Activar junto a Google Chat Trigger. El estado pasa a Escuchando.
Solo llegan los mensajes que se escriben después de activarlo. Si cambias los espacios vigilados, el estado aparece como Desincronizado: pulsa Actualizar para aplicar el cambio. Desde el mismo panel puedes Desactivar el disparador.
Si al activarlo aparece el aviso de que no se pueden distinguir tus propios mensajes, edita la credencial Google Chat y vuelve a iniciar sesión con Google: la credencial pide ahora también tu perfil básico, que es lo que permite reconocer los mensajes de la cuenta.
Resultado
La salida Data contiene el mensaje nuevo. Su texto es el del mensaje, así que puedes conectarla directamente a un agente. Además trae:
message_id: el identificador del mensaje.text: el texto.space,space_nameyspace_type: el espacio (su identificador, su nombre y si es un espacio, un chat de grupo o un mensaje directo).thread_nameeis_thread_reply: el hilo del mensaje y si es una respuesta dentro de él.sender_idysender_type: quién lo envía y si es una persona o una aplicación.sender_nametrae el nombre cuando Google lo facilita; con credenciales personales suele venir vacío para las personas.createTime: cuándo se envió.mentions: las personas mencionadas.attachments: los archivos del mensaje, con su nombre, tipo y enlace de descarga.
La conversación del flujo es la del espacio: un agente conectado al disparador recuerda lo que se ha hablado en cada espacio o mensaje directo por separado.
Ejemplo
Un asistente que contesta en el espacio de soporte.
- Añade Google Chat Trigger, elige la credencial y, en Spaces, el espacio de soporte.
- Conecta su salida a un Agente con la documentación de la empresa como herramienta.
- Añade Google Chat Messages con la operación
Reply to Message, Thread ID ={thread_name}y Message Text = la respuesta del agente. - Publica el flujo y pulsa Activar.
- Escribe una pregunta en el espacio de soporte: en un minuto como mucho llega la respuesta en su hilo.
Buenas prácticas
- Usa una cuenta de Google propia para el asistente (por ejemplo, una de soporte) e invítala a los espacios donde debe contestar. Así sus respuestas se distinguen de las de las personas.
- En espacios con mucha conversación, activa Only When Mentioned para que el asistente intervenga solo cuando lo llamen.
- Prueba el flujo con el campo Data o escribiéndote un mensaje después de activarlo.
Componentes relacionados
- Google Chat Messages: contestar, enviar y leer mensajes.
- Google Chat Spaces: crear espacios y gestionar sus miembros.