Saltearse al contenido
Nappai Documentation

GoogleCalendarWebhook

El GoogleCalendarWebhook es un nodo que funciona como un “escucha” inteligente dentro de tu sistema de automatización Nappai. Su principal propósito estar atento a cualquier cambio que ocurra en un calendario de Google (como crear, modificar o eliminar una reunión o evento) y capturar esa información en el momento exacto en que sucede. De esta manera, puedes activar automáticamente otras acciones en tus flujos de trabajo sin tener que revisar el calendario manualmente.

¿Cómo funciona?

Cuando un evento en tu calendario de Google se crea, actualiza o elimina, Google envía una notificación instantánea (llamada webhook) a Nappai. Este componente intercepta esa notificación, la verifica según el calendario y los tipos de cambios que te interesan, y luego prepara la información en un formato estructurado.

Gracias a un sistema de sincronización inteligente, revisa solo los cambios recientes en cada ciclo, lo que mantiene el proceso rápido y eficiente sin sobrecargar tu sistema. Además, el nodo es capaz de adaptarse automáticamente: si cambias tus credenciales o tu cuenta de Google, la lista de calendarios disponibles se actualiza en tiempo real para que siempre estés trabajando con la información más reciente.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo:

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo Google Calendar y guarda los campos requeridos (Project, Client Id, Client Secret y el acceso al calendario de Google).
  3. En tu flujo de trabajo, selecciona la credencial que acabas de guardar en el campo de entrada Credential de este nodo.

Entradas

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Calendar: Permite seleccionar el calendario específico de Google que deseas monitorear. Puedes actualizar la lista en cualquier momento para ver los calendarios disponibles en tu cuenta.
  • Events: Define qué tipos de cambios en el calendario deben activar la automatización. Por defecto, escucha todos los tipos: evento creado, evento actualizado y evento eliminado.

Salidas

Cuando este componente detecta un cambio, envía la información en un formato estructurado que otros nodos pueden entender y procesar. A continuación, se muestra un ejemplo de cómo luce esa respuesta: json { “text”: “[created] Reunión de planificación del equipo”, “data”: { “type”: “created”, “id”: “evt_abc123xyz”, “summary”: “Reunión de planificación del equipo”, “start”: “2023-10-25T10:00:00”, “end”: “2023-10-25T11:00:00”, “status”: “confirmed”, “organizer”: “coordinador@empresa.com” } } Esta salida contiene un resumen legible para lectura rápida y un conjunto detallado de metadatos (como fechas, estados y responsables) que podrás conectar con otros componentes para tomar acciones automáticas, como enviar recordatorios, crear tareas en una plataforma de gestión o notificar a miembros del equipo.

Conectividad

Las salidas de este componente están diseñadas para fluir naturalmente hacia nodos que ejecuten acciones basadas en eventos. Es común conectarlo a:

  • Nodos de Notificación: Para enviar correos electrónicos, mensajes en Slack/Teams o alertas cuando se crea una nueva reunión.
  • Plataformas de CRM o Bases de Datos: Para registrar automáticamente nuevos eventos, citas o clientes agendados.
  • Nodos de Lógica o Filtro: Para tomar decisiones condicionales (ej. solo procesar reuniones que coincidan con ciertas reglas, horarios o participantes). Esta conexión permite que los cambios en el calendario activen directamente tu ecosistema de automatización, manteniendo todos tus sistemas sincronizados en tiempo real.

Ejemplo de Uso

Imagina que quieres automatizar el envío de un recordatorio por correo electrónico 15 minutos antes de cada reunión, o registrar automáticamente una nueva cita en tu sistema de gestión de clientes.

  1. En este nodo, seleccionas el calendario de trabajo de tu equipo y activas la opción Event Created.
  2. Cuando alguien agenda una nueva reunión en Google Calendar, el componente detecta el cambio y captura los datos.
  3. La información fluye hacia un nodo de “Enviar Correo” o “Crear Registro”, que automáticamente envía la invitación, genera un enlace de videoconferencia o guarda la información en tu base de datos, todo sin intervención manual.

Consejos y Mejores Prácticas

  • Verifica que la credencial de Google Calendar tenga permisos de lectura/escritura para que las actualizaciones se sincronicen correctamente.
  • Usa la opción Events solo con los cambios que realmente necesites procesar para evitar flujos innecesarios y optimizar el rendimiento.
  • Si trabajas con múltiples calendarios, asegúrate de vincular cada uno a un flujo diferente o usar filtros para evitar cruces de información.
  • Mantén tus flujos de automatización simples; si un nodo recibe demasiada información a la vez, considera añadir un paso de validación o pausa antes de la acción final.
  • El botón de actualización en el campo Calendar es dinámico: úsalo si acabas de crear un nuevo calendario en tu cuenta de Google para que aparezca inmediatamente en la lista.

Consideraciones de Seguridad

  • Asegúrate de almacenar tus credenciales de Google en un lugar seguro y de restringir su acceso solo a usuarios autorizados dentro de Nappai.
  • La sincronización se realiza mediante protocolos de seguridad estandarizados (OAuth 2.0), por lo que tu información nunca se almacena en texto plano ni se comparte con terceros no autorizados.
  • Revisa periódicamente los permisos otorgados a la aplicación en tu cuenta de Google para mantener un control estricto sobre qué datos se automatizan.
  • En caso de errores de conexión o credenciales vencidas, el componente está diseñado para no interrumpir el flujo de trabajo, devolviendo estructuras vacías de forma segura hasta que se restaure la conexión.