SMS-Fehlerbehebung

Wenn Sie eine SMS versendengibt die SMS API eine JSON-Antwort zurück, die ein Array von message Objekte, eines für jede Nachricht:

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

Die status zeigt an, ob die Nachricht erfolgreich in die Warteschlange gestellt wurde. Ein Status von Null bedeutet Erfolg; ein Wert ungleich Null bedeutet, dass etwas schief gelaufen ist.

Anmerkung: A status von Null in der API-Antwort bedeutet nicht, dass Vonage Ihre Nachricht zugestellt hat. Siehe Was könnte sonst noch schief gelaufen sein?

SMS API-Fehlercodes

Wenn die SMS API einen Wert ungleich Null zurückgibt status Wertes und ermitteln Sie dann anhand der folgenden Tabelle, was falsch gelaufen ist:

status Bedeutung Beschreibung
0 Erfolg Die Nachricht wurde erfolgreich zur Zustellung angenommen.
1 Gedrosselt Sie senden SMS schneller als das Kontolimit (siehe Wie hoch ist die Durchsatzgrenze für ausgehende SMS?).
2 Fehlende Parameter In Ihrer Anfrage fehlt einer der erforderlichen Parameter: from, to, api_key, api_secret oder text.
3 Ungültige Parameter Der Wert von einem oder mehreren Parametern ist ungültig.
4 Ungültige Berechtigungsnachweise Ihr API-Schlüssel und/oder Ihr Geheimnis sind falsch, ungültig oder deaktiviert.
5 Interner Fehler Bei der Verarbeitung dieser Nachricht ist ein Fehler in der Plattform aufgetreten.
6 Ungültige Nachricht Die Plattform war nicht in der Lage, diese Nachricht zu verarbeiten, z. B. wegen einer nicht erkannten Vorwahl.
7 Numbers Verboten Die Nummer, an die Sie versuchen, Nachrichten zu senden, steht auf der Liste der gesperrten Nummern.
8 Partner Account gesperrt Ihr Vonage Account wurde gesperrt. Kontakt Unterstützung.
9 Verstoß gegen die Partnerquoten Sie haben nicht genügend Guthaben, um die Nachricht zu senden. Guthaben aufladen und erneut versuchen.
10 Zu viele existierende Bindungen Die Anzahl der gleichzeitigen Verbindungen zur Plattform übersteigt Ihre Account-Zuweisung.
11 Account nicht für HTTP aktiviert Dieser Account ist nicht für die SMS API vorgesehen, Sie sollten stattdessen SMPP verwenden.
12 Nachricht zu lang Die Nachrichtenlänge überschreitet die maximal zulässige Länge.
14 Ungültige Unterschrift Die gelieferte Signatur konnte nicht verifiziert werden.
15 Ungültige Absenderadresse Sie verwenden eine nicht autorisierte Absender-ID in der from Feld. Dies ist am häufigsten in Nordamerika der Fall, wo eine lange virtuelle Nummer oder eine Kurznummer von Vonage erforderlich ist.
22 Ungültiger Netzcode Der angegebene Netzcode wurde entweder nicht erkannt oder stimmt nicht mit dem Land der Zieladresse überein.
23 Ungültige Callback-URL Die angegebene Callback-URL war entweder zu lang oder enthielt unzulässige Zeichen.
29 Nicht auf der Whitelist stehendes Ziel Ihr Vonage Account befindet sich noch im Demo-Modus. Solange Sie sich im Demo-Modus befinden, müssen Sie Zielnummern zu Ihrer Whitelist hinzufügen. Laden Sie Ihren Account auf, um diese Einschränkung aufzuheben.
32 Signatur und API-Geheimnis nicht erlaubt Ein unterschriebener Antrag darf nicht auch eine api_secret.
33 Numbers De-aktiviert Die Nummer, an die Sie versuchen, Nachrichten zu senden, ist deaktiviert und empfängt sie möglicherweise nicht.

Was könnte sonst noch schief gelaufen sein?

Wenn der Wert von status Null ist und Ihre Nachricht immer noch nicht angekommen ist, dann ist bei der Zustellung etwas schief gelaufen. Um zu wissen, ob Ihre Nachricht den vorgesehenen Empfänger erreicht hat, benötigen Sie eine Lieferschein von der Fluggesellschaft.