Recibos de entrega

Cuando se realiza una solicitud correcta a la SMS API, ésta devuelve un array de message uno para cada mensaje. Lo ideal sería que tuvieran un status de 0lo que indica que se ha enviado correctamente. Pero esto no significa que su mensaje haya llegado a sus destinatarios. Sólo significa que el mensaje se ha puesto en cola 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 DLR en su solicitud, debe proporcionar un webhook para que Vonage los envíe. Como alternativa, puedes utilizar la función Reports API para descargar periódicamente sus registros, incluido el estado de entrega por 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 - 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 los que envía mensajes y 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 DLR

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

Códigos de error DLR

En 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 su campaña de mensajería, compruebe la guía de características específicas de cada país para los países a los que envía. Si el país al que envía no suministra DLR fiables, utilice la opción 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 de hasta 40 caracteres.

Otros recursos

• Guía de 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 solucionar problemas