Preguntas frecuentes de la API de SMS

Respuestas a las dudas más comunes al integrar el envío de SMS.

¿Por qué recibo 202 Accepted pero el usuario dice que no le llegó el SMS?

202 solo confirma que la plataforma aceptó y encoló el mensaje, no que se entregó. Revisa el DLR que llega a tu webhook para conocer el estatus real de entrega. Si el DLR indica entregado pero el usuario insiste en que no lo recibió, repórtalo a soporte con el messageId: puede tratarse de un problema del operador destino.

¿Por qué me responde 401 Unauthorized si mi clave es correcta?

Verifica que estás usando el header X-API-Key (no Authorization) y que no haya quedado un header de autenticación duplicado o manual en tu cliente HTTP, además del generado automáticamente.

¿Puedo enviar el mismo mensaje a varios destinatarios en una sola petición?

No; cada petición a /api/v1/messages envía a un único contact. Para enviar a varios destinatarios, realiza una petición por cada uno.

¿Qué pasa si mi plantilla no tiene variables?

Debes enviar igualmente el objeto vacío "params": {} dentro de template. Omitir el campo params por completo produce un error de validación.

¿Cómo sé si debo usar template o payload?

Usa template para contenido reutilizable y preaprobado (recomendado). Usa payload solo cuando el texto se genera dinámicamente en tu aplicación y no existe una plantilla previa para ese caso.