Saltar al contenido
Menú

Buscar en el sitio

Escribe para buscar en guías, blog, API y producto.

↑ ↓ para moverte · Enter para abrir · Esc para cerrar

Referencia de la API

API

Codigos de Error

Referencia de manejo de errores para la API de TBit

Ver como Markdown

¿Buscas por qué un mensaje de WhatsApp no se entregó? Revisa Errores de entrega en WhatsApp.

Todos los errores siguen una estructura JSON consistente:

json
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Activity not found"
  }
}
EstadoCódigoDescripción
400VALIDATION_ERRORCuerpo de solicitud o parámetros de consulta inválidos
401UNAUTHORIZEDClave API faltante o inválida
402INSUFFICIENT_ENERGYNo alcanza la energía; no se envió ni se llamó
404NOT_FOUNDRecurso no encontrado o no pertenece a tu agente
405METHOD_NOT_ALLOWEDMétodo HTTP no soportado para este endpoint
409CONFLICTEl recurso ya existe (por ejemplo, contacto con este canal)
409NO_PHONE_LINEEl agente no tiene una línea telefónica activa
422SEND_FAILEDEnvío de plantilla fallido (por ejemplo, sin ventana de mensajería)
422DESTINATION_NOT_ALLOWEDEl destino todavía no está habilitado (los +1 piden 10DLC)
429RATE_LIMITEDLímite de tasa excedido (100 solicitudes/minuto)
500INTERNAL_ERRORError inesperado del servidor
502PROVIDER_ERROREl operador rechazó el envío o la llamada; message trae su motivo

Cada respuesta incluye información del límite de tasa en los encabezados:

EncabezadoDescripción
X-RateLimit-RemainingSolicitudes restantes en la ventana actual
X-RateLimit-ResetMarca de tiempo (ms) cuando se reinicia la ventana

Mejores practicas para manejar errores de API:

  • Siempre verifica el código de estado HTTP antes de analizar el cuerpo de respuesta
  • Implementa backoff exponencial para errores 429 (límite de tasa)
  • Registra codigos y mensajes de error para depuracion
  • No reintentes errores 400 o 401: corrige la solicitud primero