Google Calendar Webhook

Google Calendar Webhook pone en marcha un flujo cada vez que cambia un evento en un calendario de Google: cuando se crea uno nuevo, cuando se modifica uno existente o cuando se cancela o se elimina.

NappAI revisa el calendario aproximadamente cada minuto y, si encuentra cambios, ejecuta el flujo con los datos de cada evento afectado. No tienes que configurar nada en Google: basta con la credencial y con suscribir el flujo.

Cuándo usarlo

• Quieres avisar a tu equipo por correo o por mensajería cuando alguien reserva una reunión en el calendario compartido.
• Cada evento nuevo debe registrarse en una hoja de cálculo o en tu CRM.
• Cuando se cancela una cita, quieres liberar el hueco en otro sistema o avisar al cliente.
• Quieres que un agente de IA prepare un resumen de cada reunión que se añade al calendario.

Configuración

Necesitas una credencial Google Calendar, que se conecta iniciando sesión con tu cuenta de Google. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Google Calendar de la cuenta que quieres vigilar.
Calendar	El calendario que se vigila. Pulsa el botón de actualizar para cargar la lista de tus calendarios. Si lo dejas vacío, se vigila tu calendario principal.
Events	Los cambios que inician el flujo: Event Created (se crea un evento), Event Updated (se modifica un evento) y Event Deleted (se cancela o se elimina un evento). Por defecto, los tres. Si no eliges ninguno, se usan los tres.
Data	Campo de prueba. Te permite probar el flujo con un evento de ejemplo sin esperar a que ocurra un cambio real en el calendario. Déjalo vacío en el uso normal.

Cómo se distingue un evento nuevo

Un evento cuenta como Event Created si se modifica por última vez en los dos minutos siguientes a su creación. Si lo editas más tarde, llega como Event Updated.

Activar la suscripción

El flujo solo recibe cambios cuando está suscrito:

1. Guarda el flujo y publica una versión. Para suscribirte necesitas una versión publicada del flujo. Consulta Versiones y publicación.
2. En el panel de ajustes del nodo pulsa Suscribirse.
3. En el panel que se abre pulsa Suscribirse. El estado pasa a Sincronizado.

Solo llegan los cambios que ocurren después de suscribirte. Si más adelante cambias el calendario o los eventos, el estado aparece como Desincronizado: vuelve a suscribirte para aplicar los cambios. Desde el mismo panel puedes Cancelar suscripción cuando ya no quieras recibir cambios.

Resultado

La salida Data contiene un elemento por cada evento que ha cambiado, con el tipo de cambio (created, updated o deleted), el identificador del evento (eventId), su título (summary), el inicio y el fin, su estado y el correo del organizador. Si llegan varios cambios a la vez, salen todos juntos.

Conéctala a Calendar Event para consultar o cambiar el evento, a un agente de IA o a un componente de correo o mensajería.

Ejemplo

Una agencia quiere avisar a su equipo comercial de cada reunión nueva con clientes.

1. Añade Google Calendar Webhook, elige la credencial Google Calendar de la agencia y el calendario Reuniones con clientes en Calendar.
2. En Events deja solo Event Created.
3. Conecta la salida Data a un componente de correo que envíe al equipo el título y la hora de la reunión.
4. Publica el flujo y pulsa Suscribirse.

Buenas prácticas

• Elige solo los eventos que necesitas: el flujo se ejecuta menos veces y solo con lo que te interesa.
• Si el flujo crea o modifica eventos en el mismo calendario que vigila, se volverá a ejecutar con sus propios cambios. Usa otro calendario o filtra dentro del flujo.

Componentes relacionados

• Calendar Event: crear, consultar y cambiar eventos.
• Calendar Calendars: gestionar calendarios.