Senden einer RCS-Nachricht mit Aktionsvorschlägen (mehrere Aktionen)

In diesem Codeschnipsel lernen Sie, wie Sie eine RCS Suggested Action Nachricht mit der text Nachrichtentyp des Messages API RCS-Kanals. Diese Nachricht enthält mehrere mögliche Aktionen, die der Empfänger auswählen kann.

Beispiel

Nachstehend finden Sie die Beschreibung aller in den einzelnen Codeausschnitten verwendeten Variablen:

SchlüsselBeschreibung
VONAGE_APPLICATION_ID

The Vonage Application ID.

VONAGE_PRIVATE_KEY_PATH

Private key path.

MESSAGES_API_URL

There are two versions of the API, each with their own endpoints. For production the previous Messages API endpoint was https://api.nexmo.com/v0.1/messages, the new one is https://api.nexmo.com/v1/messages. For sandbox testing the Messages API endpoint is https://messages-sandbox.nexmo.com/v0.1/messages or https://messages-sandbox.nexmo.com/v1/messages, depending on which version you have set in the sandbox dashboard.

JWT

Used to authenticate your request. See Authentication for more information, including how to generate a JWT.

TO_NUMBER

The number you are sending the RCS message to in E.164 format. For example 447700900000.

RCS_SENDER_ID

The sender ID for the RCS message.

HINWEIS: Verwenden Sie kein führendes + oder 00 bei der Eingabe einer Rufnummer für die to Nummer (d. h. die Nummer, an die die RCS-Nachricht gesendet werden soll), beginnen Sie mit der Landesvorwahl, z. B. 447700900000.

Für den Wert von phoneNumber im dialActionjedoch eine + sollte verwendet werden, um den Ländercode voranzustellen, z. B. +447900000000.

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-suggested-action-multiple.sh hinzu:

curl -X POST "${MESSAGES_API_URL}" \
  -H "Authorization: Bearer "$JWT\
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d $'{
    "to": "'${MESSAGES_TO_NUMBER}'",
    "from": "'${RCS_SENDER_ID}'",
    "channel": "rcs",
    "message_type": "text",
    "text": "Need some help? Call us now or visit our website for more information.",
    "suggestions": [
      {
        "type": "dial",
        "text": "Call us",
        "postback_data": "postback_data_1234",
        "phone_number": "+447900000000",
        "fallback_url": "https://www.example.com/contact/"
      },
      {
        "type": "open_url",
        "text": "Visit site",
        "postback_data": "postback_data_1234",
        "url": "http://example.com/",
        "description": "A URL for the Example website"
      }
    ]
  }'

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-suggested-action-multiple.sh

Probieren Sie es aus

Wenn Sie den Code ausführen, wird eine Nachricht an die Zielnummer gesendet.