Central de ayuda

Respuesta primero, ticket después.

Los artículos que resuelven lo que más aparece en soporte: aprobación de número, plantilla rechazada, entregabilidad de email, monedero y errores de la API.

artículos escritos a partir de un ticket real

categorías, una por canal y por tema

1 h

SLA de primera respuesta del soporte

ES-ES

todo en español, incluidos los mensajes de error

Artículos

Lo que más llega al soporte.

8 artículos. Cada uno responde a una duda concreta con el paso a paso — sin introducción de tres párrafos antes de la respuesta.

Errores de la API

Qué hacer cuando la respuesta no es 2xx.

Todo error devuelve un código estable en error.code, con mensaje en español. Estos son los que más aparecen — y qué hacer en cada uno.

Ver la referencia completa →

HTTPCódigoQué hacer

401auth_invalid_keyClave ausente, revocada o de otro entornoComprueba la cabecera Authorization y que la clave sea del entorno correcto — la clave de pruebas no envía en producción.

403auth_scope_missingLa clave no tiene el alcance de la operaciónAñade el alcance necesario a la clave (por ejemplo sms:send) o usa una clave con el permiso adecuado.

402wallet_insufficient_balanceSaldo insuficiente en el monedero del entornoRecarga por Pix para liberación en segundos. Configura el aviso de saldo mínimo para no repetirlo.

422template_not_approvedPlantilla inexistente, pausada o rechazadaComprueba el estado en el panel. Una plantilla en revisión o rechazada no envía — corrige y reenvía.

422window_closedVentana de 24h cerrada para este contactoFuera de la ventana solo va plantilla aprobada. El error indica qué categoría se acepta para reabrir la conversación.

429rate_limitedPor encima del límite de peticiones de la claveRespeta la cabecera Retry-After y reparte el disparo. Para más volumen, negocia throughput con comercial.

503provider_unavailableEl proveedor de canal ha rechazado o no está disponibleReintenta con la misma clave de idempotencia. Consulta la página de estado antes de abrir ticket.

Un 5xx nuestro puede reintentarse con la misma clave de idempotencia, sin riesgo de duplicar el mensaje.

Recorridos

¿Empiezas ahora? Sigue el orden.

Tres caminos según tu papel. Cada recorrido tiene los artículos en la secuencia que evita rehacer trabajo — la mayoría de los tickets de cuenta nueva vienen de alguien que se saltó una etapa.

⌘

Quien va a integrar

Equipo técnico que va a poner la API en el producto.

01Primer envío en 10 minutos, en el entorno de pruebas

02Claves por entorno y alcance mínimo

03Webhook: firma, 2xx rápido e idempotencia

04Cómo tratar los errores más habituales

◫

Quien va a atender

Supervisión y equipo de atención en el inbox.

01Invitar al equipo y definir permisos

02Crear equipos, colas y SLA por cola