Conexión con Evolution API para servicio de mensajería IA
Budget: $1,500 – $3,000 USD
Objetivo
Implementar una API que permita conectar múltiples números de WhatsApp utilizando Evolution API (no oficial) para integrarse con un sistema SaaS que provee asistentes virtuales con inteligencia artificial.
Requerimientos Generales
- Soporte multi-cuenta: conectar múltiples números simultáneamente.
- Cada número debe tener una sesión aislada.
- Consultar en todo momento los números conectados.
- Monitoreo del estado de conexión (online/offline).
- Agregar/eliminar números dinámicamente.
- Reinicio automático o manual de sesiones ante problemas.
- Registro de logs de conexión, desconexión y errores (por número).
Autenticación y QR
- Generación de código QR único por cada número.
- Regeneración automática o manual del QR si la sesión se invalida.
- Manejo de múltiples sesiones simultáneas sin conflictos de token o conexión.
Mensajería y Comunicación
Envío de:
- Mensajes de texto.
-Imágenes.
-Audios.
- Archivos/documentos.
- Recepción de mensajes en tiempo real.
Registro de eventos:
- Mensaje entregado.
- Mensaje leído.
- Manejo de colas de envío (rate limit / antispam).
- Reintentos automáticos ante errores temporales.
Seguridad
- Aislamiento de sesiones y credenciales por número y por cliente.
- Cifrado de credenciales/tokens sensibles.
- Validación de seguridad para los webhooks entrantes.
Escalabilidad
- Arquitectura preparada para escalar horizontalmente sin reconfiguración manual.
Documentar:
- Límites técnicos actuales de Evolution API.
-Estrategias de mitigación para futuras escalas.
Logs y Alertas
Registro de:
- Estado de conexión.
- Errores en envío y recepción.
- Alertas automáticas (por correo o interno) ante desconexiones frecuentes o fallas reiteradas.
Integración con SaaS (software propio)
Exponer una API REST para:
- Enviar mensajes.
-Consultar estado.
- Gestionar conexiones.
- Webhooks configurables para recepción de eventos entrantes.
- Documentación estilo Swagger/OpenAPI:
-Endpoints.
- Parámetros.
- Ejemplos.
Notas específicas a validar con Evolution API
Límite recomendado de números por servidor.
Mecanismos de recuperación ante baneos/bloqueos.
Soporte para reconexión automática ante pérdida de sesión.
Entregables
- Diagrama de arquitectura de manejo de sesiones.
- Manual de conexión para clientes finales (con capturas si aplica).
-Scripts de instalación/configuración de entorno (docker, PM2, etc.).
-Documentación completa de la API y webhooks.
-Validación funcional del envío y recepción de mensajes desde el frontend en Aurelia.
Perfil buscado
Experiencia previa con APIs de WhatsApp no oficiales (preferentemente Evolution API o similares como Baileys, Venom, etc.).
Experiencia en Node.js y manejo de sockets/eventos.
Conocimientos de despliegue (Docker, PM2, entornos Linux).
Valoramos conocimientos de seguridad y buenas prácticas RESTful.
Implementar una API que permita conectar múltiples números de WhatsApp utilizando Evolution API (no oficial) para integrarse con un sistema SaaS que provee asistentes virtuales con inteligencia artificial.
Requerimientos Generales
- Soporte multi-cuenta: conectar múltiples números simultáneamente.
- Cada número debe tener una sesión aislada.
- Consultar en todo momento los números conectados.
- Monitoreo del estado de conexión (online/offline).
- Agregar/eliminar números dinámicamente.
- Reinicio automático o manual de sesiones ante problemas.
- Registro de logs de conexión, desconexión y errores (por número).
Autenticación y QR
- Generación de código QR único por cada número.
- Regeneración automática o manual del QR si la sesión se invalida.
- Manejo de múltiples sesiones simultáneas sin conflictos de token o conexión.
Mensajería y Comunicación
Envío de:
- Mensajes de texto.
-Imágenes.
-Audios.
- Archivos/documentos.
- Recepción de mensajes en tiempo real.
Registro de eventos:
- Mensaje entregado.
- Mensaje leído.
- Manejo de colas de envío (rate limit / antispam).
- Reintentos automáticos ante errores temporales.
Seguridad
- Aislamiento de sesiones y credenciales por número y por cliente.
- Cifrado de credenciales/tokens sensibles.
- Validación de seguridad para los webhooks entrantes.
Escalabilidad
- Arquitectura preparada para escalar horizontalmente sin reconfiguración manual.
Documentar:
- Límites técnicos actuales de Evolution API.
-Estrategias de mitigación para futuras escalas.
Logs y Alertas
Registro de:
- Estado de conexión.
- Errores en envío y recepción.
- Alertas automáticas (por correo o interno) ante desconexiones frecuentes o fallas reiteradas.
Integración con SaaS (software propio)
Exponer una API REST para:
- Enviar mensajes.
-Consultar estado.
- Gestionar conexiones.
- Webhooks configurables para recepción de eventos entrantes.
- Documentación estilo Swagger/OpenAPI:
-Endpoints.
- Parámetros.
- Ejemplos.
Notas específicas a validar con Evolution API
Límite recomendado de números por servidor.
Mecanismos de recuperación ante baneos/bloqueos.
Soporte para reconexión automática ante pérdida de sesión.
Entregables
- Diagrama de arquitectura de manejo de sesiones.
- Manual de conexión para clientes finales (con capturas si aplica).
-Scripts de instalación/configuración de entorno (docker, PM2, etc.).
-Documentación completa de la API y webhooks.
-Validación funcional del envío y recepción de mensajes desde el frontend en Aurelia.
Perfil buscado
Experiencia previa con APIs de WhatsApp no oficiales (preferentemente Evolution API o similares como Baileys, Venom, etc.).
Experiencia en Node.js y manejo de sockets/eventos.
Conocimientos de despliegue (Docker, PM2, entornos Linux).
Valoramos conocimientos de seguridad y buenas prácticas RESTful.