Solución de problemas SMS

Cuando enviar un SMSla SMS API devuelve una respuesta JSON que contiene una matriz de archivos message uno para cada mensaje:

{
    "message-count": "1",
    "messages": [
        {
            "to": "447700900000",
            "message-id": "0C000000217B7F02",
            "status": "0",
            "remaining-balance": "15.53590000",
            "message-price": "0.03330000",
            "network": "23410"
        }
    ]
}

En status indica si el mensaje se ha enviado correctamente. Un estado de cero indica éxito; un valor distinto de cero significa que algo salió mal.

Nota: A status de cero en la respuesta de la API no indica que Vonage haya entregado tu mensaje. Ver ¿Qué más podría haber salido mal?

Códigos de error de SMS API

Si la SMS API devuelve un valor distinto de cero status a continuación, utilice la siguiente tabla para determinar qué ha fallado:

status Significado Descripción
0 Éxito El mensaje ha sido aceptado para su entrega.
1 Estrangulado Estás enviando SMS más rápido que el límite de la Account (ver ¿Cuál es el límite de caudal de los SMS salientes?).
2 Parámetros que faltan A su solicitud le falta uno de los parámetros requeridos: from, to, api_key, api_secret o text.
3 Parámetros no válidos El valor de uno o más parámetros no es válido.
4 Credenciales no válidas Su clave y/o secreto API son incorrectos, no válidos o están desactivados.
5 Error interno Se ha producido un error en la plataforma al procesar este mensaje.
6 Mensaje no válido La plataforma no ha podido procesar este mensaje, por ejemplo, un prefijo de número no reconocido.
7 Numbers Prohibidos El número al que intentas enviar mensajes está en la lista de números bloqueados.
8 Cuenta de socio bloqueada Tu Account de Vonage ha sido suspendida. Ponte en contacto con soporte.
9 Violación de la cuota de socios No tiene saldo suficiente para enviar el mensaje. Recarga e inténtalo de nuevo.
10 Demasiadas ataduras existentes El número de conexiones simultáneas a la plataforma supera la asignación de su Account.
11 Account no habilitado para HTTP Esta Account no está preparada para SMS API, en su lugar debe utilizar SMPP.
12 Mensaje demasiado largo La longitud del mensaje supera el máximo permitido.
14 Firma no válida No se ha podido verificar la firma suministrada.
15 Dirección del remitente no válida Está utilizando un ID de remitente no autorizado en el from campo. Esto es más común en Norteamérica, donde se requiere un número virtual largo o un código corto de Vonage.
22 Código de red no válido El código de red suministrado no ha sido reconocido o no coincide con el país de la dirección de destino.
23 URL de devolución de llamada no válida La URL de devolución de llamada suministrada era demasiado larga o contenía caracteres ilegales.
29 Destino no incluido en la lista blanca Tu Account de Vonage aún está en modo demo. Mientras estés en modo demo, deberás agregar números de destino a tu lista blanca de destinos. Recarga tu Account para eliminar esta limitación.
32 Firma y secreto de API no permitidos Una solicitud firmada no puede presentar también un api_secret.
33 Numbers Desactivados El número al que intentas enviar mensajes está desactivado y es posible que no los reciba.

¿Qué más podría haber salido mal?

Si el valor de status es cero y tu mensaje sigue sin llegar, entonces algo ha ido mal durante el proceso de entrega. Para saber si su mensaje llegó al destinatario, necesita un recibo de entrega del transportista.