Del payload al delivery report en menos de 500ms
Una visión profunda y honesta de cada capa de la plataforma. Nada de "magia" — solo ingeniería sólida, componentes probados en producción y decisiones de diseño explicables.
Pipeline non-blocking de extremo a extremo
Cada capa fue diseñada para sostener miles de millones de mensajes/mes — con garantía de entrega, reintentos inteligentes, rate-limit distribuido y observabilidad total por mensaje.
Tu Backend
App / CRM / ERP
API Gateway
REST · Webhooks · SDKs
Cola Priorizada
Por workspace y tipo
Workers Paralelos
Non-blocking pipeline
Meta Cloud API
WhatsApp Business
Webhooks
Callbacks · Estado
Throughput
Pipeline 100% non-blocking. Colas priorizadas por tenant y tipo de mensaje.
Resiliencia
Reintentos con backoff inteligente y reconciliación periódica con la Meta Cloud API.
Observabilidad
Cada mensaje rastreable end-to-end — logs, métricas, tracing y alertas.
8 pasos del backend a WhatsApp
Paso 01
Ingesta
POST /v1/messages llega al borde
El gateway valida el schema, la firma del token, dedup por idempotency_key y encamina a la cola apropiada. 100% non-blocking — devolvemos 202 en menos de 40ms con un message_id persistido.
Paso 02
Encolado
Cola priorizada por workspace + tipo
Los mensajes se envían a colas separadas por prioridad (critical, high, default, low) y por workspace. Esto garantiza que un volumen pesado de marketing nunca retrase un OTP. Rate-limit distribuido por template y número.
Paso 03
Procesamiento
Workers paralelos consumiendo en bucle
Cada worker toma un batch, hidrata variables del template, aplica reglas de segmentación y dispara a la Meta Cloud API. Pool auto-escalable con backpressure — no sofocamos la API downstream ni en pico.
Paso 04
Meta Cloud API
Entrega a WhatsApp Business
Meta devuelve un id y luego notifica el estado (queued → sent → delivered → read). En caso de error, clasificamos en retryable / terminal y tratamos con la política apropiada.
Paso 05
Reintentos + Reconciliación
El fallo no es el fin — es el comienzo de la reconciliación
Los errores retryable van a un buffer de reintentos con backoff exponencial (2s → 4s → 8s → 16s → 32s → 1min → 5min → 30min). Después de 7 intentos, el mensaje entra en reconciliación continua con Meta cada 6h durante 7 días.
Paso 06
Persistencia
Núcleo de datos como fuente de verdad
Cada transición de estado se persiste con timestamp, metadatos de Meta, costo billable e id de tracing. Índices compuestos por workspace + status + created_at permiten queries en milisegundos incluso con miles de millones de registros.
Paso 07
Webhooks outbound
Tu backend recibe cada evento
Cada transición genera un webhook firmado por HMAC SHA-256 a tu endpoint. Reentrega automática con backoff hasta 24h, ordenamiento por message_id, y replay manual vía dashboard para los últimos 30 días.
Paso 08
Observabilidad
Cada mensaje rastreable end-to-end
Todo el pipeline produce logs estructurados, métricas (Prometheus) y spans de tracing (OpenTelemetry). Un único trace_id te lleva de la ingesta al webhook outbound. Dashboards Grafana públicos por tenant.
Tres decisiones arquitectónicas que sustentan todo
Multi-tenencia nativa
Cada workspace tiene sus propias colas, rate-limits y almacenamiento aislado físicamente. Aislamiento real — no filtro lógico que puede filtrar.
Seguridad en capas
Tokens con scope, rotación sin downtime, PII encriptada en reposo (AES-256) y en tránsito (TLS 1.3), audit log inmutable.
Observabilidad total
Un único trace_id te lleva de la API del cliente al webhook outbound. Dashboards públicos por tenant. Sin secretos sobre qué sucede dentro de la plataforma.
Lo que CCX te da por escrito
Más allá del SLA, una lista de compromisos que entran en contratos Enterprise y funcionan por defecto en otros planes.
- Idempotencia garantizada por 7 días en cada endpoint
- Ningún mensaje enviado dos veces por fallo interno
- Buffer de reintentos hasta 7 intentos + 7 días de reconciliación automática
- Webhooks con reentrega automática de 24h y replay manual
- SLA público con créditos financieros en caso de incumplimiento
- Status page en tiempo real y postmortems públicos <48h
- LGPD, GDPR, SOC 2 Type II auditable con DPA listo
- Exportación completa de datos en cualquier momento (CSV, JSONL, Parquet)
¿Leíste hasta aquí? Estás listo para probar.
Activa un sandbox en 2 minutos y envía tu primera plantilla aprobada. Sin tarjeta, sin lock-in.