Senden einer SMS mit Failover

In diesem Beispiel werden Sie eine SMS senden, die zum Senden einer SMS übergehen kann.

Im Workflow-Objekt können die Nachrichtenobjekte in beliebiger Reihenfolge angeordnet werden, um Ihrem Anwendungsfall gerecht zu werden. Jedes Nachrichtenobjekt muss ein Failover-Objekt enthalten, mit Ausnahme der letzten Nachricht, da es keine weiteren Nachrichtenobjekte zum Failover gibt.

Beispiel

Stellen Sie sicher, dass die folgenden Variablen mit einer beliebigen Methode auf die gewünschten Werte gesetzt werden:

SchlüsselBeschreibung
VONAGE_APPLICATION_ID

The Vonage Application ID.

FROM_NUMBER

Replace with number you are sending from. E.g. 447700900002

TO_NUMBER_1

The phone number you are sending the SMS to.

TO_NUMBER_2

The phone number of the second phone. In this example, the workflow will failover to this number if the first message is not read in 60 seconds.

HINWEIS: Verwenden Sie kein führendes + oder 00 Wenn Sie eine Telefonnummer eingeben, beginnen Sie mit der Landesvorwahl, z. B. 447700900000.

Voraussetzungen

Wenn Sie keine Bewerbung haben, können Sie einen erstellen aufrufen. Stellen Sie sicher, dass Sie auch Ihre Webhooks konfigurieren.

Schreiben Sie den Code

Fügen Sie Folgendes zu send-sms-with-failover.sh hinzu:

curl -X POST https://api.nexmo.com/v0.1/dispatch \
  -H 'Authorization: Bearer '$JWT\
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d $'{
    "template":"failover",
    "workflow": [
      {
        "from": { "type": "sms", "number": '$FROM_NUMBER' },
        "to": { "type": "sms", "number": '$TO_NUMBER_1' },
        "message": {
          "content": {
            "type": "text",
            "text": "Dispatch API: Message 1"
          }
        },
        "failover":{
          "expiry_time": 60,
          "condition_status": "read"
        }
      },
      {
        "from": {"type": "sms", "number": '$FROM_NUMBER'},
        "to": { "type": "sms", "number": '$TO_NUMBER_2'},
        "message": {
          "content": {
            "type": "text",
            "text": "Dispatch API: Message 2"
          }
        }
      }
    ]
  }'

Vollständige Quelle anzeigen

Führen Sie Ihren Code aus

Speichern Sie diese Datei auf Ihrem Rechner und führen Sie sie aus:

bash send-sms-with-failover.sh

Probieren Sie es aus

Wenn Sie den Code ausführen, wird er versuchen, eine SMS an Telefon 1 zu senden. Wenn dies fehlschlägt, wird eine Nachricht per SMS an Telefon 2 gesendet.

HINWEIS: Das korrekte Funktionieren dieses Codeschnipsels hängt von der Unterstützung durch das zugrunde liegende Netz ab. Zum Beispiel von der Verfügbarkeit von Liefer- und Lesebestätigungen.