Envoyer un message RCS d'action suggérée (actions multiples)
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 contient plusieurs actions possibles que le destinataire peut sélectionner.
- 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 |
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 |
RCS_SENDER_ID | The sender ID for the RCS message. |
NOTE : N'utilisez pas de point de départ + ou 00 lors de la saisie d'un numéro de téléphone pour le to (c'est-à-dire le numéro auquel envoyer le message RCS), commencez par l'indicatif du pays, par exemple 447700900000.
Pour la valeur de phoneNumber dans le dialActionCependant, un + doit être utilisé pour faire précéder le code du pays, par exemple +447900000000.
Conditions préalables
Si vous n'avez pas de demande, vous pouvez créer un. Veillez également à configurer vos webhooks.
Exécutez votre code
Enregistrez ce fichier sur votre machine et exécutez-le :
Conditions préalables
Si vous n'avez pas de demande, vous pouvez créer un. Veillez également à configurer vos webhooks.
Créez un fichier nommé send-suggested-action-multiple.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} : {}),
},
);Rédiger le code
Ajouter ce qui suit à send-suggested-action-multiple.js:
vonage.messages.send({
messageType: 'custom',
channel: Channels.RCS,
custom: {
contentMessage: {
text: 'Need some help? Call us now or visit our website for more information.',
suggestions: [
{
action: {
text: 'Call us',
postbackData: 'postback_data_1234',
fallbackUrl: 'https://www.example.com/contact/',
dialAction: {
phoneNumber: '+447900000000',
},
},
},
{
action: {
text: 'Visit site',
postbackData: 'postback_data_1234',
openUrlAction: {
url: 'http://example.com/',
},
},
},
],
},
},
to: MESSAGES_TO_NUMBER,
from: RCS_SENDER_ID,
})
.then(({ messageUUID }) => console.log(messageUUID))
.catch((error) => console.error(error));Exécutez votre code
Enregistrez ce fichier sur votre machine et exécutez-le :
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é SendRcsSuggestedMultipleActions et ajoutez le code suivant à la méthode main:
Rédiger le code
Ajouter ce qui suit à la méthode main du fichier SendRcsSuggestedMultipleActions:
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 SendRcsSuggestedMultipleActions:
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é SendRcsSuggestedMultipleActions et ajoutez le code suivant à la méthode main:
VonageClient client = VonageClient.builder()
.applicationId(VONAGE_APPLICATION_ID)
.privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
.build();Rédiger le code
Ajouter ce qui suit à la méthode main du fichier SendRcsSuggestedMultipleActions:
var response = client.getMessagesClient().sendMessage(
RcsCustomRequest.builder()
.from(RCS_SENDER_ID).to(MESSAGES_TO_NUMBER)
.custom(Map.of("contentMessage", Map.of(
"text", "Need some help? Call us now or visit our website for more information.",
"suggestions", List.of(
Map.of(
"action", Map.of(
"text", "Call us",
"postbackData", "postback_data_1234",
"fallbackUrl", "https://www.example.com/contact/",
"dialAction", Map.of(
"phoneNumber", "+447900000000"
)
)
),
Map.of(
"action", Map.of(
"text", "Visit site",
"postbackData", "postback_data_1234",
"openUrlAction", Map.of(
"url", "http://example.com/"
)
)
)
)
))
).build()
);
System.out.println("Message sent successfully. ID: " + response.getMessageUuid());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 SendRcsSuggestedMultipleActions:
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 à SendRcsSuggestedActionMultipleMessage.cs:
Conditions préalables
Si vous n'avez pas de demande, vous pouvez créer un. Veillez également à configurer vos webhooks.
Créez un fichier nommé send-suggested-action-multiple.php et ajoutez le code suivant :
$keypair = new \Vonage\Client\Credentials\Keypair(
file_get_contents(VONAGE_APPLICATION_PRIVATE_KEY_PATH),
VONAGE_APPLICATION_ID
);
$client = new \Vonage\Client($keypair);Exécutez votre code
Enregistrez ce fichier sur votre machine et exécutez-le :
Conditions préalables
Si vous n'avez pas de demande, vous pouvez créer un. Veillez également à configurer vos webhooks.
Exécutez votre code
Enregistrez ce fichier sur votre machine et exécutez-le :
Conditions préalables
Si vous n'avez pas de demande, vous pouvez créer un. Veillez également à configurer vos webhooks.
Créez un fichier nommé send-suggested-action-multiple.rb et ajoutez le code suivant :
Exécutez votre code
Enregistrez ce fichier sur votre machine et exécutez-le :
Essayez-le
Lorsque vous exécutez le code, un message est envoyé au numéro de destination.