Envoyer un message RCS d'action suggérée (créer un événement du calendrier)

Dans cet extrait de code, vous apprendrez comment envoyer un message d'action suggérée RCS à l'aide de la commande text du canal RCS de l'API Messages. Ce message invitera le destinataire à créer un événement de calendrier via l'appli de calendrier de son appareil.

Pour plus d'informations sur la messagerie RCS, voir Comprendre la messagerie RCS
Pour un guide détaillé sur les puces de suggestion, voir Puces de suggestion RCS

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.
`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-suggested-action-create-calendar-event.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": "text",
    "text": "Product Launch: Save the date!",
    "suggestions": [
      {
        "type": "create_calendar_event",
        "text": "Save to calendar",
        "postback_data": "postback_data_1234",
        "start_time": "2024-06-28T19:00:00Z",
        "end_time": "2024-06-28T20:00:00Z",
        "title": "Vonage API Product Launch",
        "description": "Event to demo new and exciting Vonage API product",
        "fallback_url": "https://www.google.com/calendar"
      }
    ]
  }'

Voir la source complète

Exécutez votre code

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

bash send-suggested-action-create-calendar-event.sh

Conditions préalables

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

npm install @vonage/server-sdk @vonage/messages

Créez un fichier nommé send-suggested-action-create-calendar-event.js et ajoutez le code suivant :

const { Vonage } = require('@vonage/server-sdk');
const { Channels } = require('@vonage/messages');

/**
 * It is best to send messages using JWT instead of basic auth. If you leave out
 * apiKey and apiSecret, the messages SDK will send requests using JWT tokens
 *
 * @link https://developer.vonage.com/en/messages/technical-details#authentication
 */
const vonage = new Vonage(
  {
    applicationId: VONAGE_APPLICATION_ID,
    privateKey: VONAGE_PRIVATE_KEY,
  },
  {
    ...(MESSAGES_API_URL ? {apiHost: MESSAGES_API_URL} : {}),
  },
);

Voir la source complète

Rédiger le code

Ajouter ce qui suit à send-suggested-action-create-calendar-event.js:

vonage.messages.send({
  messageType: 'custom',
  channel: Channels.RCS,
  custom: {
    contentMessage: {
      text: 'Product Launch: Save the date!',
      suggestions: [
        {
          action: {
            text: 'Save to calendar',
            postbackData: 'postback_data_1234',
            fallbackUrl: 'https://www.google.com/calendar',
            createCalendarEventAction: {
              startTime: '2024-06-28T19:00:00Z',
              endTime: '2024-06-28T20:00:00Z',
              title: 'Vonage API Product Launch',
              description: 'Event to demo Vonage\'s new and exciting API product',
            },
          },
        },
      ],
    },
  },
  to: MESSAGES_TO_NUMBER,
  from: RCS_SENDER_ID,
})
  .then(({ messageUUID }) => console.log(messageUUID))
  .catch((error) => console.error(error));

Voir la source complète

Exécutez votre code

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

node send-suggested-action-create-calendar-event.js

Conditions préalables

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

Ajouter ce qui suit à build.gradle:

Créez un fichier nommé SendRcsSuggestedCalendarEvent et ajoutez le code suivant à la méthode main:

Voir la source complète

Rédiger le code

Ajouter ce qui suit à la méthode main du fichier SendRcsSuggestedCalendarEvent:

Voir la source complète

Exécutez votre code

Nous pouvons utiliser le plugin Applications pour Gradle afin de simplifier l'exécution de notre application. Mettez à jour votre build.gradle avec ce qui suit :

Exécutez la commande gradle suivante pour exécuter votre application, en remplaçant com.vonage.quickstart.kt.messages.rcs par le paquet contenant SendRcsSuggestedCalendarEvent:

gradle run -Pmain=com.vonage.quickstart.kt.messages.rcs.SendRcsSuggestedCalendarEvent

Conditions préalables

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

Ajouter ce qui suit à build.gradle:

Créez un fichier nommé SendRcsSuggestedCalendarEvent et ajoutez le code suivant à la méthode main:

VonageClient client = VonageClient.builder()
		.applicationId(VONAGE_APPLICATION_ID)
		.privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
		.build();

Voir la source complète

Rédiger le code

Ajouter ce qui suit à la méthode main du fichier SendRcsSuggestedCalendarEvent:

var response = client.getMessagesClient().sendMessage(
	RcsCustomRequest.builder()
		.from(RCS_SENDER_ID).to(MESSAGES_TO_NUMBER)
		.custom(Map.of("contentMessage", Map.of(
				"text", "Product Launch: Save the date!",
				"suggestions", List.of(
					Map.of(
						"action", Map.of(
							"text", "Save to calendar",
							"postbackData", "postback_data_1234",
							"fallbackUrl", "https://www.google.com/calendar",
							"createCalendarEventAction", Map.of(
								"startTime", Instant.ofEpochSecond(1719604800),
								"endTime", Instant.ofEpochSecond(1719601200),
								"title", "Vonage API Product Launch",
								"description", "Event to demo Vonage's new and exciting API product"
							)
						)
					)
				)
			))
		).build()
);
System.out.println("Message sent successfully. ID: " + response.getMessageUuid());

Voir la source complète

Exécutez votre code

Nous pouvons utiliser le plugin Applications pour Gradle afin de simplifier l'exécution de notre application. Mettez à jour votre build.gradle avec ce qui suit :

Exécutez la commande gradle suivante pour exécuter votre application, en remplaçant com.vonage.quickstart.messages.rcs par le paquet contenant SendRcsSuggestedCalendarEvent:

gradle run -Pmain=com.vonage.quickstart.messages.rcs.SendRcsSuggestedCalendarEvent

Conditions préalables

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

Install-Package Vonage

Rédiger le code

Ajouter ce qui suit à SendRcsSuggestedActionCreateCalendarMessage.cs:

Voir la source complète

Conditions préalables

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

composer require vonage/client

Créez un fichier nommé send-suggested-action-create-calendar-event.php et ajoutez le code suivant :

Voir la source complète

Rédiger le code

Ajouter ce qui suit à send-suggested-action-create-calendar-event.php:

Voir la source complète

Exécutez votre code

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

php send-suggested-action-create-calendar-event.php

Conditions préalables

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

pip install vonage python-dotenv

Rédiger le code

Ajouter ce qui suit à send-suggested-action-create-calendar-event.py:

Voir la source complète

Exécutez votre code

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

python messages/rcs/send-suggested-action-create-calendar-event.py

Conditions préalables

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

gem install vonage

Créez un fichier nommé send-suggested-action-create-calendar-event.rb et ajoutez le code suivant :

client = Vonage::Client.new(
  application_id: VONAGE_APPLICATION_ID,
  private_key: VONAGE_PRIVATE_KEY
)

Voir la source complète

Rédiger le code

Ajouter ce qui suit à send-suggested-action-create-calendar-event.rb:

Voir la source complète

Exécutez votre code

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

ruby send-suggested-action-create-calendar-event.rb

Essayez-le

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