Solución de problemas relacionados con los SMS

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

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

El 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 El valor cero en la respuesta de la API no indica que Vonage haya entregado tu mensaje. Consulta ¿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 Limitado Estás enviando SMS más rápido que el límite de la Account (ver ¿Cuál es el límite de tráfico para 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 varios parámetros no es válido.
4 Credenciales no válidas Tu clave y/o secreto de API son incorrectos, no son 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 Account de socio bloqueada Tu Account de Vonage ha sido suspendida. Ponte en contacto con soporte.
9 Incumplimiento de la cuota de socios No tienes saldo suficiente para enviar el mensaje. Recarga tu saldo e inténtalo de nuevo.
10 Demasiadas restricciones existentes El número de conexiones simultáneas a la plataforma supera el límite asignado a tu cuenta.
11 Account no habilitada 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 límite máximo permitido.
14 Firma no válida No se ha podido verificar la firma suministrada.
15 Dirección de 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 facilitada era demasiado larga o contenía caracteres no válidos.
29 Destino no incluido en la lista blanca Tu cuenta de Vonage sigue en modo de demostración. Mientras estés en modo de demostración, debes añadir los números de destino a tu lista de destinos autorizados. Recarga tu cuenta para eliminar esta limitación.
32 Firma y secreto de API no permitidos Una solicitud firmada no puede presentar además un api_secret.
33 Número desactivado 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.