Reintentar con seguridad con la API de SMS

¿Envía SMS a través de nuestra API y de vez en cuando recibe un tiempo de espera agotado o un error de red? Entonces no sabe si el mensaje ya ha salido. Si lo vuelve a intentar, el destinatario podría recibir el mismo SMS dos veces. Con el nuevo parámetro idempotency_key de la versión 2 de la API de SMS, eso ya no puede ocurrir.

¿Cómo funciona?

Al enviar, incluya un valor único en idempotency_key, por ejemplo un UUID, uno por mensaje. Si vuelve a enviar la misma solicitud con la misma clave dentro de 24 horas, no enviamos nada. Simplemente recibe la respuesta original, con el mismo msgid, el mismo uuid y la misma fecha. En ese caso, la respuesta incluye además la cabecera Idempotency-Repeat: true, para que sepa que se trata de una repetición.

El parámetro es opcional. Si no lo incluye, nada cambia en su integración actual.

Conviene saber

• Una clave es válida durante 24 horas desde la primera solicitud. Después se considera nueva y el mensaje se vuelve a enviar.
• Las claves son propias de cada cuenta: otro cliente puede usar el mismo valor sin que haya conflicto.
• Si usa la misma clave para otro mensaje, con otro número, otro texto u otro remitente, rechazamos la solicitud con el código 20.
• Si llega una repetición mientras la primera solicitud aún se está procesando, recibe el código 21. Vuelva a intentarlo un poco más tarde.
• Si se rechazó una solicitud, por ejemplo por no tener créditos suficientes, no guardamos la clave. Después de recargar, vuelva a intentarlo con la misma clave.
• Una clave puede tener como máximo 255 caracteres. Si es más larga, recibe el código 19.

Encontrará todos los detalles en la documentación de la API, en el apartado sobre el envío de un mensaje.