Errores y códigos HTTP

Envoltorio de error

{
  "error": {
    "code": "validation",
    "message": "Missing required field: phone"
  }
}

Códigos de estado HTTP

Estado	Significado
200	OK
201	Creado
202	Aceptado (en cola / asíncrono)
400	Validación / solicitud incorrecta
401	Clave API ausente o no válida
403	Scope / IP / socio no permitido
404	Recurso no encontrado
422	Validación semántica (p. ej., campos de formulario)
429	Límite de solicitudes
500	Error del servidor

Valores habituales de error.code

Código	Descripción
unauthorized	Clave API o token no válido
forbidden	Falta un scope, la IP está rechazada o el socio es incorrecto
validation	Cuerpo de la solicitud no válido
not_found	id / phone / template desconocido
blocked	Cuenta dada de baja
bot_error	Error del motor de flow / bot

Estados de entrega (mensajes)

Estado	Significado
queued	Aceptado, todavía no entregado por completo
sending	En proceso de envío
delivered	Entregado al canal / in-app
read	Leído por el usuario (cuando se realiza el seguimiento)
failed	Todos los canales han fallado
expired	Expirado

Conflictos de idempotencia

La reutilización de idempotency_key devuelve el mensaje original con 200 en lugar de crear un duplicado.