⚡ Procesamiento en Cola de Peticiones para Webhooks

📋 ¿En qué consiste esta actualización?

Cuando ejecutas envíos masivos mediante Webhooks con un volumen alto de contactos, Atom procesa e inicializa las peticiones agregándolas dinámicamente a una cola de procesamiento. Esta mejora arquitectónica protege tu operación al evitar saturaciones de red y garantizar que la plataforma intente procesar el 100% de las solicitudes.

Aspecto	Comportamiento
Garantía del sistema	Asegura que Atom intente enviar la plantilla en el 100% de las ejecuciones recibidas sin rebasar la tasa de peticiones del API de Meta.
Filtros externos	La entrega final en el dispositivo del cliente continuará dependiendo de la calidad de la plantilla y de los algoritmos de entrega de Meta (como MM Lite).
Retrocompatibilidad	La actualización es 100% transparente. No necesitas volver a crear ni modificar tus Webhooks configurados en Atom.

🛠️ Cambio en el Código de Respuesta HTTP (Status 202)

Para confirmar la recepción inmediata en campañas de gran escala, el motor de Atom responde con un código de estado HTTP 202 (Accepted) tan pronto como valida que la petición no contiene errores de parámetros.

Este código significa que Atom recibió y aceptó la solicitud correctamente y la ha encolado para su posterior ejecución en el turno correspondiente.

⚠️ Importante: Si tu CRM o sistema externo evalúa estrictamente el código de respuesta del servidor al disparar hacia Atom, debes actualizar la regla de validación de tu sistema para aceptar el código 202 (en lugar del código 200 anterior).

🔍 Matriz de Códigos de Respuesta HTTP

Utiliza la siguiente referencia técnica para auditar las respuestas enviadas por Atom al ejecutar o encolar un Webhook:

Código HTTP	Condición de Sistema	Mensaje de Error / Estado	Detalle Operativo
202	Webhook encolado exitosamente	`Webhook task has been queued for processing`	✅ Éxito: La petición fue aceptada y se agregó a la cola.
200	Ejecución inmediata exitosa	`Webhook ejecutado satisfactoriamente`	✅ Éxito: Petición procesada directamente.
400	Identificador inválido o vacío	`Invalid Webhook ID`	El `webhookId` no puede ser procesado.
400	Parámetros faltantes	`Missing params: {lista}`	Faltan variables obligatorias definidas en el body.
400	Faltan datos de contacto	`Missing phone number` / `Invalid phone number`	El teléfono no está presente o su formato no es válido.
401	Token ausente o formato inválido	`Authorization header required`	Falta el token de autorización o el formato no es UUID.
403	Estado inactivo o bloqueo	`Webhook is not active` / `Disabled due to failed attempts`	Deshabilitado por configuración o superó 1,000 intentos fallidos.
404	Registro no encontrado	`Webhook not found` / `Company not found`	El ID del Webhook o de la empresa no existe en Atom.
500	Error interno del servidor	`Internal server error` / `Failed to create queue task`	Ocurrió una excepción al procesar la cola.

💡 Tip: Revisa la integración de tus sistemas externos para asegurarte de que registren el código 202 como un disparo exitoso. Esto evitará reintentos innecesarios o falsos positivos en los logs de tu CRM.

Con la implementación de la cola de procesamiento en Webhooks, tus campañas masivas ganan estabilidad y confiabilidad absoluta. Al mantener tu tasa de peticiones en rangos óptimos para Meta, aseguras una operación fluida y preparada para escalar al ritmo de tu negocio. ✅