API-04 / PUBLIC_DEVELOPER_INTERFACE / RESTful JSON V1

Especificación de la API Transaccional y Webhooks

Contratos REST estandarizados para sistemas externos (CRMs, ERPs, sistemas de cobro y notificaciones). Autenticación mediante API Keys corporativas sin exposición de infraestructura de proveedores.

ENDPOINT BASE: https://api.innovia.io/v1

AUTENTICACIÓN: Authorization: Bearer inn_live_...

DOCUMENTACIÓN COMPLETA: Ver Esquemas en MD

POST /v1/messages

Público Transaccional

Dispara un mensaje individual utilizando una plantilla aprobada por Meta asociada a la línea configurada del tenant.

CUERPO DE LA PETICIÓN (JSON)

{
  "to": "+56912345678",
  "phone_id": "phn_981a2f30-67bc",
  "template": {
    "name": "notificacion_pedido",
    "language": "es",
    "parameters": {
      "cliente": "María González",
      "pedido_id": "ORD-8921",
      "link_seguimiento": "https://tienda.com/track/8921"
    }
  }
}

RESPUESTA: 202 ACCEPTED (JSON)

{
  "id": "msg_01h8a9bc-d901-44ab",
  "status": "queued",
  "to": "+56912345678",
  "template": "notificacion_pedido",
  "created_at": "2026-09-16T15:20:00Z"
}

GET /v1/messages/:id

Público Transaccional

Consulta el estado de entrega en tiempo real del mensaje y su trazabilidad histórica de eventos.

RESPUESTA: 200 OK (JSON)

{
  "id": "msg_01h8a9bc-d901-44ab",
  "status": "delivered",
  "to": "+56912345678",
  "phone_id": "phn_981a2f30-67bc",
  "created_at": "2026-09-16T15:20:00Z",
  "delivered_at": "2026-09-16T15:20:05Z",
  "events": [
    { "type": "SENT", "at": "2026-09-16T15:20:02Z" },
    { "type": "DELIVERED", "at": "2026-09-16T15:20:05Z" }
  ]
}

WEBHOOK /webhooks/providers/kapso

Firma HMAC

Receptor autenticado con verificación de firma HMAC para eventos asíncronos de red emitidos por Kapso.

EVENTO EXTERNO KAPSO: "event": "message.delivered"

EVENTO NORMALIZADO INNOVIA: MESSAGE_DELIVERED