# Configuración de n8n — Seguimiento de Impuestos GLM

Este proyecto incluye tres workflows independientes para facilitar pruebas y mantenimiento.

## 1. Recordatorios por Gmail y Google Chat

Archivo:

`Seguimiento-de-Impuestos-GLM-Recordatorios-Actualizado.json`

- Se ejecuta diariamente a las 8:00 a. m. en `America/Santo_Domingo`.
- Consulta `tax_due_reminders` en Supabase.
- Envía correos HTML con identidad visual GLM.
- Envía mensajes por Google Chat.
- Registra cada envío para evitar duplicados.

Después de importar:

1. Seleccionar la credencial correcta en `Gmail - Enviar recordatorio`.
2. Confirmar la URL y API key del nodo de Google Chat.
3. Desactivar el workflow anterior antes de activar este, para evitar duplicados.
4. Ejecutar una prueba manual con una fecha controlada.

## 2. Búsqueda de contactos en BambooHR

Archivo:

`Seguimiento-de-Impuestos-GLM-BambooHR-Contactos.json`

Production URL esperada:

`https://agenteit.digitalcompass.agency/webhook/seguimiento-impuestos-bamboohr-contacto`

Después de importar:

1. Abrir `Generar reporte completo BambooHR`.
2. Confirmar la credencial `BambooHR GLM Full Access`.
3. Activar el workflow.
4. Probar con:

```json
{
  "action": "search_contact",
  "full_name": "Nombre Apellido"
}
```

El workflow normaliza nombres, tolera tildes y diferencias menores, prioriza coincidencias exactas y devuelve hasta ocho candidatos con país, teléfono, área, cargo, correo y estado.

## 3. Sincronización con Google Calendar

Archivo:

`Seguimiento-de-Impuestos-GLM-Google-Calendar.json`

Production URL esperada:

`https://agenteit.digitalcompass.agency/webhook/seguimiento-impuestos-google-calendar`

Antes de activarlo, ejecutar en Supabase:

`../supabase/actualizacion_bamboohr_google_calendar.sql`

Después de importar:

1. Crear o seleccionar una credencial OAuth2 de Google Calendar.
2. Asignarla en estos nodos:
   - `Google Calendar - Crear evento`
   - `Google Calendar - Actualizar evento`
   - `Google Calendar - Eliminar evento`
3. Verificar que la cuenta conectada sea la cuenta organizadora de los eventos.
4. Activar el workflow.

Cada obligación crea un evento de 8:00 a. m. a 9:00 a. m., hora de República Dominicana, e invita a los contactos aplicables. Las modificaciones y eliminaciones realizadas antes del primer aviso también se sincronizan.

## Orden recomendado de despliegue

1. Ejecutar el parche SQL.
2. Importar y activar BambooHR.
3. Importar y activar Google Calendar.
4. Reemplazar el workflow de recordatorios.
5. Desplegar el frontend actualizado.
6. Probar un contacto y una obligación futura de prueba.


## Google Chat — mensajes directos

El workflow de recordatorios usa una credencial **Google Chat OAuth2 API** con los scopes incluidos por n8n (`chat.spaces`, `chat.messages` y `chat.memberships`). Después de importar:

1. Habilita Google Chat API en el proyecto de Google Cloud.
2. Crea o selecciona una credencial `Google Chat OAuth2 API` en n8n.
3. Asígnala a `Google Chat - Abrir DM` y `Google Chat - Enviar recordatorio`.
4. Autentica con la cuenta corporativa que enviará los mensajes.
5. Ejecuta una prueba manual antes de activar el Schedule Trigger.

El flujo crea o reutiliza un mensaje directo con el correo corporativo del contacto, envía el aviso y registra el resultado en `tax_notification_log` con canal `google_chat`.