Senden einer RCS Standalone Rich Card Nachricht

In diesem Codeschnipsel erfahren Sie, wie Sie eine RCS-Rich-Card-Nachricht mit der card Nachrichtentyp des Messages API RCS-Kanals

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.

IMAGE_URL

The link to the image file to send.

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 Wenn Sie eine Telefonnummer eingeben, beginnen Sie mit der Landesvorwahl, zum Beispiel 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-rich-card-standalone.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": "card",
    "card": {
      "title": "Quick question",
      "text": "Do you like this picture?",
      "media_url": "'${MESSAGES_IMAGE_URL}'",
      "media_height": "SHORT",
      "media_description": "Picture of a cat",
      "thumbnail_url": "'${MESSAGES_IMAGE_URL}'",
      "media_force_refresh": false,
      "suggestions": [
        {
          "type": "reply",
          "text": "Yes",
          "postback_data": "suggestion_1"
        },
        {
          "type": "reply",
          "text": "I love it!",
          "postback_data": "suggestion_2"
        }
      ]
    },
    "rcs": {
      "card_orientation": "HORIZONTAL",
      "image_alignment": "RIGHT"
    }
  }'

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-rich-card-standalone.sh

Probieren Sie es aus

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