Códigos de estado HTTP de la API de SMS
Tabla de códigos de respuesta del endpoint de mensajes y qué revisar en cada caso.
Plataforma Omni
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
| Código | Significado | Qué revisar |
|---|---|---|
| 202 Accepted | Éxito. La API aceptó y encoló tu mensaje. | Continuar verificando el DLR en tu webhook para confirmar entrega. |
400 + parse error | El template.id se envió como cadena en vez de número. | Quitar las comillas del id. |
400 + EOF | El JSON llegó incompleto o truncado. | Validar que el JSON esté bien formado (usa la opción Beautify si pruebas en Postman). |
| 400 (otros) | Algún parámetro no cumple el formato esperado. | Revisar el formato de contact y la existencia del template.id. |
| 401 | El API key está ausente, es inválido, o no viaja en el header correcto. | Verificar el valor de la clave y que uses el header X-API-Key. |
| 403 | La clave es válida pero no tiene el scope o el Sender ID solicitado. | Contactar a soporte para revisar los scopes y senders autorizados en tu API access. |
| 404 | La ruta no existe. | Verificar el host y la ruta exacta /api/v1/messages. |
| 429 | Se excedió el límite de peticiones por segundo permitido para tu integración. | Reducir el ritmo de envío o solicitar un ajuste del límite a soporte. |
| 5xx | Error del lado de la plataforma. | Reintentar con espera creciente entre intentos (backoff). Si persiste, escalar a soporte. |
¿Te sirvió esta página?