Actualiza frontend, integraciones y dist de producción
This commit is contained in:
+83
-24
@@ -1,37 +1,96 @@
|
||||
# Configuración del flujo n8n
|
||||
# Configuración de n8n — Seguimiento de Impuestos GLM
|
||||
|
||||
Después de importar `Seguimiento-de-Impuestos-GLM.json`:
|
||||
Este proyecto incluye tres workflows independientes para facilitar pruebas y mantenimiento.
|
||||
|
||||
1. En el nodo **Gmail - Enviar recordatorio**, selecciona la credencial de Gmail que enviará los correos.
|
||||
2. Configura estas variables de entorno en n8n:
|
||||
## 1. Recordatorios por Gmail y Google Chat
|
||||
|
||||
```env
|
||||
SUPABASE_URL=https://dbit.digitalcompass.agency
|
||||
SUPABASE_SERVICE_ROLE_KEY=REEMPLAZAR
|
||||
WHATSAPP_BASE_URL=https://wsp.gomezleemarketing.com
|
||||
WHATSAPP_INSTANCE=botsoporte
|
||||
WHATSAPP_API_KEY=REEMPLAZAR_CON_LA_APIKEY
|
||||
GLM_TAX_APP_URL=https://digitalcompass.agency/calendario-impuestos/
|
||||
GLM_LOGO_URL=https://dbit.digitalcompass.agency/storage/v1/object/public/public-assets/GLM.png
|
||||
```
|
||||
Archivo:
|
||||
|
||||
3. Activa el workflow. El Schedule Trigger está configurado para las 8:00 AM en `America/Santo_Domingo`.
|
||||
4. Para una prueba manual, usa **Ejecutar manualmente**. Para ejecutar una fecha específica por webhook:
|
||||
`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": "run_now",
|
||||
"run_date": "2026-07-24"
|
||||
"action": "search_contact",
|
||||
"full_name": "Nombre Apellido"
|
||||
}
|
||||
```
|
||||
|
||||
Las notificaciones del frontend (`contact.created`, `obligation.created`, etc.) sólo confirman cambios y no disparan recordatorios.
|
||||
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.
|
||||
|
||||
## Enrutamiento regional por categoría
|
||||
## 3. Sincronización con Google Calendar
|
||||
|
||||
El workflow no requiere cambios para los nuevos contactos de Nómina. La RPC `tax_due_reminders` devuelve automáticamente:
|
||||
Archivo:
|
||||
|
||||
- contactos con área `regional`: todas las obligaciones;
|
||||
- contactos del país Regional con área `nomina`: Nómina de todos los países;
|
||||
- contactos del país Regional con área `admin`: Administración de todos los países;
|
||||
- contactos de un país específico: únicamente la categoría de ese país.
|
||||
`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`.
|
||||
|
||||
Reference in New Issue
Block a user