Recomendaciones e integración
Last update: 2 months ago by Yered Rios
Recomendaciones de integración
- Cachear el token: cachea el token y reutilízalo durante los ~10 minutos de vida. No pidas uno nuevo por cada envío.
- Maneja el 401: si el token venció, solicita uno nuevo y reintenta la petición una vez.
- Maneja el 500 con reintentos: usa backoff exponencial (ej. 1s, 2s, 4s) con un máximo de 3 intentos.
- Guarda el mailingId: guarda el de cada envío exitoso — es el identificador único para rastrear o reportar el mensaje.mailingId
- No expongas el Secret: no lo publiques en código fuente, logs ni variables de entorno del front-end. Consérvalo del lado del servidor.
- Envía country siempre: mejora la velocidad de resolución del operador y reduce errores .-40
Preguntas Frecuentes
¿El token que uso para enviar SMS es el mismo que para gestionar llaves en el portal?No. El token para el portal es un token de usuario (realm `broadcaster`). El token para enviar SMS es un token de máquina (realm `broadcaster-api-external`) que obtienes con el flujo `client_credentials` y tu llave de API.
¿Puedo enviar el mismo mensaje a varios números al mismo tiempo?
Este endpoint acepta un número de destino por llamada (`msisdn` es un solo número). Para envíos masivos, realiza múltiples llamadas o consulta a tu ejecutivo de cuenta sobre el flujo de campañas.
¿Cómo sé si el SMS llegó al destinatario?
Activa el DLR (ver [Acuse de Entrega (DLR)](/api-externa/sms/api-http/http#acuse-de-entrega-dlr)). La notificación llega al webhook o cola configurada en tu cuenta. Si no tienes configurado un receptor, consulta a soporte.
¿Qué pasa si mi token vence a la mitad de una ráfaga de envíos?
Recibirás un 401 del servidor. Solicita un token nuevo ([Paso 1](/api-externa/sms/api-http/authentication)) y reintenta los mensajes que fallaron.
¿Hay límite de mensajes por segundo?
Depende de la configuración de tu cuenta. Si recibes errores `-109` (balance limit reached) o tiempos de respuesta altos, consulta con tu ejecutivo de cuenta.
¿Cómo reporto un error o problema técnico?
Contacta al equipo de soporte con: el `mailingId` (si lo tienes), el body del request (sin el secret), la respuesta recibida y la fecha/hora del intento.