Integrador Wazend + n8n + OpenAI, Cumplimiento WhatsApp
Budget: $30 – $250 USD
PROYECTO FREELANCER
Integración Wazend + n8n + OpenAI con cumplimiento estricto de políticas WhatsApp
⸻
1. Objetivo del proyecto
Desarrollar un sistema automatizado de atención al cliente por WhatsApp Business utilizando:
• Wazend (ya operativo)
• n8n como motor de automatización
• OpenAI API como motor de generación de respuestas
El sistema debe:
1. Recoger múltiples mensajes enviados por un cliente.
2. Agruparlos.
3. Generar una única respuesta consolidada.
4. Cumplir estrictamente las políticas oficiales de WhatsApp Business (Meta).
5. Evitar spam, flooding, duplicaciones y ejecuciones paralelas.
6. Respetar la ventana de 24 horas.
7. Respetar horarios y reglas de cita definidos.
⸻
2. Stack tecnológico obligatorio
• WhatsApp Business API (a través de Wazend)
• n8n
• OpenAI API
• Webhooks
• Sistema de control de estado por conversación (base de datos ligera o almacenamiento temporal si es necesario)
No se aceptarán soluciones que utilicen APIs no oficiales o automatización no permitida por Meta.
⸻
3. Cumplimiento obligatorio de políticas WhatsApp
El sistema debe cumplir estrictamente con:
3.1 Ventana de servicio de 24 horas
• Solo se podrá enviar mensaje libre si el cliente ha iniciado conversación dentro de las últimas 24 horas.
• Fuera de la ventana de 24 horas solo se podrán enviar plantillas previamente aprobadas por Meta.
• El sistema debe verificar automáticamente esta condición antes de enviar respuesta.
⸻
3.2 Prohibición de spam y flooding
• No enviar múltiples mensajes consecutivos por cada mensaje recibido.
• No fragmentar respuestas en varios envíos.
• No enviar mensajes promocionales no solicitados.
• No generar comportamiento automatizado agresivo.
⸻
3.3 Prevención de duplicaciones
• Control de concurrencia por número de teléfono.
• Bloqueo (lock) por conversación activa.
• Prevención de ejecución paralela.
• Sistema idempotente ante reintentos de webhook.
• Registro de mensaje procesado para evitar doble respuesta.
⸻
3.4 Uso correcto de plantillas
En caso de uso de plantillas:
• Deben estar aprobadas en Meta Business Manager.
• Deben utilizarse según la categoría correcta (servicio, utilidad o marketing).
• No deben usarse fuera de su contexto permitido.
⸻
4. Funcionalidades técnicas obligatorias
4.1 Sistema anti-colapso (crítico)
Cuando un cliente envía múltiples mensajes seguidos:
• El sistema debe esperar un intervalo configurable (ejemplo: 10–20 segundos).
• Debe agrupar todos los mensajes recibidos en ese intervalo.
• Debe enviar el texto consolidado a OpenAI.
• Debe generar una única respuesta.
• Debe enviar una sola respuesta final al cliente.
No puede responder mensaje por mensaje.
⸻
4.2 Control de ejecución
El flujo debe:
• Ejecutarse en modo secuencial.
• Incluir mecanismo de bloqueo por conversación.
• Evitar condiciones de carrera.
• Evitar ejecuciones duplicadas por reintentos de webhook.
⸻
4.3 Prompt configurable
El prompt será proporcionado por mí.
El freelancer debe:
• Integrarlo correctamente.
• Validar que OpenAI responde en un único bloque coherente.
• Ajustar estructura técnica si es necesario.
• Optimizar el uso de tokens.
⸻
4.4 Control de horarios y citas
El bot debe respetar reglas configurables, por ejemplo:
• Lunes a viernes
• 08:00–13:00
• 16:00–18:30
• Sin fines de semana
El sistema debe:
• No ofrecer citas fuera de horario.
• No ofrecer días no laborables.
• Ajustar respuesta automáticamente según disponibilidad.
⸻
4.5 Manejo de errores
Debe incluir:
• Registro de logs.
• Manejo de timeout de OpenAI.
• Reintentos controlados.
• Notificación interna en caso de fallo crítico.
• Prevención de bucles infinitos.
⸻
5. Arquitectura esperada
Cliente
↓
Wazend (Webhook entrante)
↓
n8n (Buffer + Lock + Validación 24h + Validación horario)
↓
OpenAI API
↓
n8n
↓
Wazend (Respuesta única consolidada)
⸻
6. Entregables
• Workflow completo de n8n exportado en JSON.
• Documentación técnica básica de instalación.
• Explicación del sistema de buffer y bloqueo.
• Explicación del control de ventana de 24 horas.
• Pruebas funcionales realizadas.
• Sesión de puesta en marcha.
⸻
7. Perfil requerido
• Experiencia demostrable con n8n.
• Experiencia con WhatsApp Business API.
• Experiencia con Wazend.
• Experiencia con OpenAI API.
• Conocimiento real de políticas de Meta.
⸻
8. Criterios críticos no negociables
• Cumplimiento estricto de políticas WhatsApp.
• Una única respuesta consolidada.
• Sin flooding.
• Sin duplicaciones.
• Sin ejecución paralela.
• Sistema estable y escalable.
⸻
Integración Wazend + n8n + OpenAI con cumplimiento estricto de políticas WhatsApp
⸻
1. Objetivo del proyecto
Desarrollar un sistema automatizado de atención al cliente por WhatsApp Business utilizando:
• Wazend (ya operativo)
• n8n como motor de automatización
• OpenAI API como motor de generación de respuestas
El sistema debe:
1. Recoger múltiples mensajes enviados por un cliente.
2. Agruparlos.
3. Generar una única respuesta consolidada.
4. Cumplir estrictamente las políticas oficiales de WhatsApp Business (Meta).
5. Evitar spam, flooding, duplicaciones y ejecuciones paralelas.
6. Respetar la ventana de 24 horas.
7. Respetar horarios y reglas de cita definidos.
⸻
2. Stack tecnológico obligatorio
• WhatsApp Business API (a través de Wazend)
• n8n
• OpenAI API
• Webhooks
• Sistema de control de estado por conversación (base de datos ligera o almacenamiento temporal si es necesario)
No se aceptarán soluciones que utilicen APIs no oficiales o automatización no permitida por Meta.
⸻
3. Cumplimiento obligatorio de políticas WhatsApp
El sistema debe cumplir estrictamente con:
3.1 Ventana de servicio de 24 horas
• Solo se podrá enviar mensaje libre si el cliente ha iniciado conversación dentro de las últimas 24 horas.
• Fuera de la ventana de 24 horas solo se podrán enviar plantillas previamente aprobadas por Meta.
• El sistema debe verificar automáticamente esta condición antes de enviar respuesta.
⸻
3.2 Prohibición de spam y flooding
• No enviar múltiples mensajes consecutivos por cada mensaje recibido.
• No fragmentar respuestas en varios envíos.
• No enviar mensajes promocionales no solicitados.
• No generar comportamiento automatizado agresivo.
⸻
3.3 Prevención de duplicaciones
• Control de concurrencia por número de teléfono.
• Bloqueo (lock) por conversación activa.
• Prevención de ejecución paralela.
• Sistema idempotente ante reintentos de webhook.
• Registro de mensaje procesado para evitar doble respuesta.
⸻
3.4 Uso correcto de plantillas
En caso de uso de plantillas:
• Deben estar aprobadas en Meta Business Manager.
• Deben utilizarse según la categoría correcta (servicio, utilidad o marketing).
• No deben usarse fuera de su contexto permitido.
⸻
4. Funcionalidades técnicas obligatorias
4.1 Sistema anti-colapso (crítico)
Cuando un cliente envía múltiples mensajes seguidos:
• El sistema debe esperar un intervalo configurable (ejemplo: 10–20 segundos).
• Debe agrupar todos los mensajes recibidos en ese intervalo.
• Debe enviar el texto consolidado a OpenAI.
• Debe generar una única respuesta.
• Debe enviar una sola respuesta final al cliente.
No puede responder mensaje por mensaje.
⸻
4.2 Control de ejecución
El flujo debe:
• Ejecutarse en modo secuencial.
• Incluir mecanismo de bloqueo por conversación.
• Evitar condiciones de carrera.
• Evitar ejecuciones duplicadas por reintentos de webhook.
⸻
4.3 Prompt configurable
El prompt será proporcionado por mí.
El freelancer debe:
• Integrarlo correctamente.
• Validar que OpenAI responde en un único bloque coherente.
• Ajustar estructura técnica si es necesario.
• Optimizar el uso de tokens.
⸻
4.4 Control de horarios y citas
El bot debe respetar reglas configurables, por ejemplo:
• Lunes a viernes
• 08:00–13:00
• 16:00–18:30
• Sin fines de semana
El sistema debe:
• No ofrecer citas fuera de horario.
• No ofrecer días no laborables.
• Ajustar respuesta automáticamente según disponibilidad.
⸻
4.5 Manejo de errores
Debe incluir:
• Registro de logs.
• Manejo de timeout de OpenAI.
• Reintentos controlados.
• Notificación interna en caso de fallo crítico.
• Prevención de bucles infinitos.
⸻
5. Arquitectura esperada
Cliente
↓
Wazend (Webhook entrante)
↓
n8n (Buffer + Lock + Validación 24h + Validación horario)
↓
OpenAI API
↓
n8n
↓
Wazend (Respuesta única consolidada)
⸻
6. Entregables
• Workflow completo de n8n exportado en JSON.
• Documentación técnica básica de instalación.
• Explicación del sistema de buffer y bloqueo.
• Explicación del control de ventana de 24 horas.
• Pruebas funcionales realizadas.
• Sesión de puesta en marcha.
⸻
7. Perfil requerido
• Experiencia demostrable con n8n.
• Experiencia con WhatsApp Business API.
• Experiencia con Wazend.
• Experiencia con OpenAI API.
• Conocimiento real de políticas de Meta.
⸻
8. Criterios críticos no negociables
• Cumplimiento estricto de políticas WhatsApp.
• Una única respuesta consolidada.
• Sin flooding.
• Sin duplicaciones.
• Sin ejecución paralela.
• Sistema estable y escalable.
⸻