Envoyer un message RCS autonome à carte riche

Dans cet extrait de code, vous apprenez à envoyer un message RCS Rich Card à l'aide de la fonction card type de message du canal RCS de l'API Messages

Exemple

Vous trouverez ci-dessous la description de toutes les variables utilisées dans chaque extrait de code :

CléDescription
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.

NOTE : N'utilisez pas de point de départ + ou 00 lorsque vous saisissez un numéro de téléphone, commencez par l'indicatif du pays, par exemple 447700900000.

Conditions préalables

Si vous n'avez pas de demande, vous pouvez créer un. Veillez également à configurer vos webhooks.

Rédiger le code

Ajouter ce qui suit à send-rich-card-standalone.sh:

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"
    }
  }'

Voir la source complète

Exécutez votre code

Enregistrez ce fichier sur votre machine et exécutez-le :

bash send-rich-card-standalone.sh

Essayez-le

Lorsque vous exécutez le code, un message est envoyé au numéro de destination.