Saltearse al contenido
Nappai Documentation

Google Chat Messages

Este componente actúa como un puente inteligente entre Nappai y Google Chat. Te permite automatizar cómo tu sistema se comunica con tus equipos o clientes. Con él, puedes enviar mensajes a espacios específicos, responder a hilos de conversación, actualizar información en un mensaje ya enviado e incluso eliminar chats antiguos, todo de manera automática.

Es ideal para notificaciones de alertas, respuestas automáticas, resúmenes de reportes enviados a grupos, o limpieza de datos en chats.

¿Cómo funciona?

Internamente, este componente se comunica con la API de Google Chat. Imagina que es como un mensajero digital:

  1. Recibe instrucciones: Le dices qué quieres hacer (enviar un texto, responder a alguien, borrar un mensaje) y a dónde (en qué espacio o hilo).
  2. Valida y Autentica: Verifica que tienes permiso para hacerlo y usa tus credenciales seguras para hablar directamente con los servidores de Google.
  3. Ejecuta y Devuelve Resultado: Realiza la acción y te devuelve un “acuse de recibo” (como el ID del mensaje creado o el estado de éxito/error) para que puedas conectar la siguiente parte de tu automatización.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo de Google Chat de forma segura.

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo Google Chat.
  3. Debes completar los campos requeridos por Google para permitir el acceso (generalmente incluye seleccionar tu Proyecto de Google Cloud, el Client Id y el Client Secret, y configurar el acceso de Google Chat).
  4. Una vez guardada la credencial, regresa a tu flujo de trabajo y selecciona esa credencial en el campo Credential de este componente.

Entradas

Los siguientes campos están disponibles para configurar este componente. Puedes usarlos para definir qué mensaje enviar, a quién enviarlo y en qué espacio.

  • Space: El nombre o identificador del espacio de Google Chat (canal) donde se realizará la acción.
  • Message Text: El contenido textual del mensaje que deseas enviar o actualizar.
  • Message ID: El identificador único del mensaje existente (recurso) al que quieres referenciar, por ejemplo, para editarlo o eliminarlo.
  • Recipient Email: La dirección de correo electrónico del usuario con el que deseas enviar un mensaje directo (DM).
  • Thread ID: El identificador del hilo específico para respuestas anidadas.
  • Attachments: Archivos o enlaces adjuntos que deseas incluir en el mensaje.
  • Message Count: Número de mensajes a recuperar en una consulta (por defecto suele ser 25).

Salidas

Al finalizar la operación, este componente produce una salida principal que contiene toda la información relevante sobre la acción realizada.

  • Data: Contiene el resultado completo devuelto por Google Chat. Aquí encontrarás el ID del mensaje creado, la fecha de creación, el estado de la operación y metadatos del remitente. Esta salida es clave para conectar con otros componentes que necesiten saber el ID del mensaje para futuras acciones (como responderlo después).

Ejemplo de Respuesta JSON

Este es un ejemplo de cómo se ve la información que recibirás en la salida Data después de ejecutar una acción exitosa: json { “name”: “spaces/AAAA/messages/BBBB”, “sender”: { “name”: “users/CCCC”, “email”: “automation@yourcompany.com” }, “createTime”: “2023-10-27T10:00:00.000Z”, “updateTime”: “2023-10-27T10:00:00.000Z”, “text”: “Hola equipo, aquí está el reporte diario.”, “argumentText”: “Hola equipo, aquí está el reporte diario.” }

Ejemplo de Uso

Escenario: Quieres que, cuando se genere un reporte de ventas en Nappai, se envíe automáticamente un mensaje a un canal de Slack/Google Chat llamado “Ventas Diarias”.

  1. Configuras el componente Google Chat Messages.
  2. En Space, seleccionas el espacio “Ventas Diarias”.
  3. En Message Text, escribes o mapeas el texto del reporte: “El reporte de hoy muestra un aumento del 10%”.
  4. Ejecutas el flujo.
  5. El sistema envía el mensaje a Google Chat y te devuelve el Data con el ID del mensaje, que puedes usar luego para verificar si alguien respondió.

Consejos y Mejores Prácticas

  • Valida los IDs: Si vas a editar o eliminar un mensaje, asegúrate de tener el Message ID correcto. Puedes obtener este ID enviando primero el mensaje y capturando la salida.
  • Mensajes Directos vs. Espacios: Usa Recipient Email solo para mensajes privados (DM). Para grupos o canales públicos, usa el campo Space.
  • Manejo de Errores: Si la operación falla, la salida Data te permitirá identificar si el problema fue una credencial incorrecta, un ID inválido o un problema de permisos.

Consideraciones de Seguridad

  • Asegúrate de mantener tus credenciales de Google Cloud (Client ID y Client Secret) en el panel de Nappai solo con usuarios autorizados.
  • Ten cuidado al utilizar funciones de eliminación (delete) en tus flujos, ya que los datos borrados en Google Chat no suelen tener “papelera de reciclaje” para usuarios automáticos.