Dépannage des SMS

Lorsque vous envoyer un SMSl'API SMS renvoie une réponse JSON qui contient un tableau des éléments suivants message un pour chaque message :

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

Les status indique si le message a été mis en file d'attente pour l'envoi. Un état égal à zéro indique un succès ; une valeur non nulle signifie que quelque chose n'a pas fonctionné.

Note : Un status de zéro dans la réponse de l'API n'indique pas que Vonage a livré votre message. Voir Qu'est-ce qui aurait pu encore mal tourner ?

Codes d'erreur de l'API SMS

Si l'API SMS renvoie une valeur de status puis utiliser le tableau suivant pour déterminer ce qui n'a pas fonctionné :

status Signification Description
0 Succès Le message a été accepté avec succès.
1 L'étranglement Vous envoyez des SMS à une vitesse supérieure à la limite du compte (voir Quelle est la limite de débit pour les SMS sortants ?).
2 Paramètres manquants Il manque un des paramètres requis dans votre demande : from, to, api_key, api_secret ou text.
3 Paramètres non valides La valeur d'un ou plusieurs paramètres n'est pas valide.
4 Informations d'identification invalides Votre clé et/ou votre secret API sont incorrects, invalides ou désactivés.
5 Erreur interne Une erreur s'est produite dans la plate-forme lors du traitement de ce message.
6 Message non valide La plate-forme n'a pas pu traiter ce message, par exemple un préfixe de numéro non reconnu.
7 Numbers frappés d'interdiction Le numéro auquel vous essayez d'envoyer des messages figure sur la liste des numéros interdits.
8 Le compte d'un partenaire est bloqué Votre Account Vonage a été suspendu. Contact soutien.
9 Violation du quota de partenaires Vous n'avez pas assez de crédit pour envoyer le message. Rechargez et réessayez.
10 Trop de liens existants Le nombre de connexions simultanées à la plateforme dépasse l'allocation de votre Account.
11 Account non activé pour HTTP Ce Account n'est pas provisionné pour l'API SMS, vous devez utiliser SMPP à la place.
12 Message trop long La longueur du message dépasse le maximum autorisé.
14 Signature invalide La signature fournie n'a pas pu être vérifiée.
15 Adresse de l'expéditeur invalide Vous utilisez un identifiant d'expéditeur non autorisé dans le from champ. C'est le cas le plus fréquent en Amérique du Nord, où un numéro virtuel long ou un code court de Vonage est requis.
22 Code réseau invalide Le code réseau fourni n'a pas été reconnu ou ne correspond pas au pays de l'adresse de destination.
23 URL de rappel invalide L'URL de rappel fournie était trop longue ou contenait des caractères illégaux.
29 Destination non inscrite sur la liste blanche Votre Account Vonage est encore en mode démo. En mode démo, vous devez ajouter des numéros cibles à votre liste de destinations autorisées. Rechargez votre Account pour supprimer cette limitation.
32 La signature et le secret de l'API ne sont pas autorisés Une demande signée ne peut pas également présenter une api_secret.
33 Nombre Désactivé Le numéro auquel vous essayez d'envoyer des messages est désactivé et risque de ne pas les recevoir.

Qu'est-ce qui aurait pu encore mal tourner ?

Si la valeur de status est égal à zéro et que votre message n'est toujours pas arrivé, c'est que quelque chose s'est mal passé au cours du processus d'envoi. Pour savoir si votre message est parvenu au destinataire prévu, vous avez besoin d'un récépissé de livraison du transporteur.