Mensajería dentro de tu producto, detrás de una sola API.
WhatsApp, SMS, email y push con la misma API REST, con webhooks firmados para estados y respuestas, envíos idempotentes y claves de prueba que nunca tocan tu saldo. Tu equipo lanza funcionalidades, no integraciones con operadores.
Si creas la cuenta desde la web, recibes 5 US$ de crédito de prueba.
curl -X POST https://api.messages.ccxcompany.co/messages \ -H "Authorization: Bearer $CCX_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: pedido-4821" \ -d '{ "numberId": "num_…", "to": "+34…", "type": "template", "templateId": "tpl_…", "templateVars": ["Marina", "4821"], "metadata": { "pedido": "4821" } }' → 201 Created{ "id": "msg_…", "status": "queued" }
Qué cambia para el equipo de producto.
Cuatro piezas del contrato público. La referencia y el inicio rápido tienen los detalles.
Un contrato para todos los canales
La misma clave, los mismos errores Problem Details y los mismos webhooks para WhatsApp, SMS, email y push. El cuerpo cambia según el canal; nada más.
Conocer la APIWebhooks de confianza
Cada entrega va firmada con HMAC-SHA256. Tu endpoint tiene 10 segundos para responder, y un 5xx, 408, 429 o un tiempo agotado se reintenta tras 5 s, 30 s, 2 min, 10 min y 1 h.
Leer sobre los webhooksPrueba sin gastar
Una clave ccx_test_ se comporta como una de producción, pero los envíos pasan por un transporte simulado y una cartera de prueba que recargas gratis.
Ver las claves de pruebaRecorridos desde tus eventos
Envía un evento desde tu producto y un recorrido se encarga del resto: esperas, condiciones, pruebas A/B y un webhook firmado de vuelta a ti.
Conocer los recorridosDe la primera clave a producción.
El camino que sigue la mayoría de los equipos, en el orden en que lo recorre la documentación.
- Clave
Crea una clave de prueba
Con ámbitos que limitan lo que puede hacer, y enviada como token Bearer.
- Envío
Envía el primer mensaje
POST /messages responde 201 con el mensaje en cola.
- Webhook
Suscribe una URL
CCX comprueba la dirección y envía un ping firmado antes de activarla.
- Reintento
Haz que repetir sea seguro
En WhatsApp, SMS y push, una Idempotency-Key devuelve el mensaje original en lugar de enviarlo dos veces.
- Producción
Cambia a una clave de producción
Es la clave guardada en nuestro lado la que decide el entorno, no el cuerpo de la petición.
Equipos que construyen sobre la API.
Core.IA integra la mensajería en su propio producto a través de la API. Rumo.tv envía los códigos de acceso de sus suscriptores por SMS sobre SMPP.
Queríamos dejar de mantener la integración y volver a escribir producto. La API entregó eso: un contrato, un webhook, y Meta dejó de ser problema nuestro.
Equipo de ingeniería, Core.IA
Plataforma de streamingLas llamadas a la API son gratis. Pagas los mensajes.
Cada mensaje sale al precio publicado de su canal. Las claves de prueba y el sandbox no cuestan nada, y el plan cubre a todo tu equipo.
Lista de precios internacional en euros. Los precios de WhatsApp son los de mensajes a España; cada país de destino tiene el suyo.
Lo que preguntan los ingenieros antes de integrar
¿Aún tienes dudas? Habla con el equipo que gestiona la plataforma.
¿Hay un SDK?
Sí: un SDK de TypeScript y una CLI en npm, @ccx-messages/sdk y @ccx-messages/cli. El documento OpenAPI es público, así que puedes generar un cliente en cualquier lenguaje.
¿Cómo pruebo sin enviar mensajes reales?
Usa una clave ccx_test_. Los envíos pasan por un transporte simulado y una cartera de prueba que recargas gratis, y no llega nada a ningún cliente.
¿Qué pasa si mi webhook está caído?
Un 5xx, 408, 429 o la falta de respuesta en 10 segundos se reintenta tras 5 s, 30 s, 2 min, 10 min y 1 h. Cualquier otro 4xx es definitivo, y un 410 cancela la suscripción.
¿Puedo reintentar un envío con seguridad?
Sí, en WhatsApp, SMS y push: la misma Idempotency-Key dentro de 24 horas devuelve el mensaje original, y la misma clave con otro cuerpo devuelve 409.
¿Tenéis SMPP?
Sí, SMPP sobre TLS para los equipos que ya tienen un cliente SMPP. El SMS va a números de Brasil; las rutas internacionales son bajo consulta.
¿Cuánto cuesta?
Las llamadas a la API son gratis. Pagas el plan mensual, desde 39 €, más cada mensaje al precio publicado de su canal.
Consigue una clave de prueba y envía tu primer mensaje.
Si creas la cuenta desde la web, recibes 5 US$ de crédito de prueba.