97 lines
3.3 KiB
Markdown
97 lines
3.3 KiB
Markdown
# 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`.
|