Catch Up (push) -> HubSpot f__monthly_booked_date

Qué hace

Cuando se agenda una reunión de tipo Catch Up en los calendarios de Google monitoreados (o al disparar una sincronización manual), el sistema identifica al cliente participante y busca su empresa en HubSpot. Si la encuentra, actualiza la empresa marcando el estado de la monthly en "Booked" y guardando la fecha agendada. En caso de no encontrar la empresa o detectar dominios duplicados, envía una notificación de alerta al canal de Slack de operaciones.

Cuándo se rompe

• Aparece una alerta en Slack de "Company no encontrada": significa que el cliente que reservó el Catch Up no está cargado en HubSpot ni su correo/dominio coincide con ninguna empresa existente, por lo que tenés que crear el contacto o asociarlo manualmente.
• Llega un aviso en Slack de "Dominio ambiguo": significa que existen varias empresas registradas con el mismo dominio de correo en HubSpot y el sistema le asignó la fecha a la primera que encontró, requiriendo revisión manual.
• Llega una alerta de "Error de API de HubSpot": significa que falló la conexión con HubSpot por problemas de permisos en la integración o saturación de consultas temporales.

Detalle técnico

• El trigger Schedule 12h renueva las suscripciones push de Google Calendar vía webhook cada 12 horas para la cuenta sales@worldteams.com y cualquier calendario cuyo nombre empiece con Meetings:.
• Los nodos Filter Catch Up y BF Filter Catch Up filtran eventos activos a futuro cuyo título coincida con la regex /catch\s*[-_]?\s*up/i, descartando asistentes con dominio @worldteams.com y recursos de calendario.
• Implementa una cascada de resolución de 4 niveles para encontrar la empresa en HubSpot: N1 por email principal de contacto, N2 por hs_additional_emails, N3 por dominio web de la empresa (ignorando proveedores genéricos como Gmail u Outlook) y N4 por otros contactos asociados al mismo dominio.
• Realiza un PATCH sobre el objeto Company en HubSpot actualizando las propiedades f__monthly_booked_date (timestamp) y f__monthly_status ("Booked").
• Controla la idempotencia guardando los IDs de eventos procesados en staticData por 90 días; ante errores HTTP transitorios (429/5xx), el nodo Marcar Reintentable libera el ID para que pueda reprocesarse con Manual Backfill.
• Las alertas de fallo de API, dominio duplicado y empresa no encontrada se dirigen al canal de Slack C0BME3ATD6H.

Diagrama

Ficha

| Abrir en n8n | 9mb5BefZA0RAbpSB |