Necesitamos un desarrollador con experiencia en la implementación de APIs para construir una solución que permita conectar múltiples números de WhatsApp a nuestro sistema SaaS de asistentes virtuales con inteligencia artificial. La API debe utilizar la Evolution API (no oficial) como base.
🧩 Proyecto: Conexión con Evolution api para servicio de mensajería ia
🎯 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.
Plazo de Entrega: No definido