Senden einer Produktnachricht mit mehreren Artikeln

In diesem Codeschnipsel erfahren Sie, wie Sie mit der Messages API eine Produktnachricht mit mehreren Produktartikeln an einen WhatsApp-Chat senden können. Sie können mehr lesen über Produktnachrichten für zusätzlichen Kontext zur Verwendung dieses Code-Schnipsels.

Dieser Nachrichtentyp verwendet die Vonage Benutzerdefiniertes Objekt Funktion. Weitere Informationen über das spezifische Nachrichtenformat finden Sie in der WhatsApp-Entwickler Produktnachrichten Dokumentation.

Beispiel

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

Schlüssel	Beschreibung
`VONAGE_APPLICATION_ID`	The Vonage Application ID.
`VONAGE_APPLICATION_PRIVATE_KEY_PATH`	Private key path.
`VONAGE_PRIVATE_KEY_PATH`	Private key path.
`BASE_URL`	For production use the base URL is `https://api.nexmo.com/`. For sandbox testing the base URL is `https://messages-sandbox.nexmo.com/`.
`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.
`WHATSAPP_NUMBER`	The WhatsApp number that has been allocated to you by Vonage. For sandbox testing the number is 14157386102.
`VONAGE_WHATSAPP_NUMBER`	Refer to `WHATSAPP_NUMBER` above.
`VONAGE_NUMBER`	Refer to `WHATSAPP_NUMBER` above.
`TO_NUMBER`	Replace with the number you are sending to. E.g. `447700900001`

HINWEIS: Verwenden Sie kein führendes + oder 00 Wenn Sie eine Telefonnummer eingeben, beginnen Sie mit der Landesvorwahl, z. B. 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-multi-product.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": "'${WHATSAPP_SENDER_ID}'",
    "channel": "whatsapp",
    "message_type": "custom",
    "custom": {
      "type": "interactive",
      "interactive": {
        "type": "product_list",
        "header":{
          "type": "text",
          "text": "Our top products"
        },
        "body": {
          "text": "Check out these great products"
        },
        "footer": {
          "text": "Sale now on!"
        },
        "action":{
          "catalog_id": "'${WHATSAPP_CATALOG_ID}'",
          "sections": [
            {
              "title": "Cool products",
              "product_items": [
                { 
                  "product_retailer_id": "'${WHATSAPP_PRODUCT_ID_1}'"
                },
                { 
                  "product_retailer_id": "'${WHATSAPP_PRODUCT_ID_2}'"
                }
              ]
            },
            {
              "title": "Awesome products",
              "product_items": [
                { 
                  "product_retailer_id": "'${WHATSAPP_PRODUCT_ID_1}'"

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-multi-product.sh

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:

implementation 'com.vonage:server-sdk-kotlin:2.1.1'

Erstellen Sie eine Datei mit dem Namen SendWhatsappMultiProduct 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 SendWhatsappMultiProduct Folgendes hinzu:

val messageId = client.messages.send(
    whatsappMultiProduct {
        to(MESSAGES_TO_NUMBER)
        from(WHATSAPP_SENDER_ID)
        headerText("Our top products")
        bodyText("Check out these great products")
        footerText("Sale now on!")
        catalogId(WHATSAPP_CATALOG_ID)
        addProductsSection("Cool products", WHATSAPP_PRODUCT_ID, WHATSAPP_PRODUCT_ID)
        addProductsSection("Awesome products", WHATSAPP_PRODUCT_ID)
    }
)

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:

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

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

gradle run -Pmain=com.vonage.quickstart.kt.messages.whatsapp.SendWhatsappMultiProduct

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:

implementation 'com.vonage:server-sdk:9.3.1'

Erstellen Sie eine Datei mit dem Namen SendWhatsappMultiProduct 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 SendWhatsappMultiProduct Folgendes hinzu:

var response = client.getMessagesClient().sendMessage(
		WhatsappMultiProductRequest.builder()
			.from(WHATSAPP_SENDER_ID).to(MESSAGES_TO_NUMBER)
			.catalogId("1166260820787549")
			.headerText("Our top products")
			.bodyText("Check out these great products")
			.addProductsSection("Cool products", Arrays.asList("ch76nhzdeq", "r07qei73l7"))
			.addProductsSection("Awesome product", "unepvzvsfp")
			.footerText("Sale now on!")
			.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:

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

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

gradle run -Pmain=com.vonage.quickstart.messages.whatsapp.SendWhatsappMultiProduct

Voraussetzungen

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

Install-Package Vonage

Schreiben Sie den Code

Fügen Sie Folgendes zu SendWhatsAppMultiProduct.cs hinzu:

var credentials = Credentials.FromAppIdAndPrivateKeyPath(VONAGE_APPLICATION_ID, VONAGE_PRIVATE_KEY_PATH);
var vonageClient = new VonageClient(credentials);
var request = new WhatsAppCustomRequest
{
    To = MESSAGES_TO_NUMBER,
    From = WHATSAPP_SENDER_ID,
    Custom = new
    {
        type = "interactive",
        interactive = new
        {
            type = "product_list",
            header = new
            {
                type = "text",
                text = "Our top products"
            },
            body = new
            {
                text = "Check out these great products"
            }
        },
        footer = new
        {
            text = "Sale now on!"
        },
        action = new
        {
            catalog_id = WHATSAPP_CATALOG_ID,
            sections = new[]
            {
                new
                {
                    title = "Cool products",
                    product_items = new[]
                    {
                        new { product_retailer_id = WHATSAPP_PRODUCT_ID },
                        new { product_retailer_id = WHATSAPP_PRODUCT_ID }
                    }
                },
                new
                {
                    title = "Awesome products",
                    product_items = new[]
                    {
                        new { product_retailer_id = WHATSAPP_PRODUCT_ID }
                    }
                }
            }
        }
    }
};
var response = await vonageClient.MessagesClient.SendAsync(request);

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.

composer require vonage/client

Erstellen Sie eine Datei mit dem Namen send-multi-product.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-multi-product.php hinzu:

$custom = [
    "type" => "interactive",
    "interactive" => [
        "type" => "product_list",
        "header" => [
            "type" => "text",
            "text" => "Our top products"
        ],
        "body" => [
            "text" => "Check out these great products"
        ],
        "footer" => [
            "text" => "Sale now on!"
        ],
        "action" => [
            "catalog_id" => CATALOG_ID,
            "sections" => [
                [
                    "title" => "Cool products",
                    "product_items" => [
                        ["product_retailer_id" => PRODUCT_ID],
                        ["product_retailer_id" => PRODUCT_ID]
                    ]
                ],
                [
                    "title" => "Awesome products",
                    "product_items" => [
                        ["product_retailer_id" => PRODUCT_ID]
                    ]
                ]
            ]
        ]
    ]
];

$whatsApp = new \Vonage\Messages\Channel\WhatsApp\WhatsAppCustom(
    TO_NUMBER,
    FROM_NUMBER,
    $custom
);

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

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-multi-product.php

Voraussetzungen

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

pip install vonage python-dotenv

Schreiben Sie den Code

Fügen Sie Folgendes zu send-product-message-multiple-item.py hinzu:

from vonage import Auth, Vonage
from vonage_messages import WhatsappCustom

client = Vonage(
    Auth(
        application_id=VONAGE_APPLICATION_ID,
        private_key=VONAGE_PRIVATE_KEY,
    )
)

message = WhatsappCustom(
    to=MESSAGES_TO_NUMBER,
    from_=WHATSAPP_SENDER_ID,
    custom={
        'type': 'interactive',
        'interactive': {
            'type': 'product_list',
            'header': {'type': 'text', 'text': 'Our top products'},
            'body': {'text': 'Check out these great products'},
            'footer': {'text': 'Sale now on!'},
            'action': {
                'catalog_id': WHATSAPP_CATALOG_ID,
                'sections': [
                    {
                        'title': 'Cool products',
                        'product_items': [
                            {'WHATSAPP_PRODUCT_ID_1': WHATSAPP_PRODUCT_ID_1},
                            {'WHATSAPP_PRODUCT_ID_2': WHATSAPP_PRODUCT_ID_2},
                        ],
                    },
                    {
                        'title': 'Awesome products',
                        'product_items': [
                            {'WHATSAPP_PRODUCT_ID_1': WHATSAPP_PRODUCT_ID_1}
                        ],
                    },
                ],
            },
        },
    },
)

response = client.messages.send(message)
print(response)

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/whatsapp/send-product-message-multiple-item.py

Voraussetzungen

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

gem install vonage

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

Vollständige Quelle anzeigen

Schreiben Sie den Code

Fügen Sie Folgendes zu send-multi-product.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-multi-product.rb

Probieren Sie es aus

Wenn Sie den Code ausführen, wird eine WhatsApp-Multiproduktnachricht an die Zielnummer gesendet.