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.

Für weitere Informationen über RCS Messaging siehe RCS-Nachrichten verstehen
Eine ausführliche Anleitung zu den Vorschlägen für Chips finden Sie unter RCS-Vorschläge Chips

Beispiel

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

Schlüssel	Beschreibung
`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:

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

Voraussetzungen

Wenn Sie keine Bewerbung haben, können Sie einen erstellen aufrufen. Stellen Sie sicher, dass Sie auch Ihre Webhooks konfigurieren.

Erstellen Sie eine Datei mit dem Namen send-suggested-action-multiple.js und fügen Sie den folgenden Code hinzu:

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} : {}),
  },
);

Vollständige Quelle anzeigen

Schreiben Sie den Code

Fügen Sie Folgendes zu send-suggested-action-multiple.js hinzu:

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));

Vollständige Quelle anzeigen

Führen Sie Ihren Code aus

Speichern Sie diese Datei auf Ihrem Rechner und führen Sie sie aus:

node send-suggested-action-multiple.js

Voraussetzungen

Wenn Sie keine Bewerbung haben, können Sie einen erstellen aufrufen. Stellen Sie sicher, dass Sie auch Ihre Webhooks konfigurieren.

Fügen Sie Folgendes zu build.gradle hinzu:

Erstellen Sie eine Datei mit dem Namen SendRcsSuggestedMultipleActions und fügen Sie den folgenden Code in die Methode main ein:

val client = Vonage {
    applicationId(VONAGE_APPLICATION_ID)
    privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
}

Vollständige Quelle anzeigen

Schreiben Sie den Code

Fügen Sie der Methode main in der Datei SendRcsSuggestedMultipleActions Folgendes hinzu:

val messageId = client.messages.send(
    rcsCustom {
        to(MESSAGES_TO_NUMBER)
        from(RCS_SENDER_ID)
        custom(mapOf(
            "contentMessage" to mapOf(
                "text" to "Need some help? Call us now or visit our website for more information.",
                "suggestions" to listOf(
                    mapOf(
                        "action" to mapOf(
                            "text" to "Call us",
                            "postbackData" to "postback_data_1234",
                            "fallbackUrl" to "https://www.example.com/contact/",
                            "dialAction" to mapOf(
                                "phoneNumber" to "+447900000000"
                            )
                        )
                    ),
                    mapOf(
                        "action" to mapOf(
                            "text" to "Visit site",
                            "postbackData" to "postback_data_1234",
                            "openUrlAction" to mapOf(
                                "url" to "http://example.com/"
                            )
                        )
                    )
                )
            )
        ))
    }
)

Vollständige Quelle anzeigen

Führen Sie Ihren Code aus

Wir können das Applikation Plugin für Gradle verwenden, um die Ausführung unserer Anwendung zu vereinfachen. Aktualisieren Sie Ihre build.gradle mit dem Folgenden:

Führen Sie den folgenden Befehl gradle aus, um Ihre Anwendung auszuführen, und ersetzen Sie dabei com.vonage.quickstart.kt.messages.rcs durch das Paket, das SendRcsSuggestedMultipleActions enthält:

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

Voraussetzungen

Wenn Sie keine Bewerbung haben, können Sie einen erstellen aufrufen. Stellen Sie sicher, dass Sie auch Ihre Webhooks konfigurieren.

Fügen Sie Folgendes zu build.gradle hinzu:

Erstellen Sie eine Datei mit dem Namen SendRcsSuggestedMultipleActions und fügen Sie den folgenden Code in die Methode main ein:

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

Vollständige Quelle anzeigen

Schreiben Sie den Code

Fügen Sie der Methode main in der Datei SendRcsSuggestedMultipleActions Folgendes hinzu:

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());

Vollständige Quelle anzeigen

Führen Sie Ihren Code aus

Wir können das Applikation Plugin für Gradle verwenden, um die Ausführung unserer Anwendung zu vereinfachen. Aktualisieren Sie Ihre build.gradle mit dem Folgenden:

Führen Sie den folgenden Befehl gradle aus, um Ihre Anwendung auszuführen, und ersetzen Sie dabei com.vonage.quickstart.messages.rcs durch das Paket, das SendRcsSuggestedMultipleActions enthält:

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

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 SendRcsSuggestedActionMultipleMessage.cs hinzu:

Vollständige Quelle anzeigen

Voraussetzungen

Wenn Sie keine Bewerbung haben, können Sie einen erstellen aufrufen. Stellen Sie sicher, dass Sie auch Ihre Webhooks konfigurieren.

Erstellen Sie eine Datei mit dem Namen send-suggested-action-multiple.php und fügen Sie den folgenden Code hinzu:

$keypair = new \Vonage\Client\Credentials\Keypair(
    file_get_contents(VONAGE_APPLICATION_PRIVATE_KEY_PATH),
    VONAGE_APPLICATION_ID
);

$client = new \Vonage\Client($keypair);

Vollständige Quelle anzeigen

Schreiben Sie den Code

Fügen Sie Folgendes zu send-suggested-action-multiple.php hinzu:

$rcsCard = new Vonage\Messages\Channel\RCS\RcsCustom(
    '07778887777',
    '09997485156',
    [
        "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/"],
                    ],
                ],
            ],
        ],
    ]
);

$client->messages()->send($rcsCard);

Vollständige Quelle anzeigen

Führen Sie Ihren Code aus

Speichern Sie diese Datei auf Ihrem Rechner und führen Sie sie aus:

php send-suggested-action-multiple.php

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.py hinzu:

Vollständige Quelle anzeigen

Führen Sie Ihren Code aus

Speichern Sie diese Datei auf Ihrem Rechner und führen Sie sie aus:

python messages/rcs/send-suggested-action-multiple.py

Voraussetzungen

Wenn Sie keine Bewerbung haben, können Sie einen erstellen aufrufen. Stellen Sie sicher, dass Sie auch Ihre Webhooks konfigurieren.

Erstellen Sie eine Datei mit dem Namen send-suggested-action-multiple.rb und fügen Sie den folgenden Code hinzu:

Vollständige Quelle anzeigen

Schreiben Sie den Code

Fügen Sie Folgendes zu send-suggested-action-multiple.rb hinzu:

Vollständige Quelle anzeigen

Führen Sie Ihren Code aus

Speichern Sie diese Datei auf Ihrem Rechner und führen Sie sie aus:

ruby send-suggested-action-multiple.rb

Probieren Sie es aus

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