Recibos de entrega

Cuando se realiza una solicitud con éxito a la SMS API, esta devuelve una matriz de message uno para cada mensaje. Lo ideal sería que tuvieran un status de 0, lo que indica que se ha realizado correctamente. Pero esto no significa que tu mensaje haya llegado a los destinatarios. Solo significa que tu mensaje se ha puesto en cola correctamente para su envío.

Vonage enrutamiento adaptativo identifica el mejor transportista para su mensaje. Cuando el transportista seleccionado ha entregado el mensaje, devuelve un recibo de entrega (DLR).

Para recibir los DLR en tu aplicación, debes proporcionar un webhook para que Vonage los envíe. Como alternativa, puedes utilizar la función Reports API para descargar periódicamente tus registros, incluido el estado de entrega de cada mensaje.

Cómo funcionan los recibos de entrega

Los recibos de entrega son:

• Transportista - devuelto cuando el proveedor de servicios recibe el mensaje
• Teléfono móvil - devuelto cuando el microteléfono del usuario recibe el mensaje

No todos los DLR garantizan que el destinatario haya recibido el mensaje. Algunos recibos de entrega representan la finalización con éxito de sólo una etapa en el proceso de entrega, como pasar el mensaje a otro operador. Otros recibos de entrega son falsos. Debido a esto, Vonage no puede garantizar completamente que un DLR sea preciso. Depende del países a quiénes envías mensajes y cuáles son los proveedores implicados.

Si su mensaje es más largo de lo que puede enviarse en un solo SMS, los mensajes se concatenado. Debería recibir un DLR de operador para cada parte del SMS concatenado. Los DLR de terminal para un mensaje concatenado se retrasan. Esto se debe a que el terminal de destino tiene que procesar cada parte del mensaje concatenado antes de poder acusar recibo del mensaje completo.

Comprender el albarán de entrega

Este es un típico DLR:

{
  "err-code": "0",
  "message-timestamp": "2018-10-25 12:10:29",
  "messageId": "0B00000127FDBC63",
  "msisdn": "447547232824",
  "network-code": "23410",
  "price": "0.03330000",
  "scts": "1810251310",
  "status": "delivered",
  "to": "Vonage"
}

Los campos más importantes son status y err-code ya que le indican si su mensaje ha sido entregado y, en caso negativo, qué ha fallado.

Mensajes de estado del DLR

El status del DLR le indica si el SMS se ha enviado correctamente. Los valores posibles son:

Códigos de error del DLR

El err-code en el DLR proporciona información más detallada y puede ayudar a solucionar un fallo en la entrega. Un código distinto de cero indica que el mensaje no se ha podido entregar.

Uso de la SMS API en campañas

Antes de iniciar tu campaña de mensajería, comprueba el Guía de características específicas de cada país para los países a los que vas a realizar envíos. Si el país al que vas a realizar envíos no proporciona registros de entrega fiables (DLR), utiliza el Conversion API para proporcionar a Vonage más puntos de datos y garantizar el mejor enrutamiento.

Opcionalmente, puede identificar clientes o campañas específicos incluyendo una referencia con cada mensaje que envíe. Estas referencias se incluyen en el albarán de entrega. Introduzca la referencia elegida en la solicitud especificando un campo client-ref parámetro de hasta 40 caracteres.

Otros recursos

• Guía sobre los webhooks - una guía detallada sobre cómo utilizar webhooks con la plataforma de Vonage
• ¿Por qué no se ha entregado mi SMS? - consejos útiles para la resolución de problemas