Enviar un mensaje a Google Chat cuando se añade un registro

Idioma: Español

Este artículo se ha traducido del inglés mediante IA y puede contener errores. Sus comentarios nos ayudarán a mejorar.

En este tutorial configuramos una automatización que publica un mensaje en un espacio de Google Chat cada vez que se añade un nuevo registro a un formulario, directamente desde ActivityInfo, sin ninguna herramienta de flujo de trabajo intermediaria.

Asumimos el rol de un coordinador cuyo equipo trabaja en un espacio de Google Chat. El equipo hace un seguimiento de los proyectos en un formulario de Proyectos y quiere que cada nuevo proyecto enviado se anuncie en el espacio a medida que llega.

Lo que necesita

Un formulario para supervisar. El nuestro es un formulario de Proyectos con un campo de texto Nombre del proyecto con el código NAME y un campo de referencia Asociado con el código PARTNER, pero cualquier formulario servirá; ajuste las referencias de los campos a los suyos.
Permiso para diseñar la base de datos en ActivityInfo.
Un espacio de Google Chat en el que pueda añadir webhooks. Los webhooks entrantes son una función de Google Workspace; es posible que un administrador del espacio deba permitirlos.

Hacemos referencia a los campos por su código en todo momento (NAME en lugar de [Nombre del proyecto]). Si sus campos aún no tienen códigos, tómese un minuto para añadirlos en el diseñador de formularios: los códigos mantienen las plantillas legibles y sobreviven a los cambios de etiqueta.

Paso 1: Crear un webhook entrante en Google Chat

En Google Chat, abra el espacio que debe recibir los mensajes.
Haga clic en el nombre del espacio y, a continuación, en Aplicaciones e integraciones.
En Webhooks, seleccione Añadir webhooks.
Asigne un nombre al webhook, por ejemplo "ActivityInfo", y guarde.
Copie la URL del webhook; empieza por https://chat.googleapis.com/v1/spaces/....

Captura de pantalla de los ajustes del webhook en el espacio de Google Chat

Paso 2: Añadir la automatización

En ActivityInfo, abra la base de datos, seleccione el formulario Proyectos y seleccione Automatizaciones en el panel de detalles del formulario.
Seleccione Añadir automatización y asígnele el nombre "Anunciar nuevos proyectos en Chat".
Seleccione Haga clic aquí para empezar y elija el desencadenador Cuando se añade un registro.
Etiquete el desencadenador, seleccione Seleccionar formulario, elija el formulario Proyectos, confirme y seleccione Está hecho.

Paso 3: Añadir el paso de webhook

Seleccione Añadir paso, luego Acción y, a continuación, Ejecutar webhook.
Asigne una etiqueta al paso, por ejemplo "Publicar en el espacio de Chat".
Pegue la URL del webhook de Google Chat en el campo URL de webhook.
Establezca el Formato de carga útil en Personalizado: Google Chat espera un mensaje en su propia forma JSON, y el formato personalizado nos permite escribirlo exactamente.

Captura de pantalla del paso de Webhook personalizado

Paso 4: Escribir el mensaje

Seleccione Editar carga útil.
Ingrese el cuerpo del mensaje que Google Chat espera: un objeto JSON con una única propiedad text. Las referencias ${...} se rellenan a partir del registro que ha activado la automatización; la lista de campos de la derecha las inserta por usted:
```
{"text": "📋 Nuevo proyecto enviado: *${NAME}* por ${PARTNER.NAME}, añadido por ${_user.name}"}
```
Google Chat representa los *asteriscos* en negrita. Los valores se escapan automáticamente para JSON, por lo que los nombres de proyecto que contengan comillas o saltos de línea no pueden romper el mensaje.
Seleccione Está hecho para cerrar el editor de la carga útil, y Está hecho de nuevo para cerrar el paso.
Seleccione Guardar. La automatización ya está activa.

Paso 5: Probar

Añada un registro de prueba al formulario de Proyectos.
En unos instantes, el mensaje aparecerá en el espacio de Google Chat con los detalles del proyecto rellenados.

Para ir más allá

Anunciar solo algunos proyectos: añada un paso de filtro entre el desencadenador y el webhook; por ejemplo, CONTAINS(SECTORS, "Health") para anunciar solo los proyectos del sector de la salud.
Anunciar cambios de estado en su lugar: utilice el desencadenador Cuando se edita el registro con el filtro STATUS != _previous.STATUS, e incluya ambos valores en el mensaje: ${_previous.STATUS} → ${STATUS}.
Cualquier fórmula funciona dentro de ${...}: ${IF(BUDGET >= 100000, '🔴 grande', 'estándar')}.