Envoyer un contact

Dans cet extrait de code, vous apprendrez comment envoyer un contact à WhatsApp à l'aide de l'API Messages. Cette méthode utilise l'API Objet personnalisé fonctionnalité. Pour plus d'informations sur le format spécifique des messages, consultez la page des développeurs de WhatsApp. Message de contact documentation.

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_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

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 dossier de candidature, vous pouvez vous adresser à créer un. Veillez également à configurer vos webhooks.

Rédiger le code

Ajouter ce qui suit à send-contact.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": "'${WHATSAPP_SENDER_ID}'",
    "channel": "whatsapp",
    "message_type": "custom",
    "custom": {
      "type": "contacts",
      "contacts": [
        {
          "addresses": [
            {
              "city": "Menlo Park",
              "country": "United States",
              "country_code": "us",
              "state": "CA",
              "street": "1 Hacker Way",
              "type": "HOME",
              "zip": "94025"
            },
            {
              "city": "Menlo Park",
              "country": "United States",
              "country_code": "us",
              "state": "CA",
              "street": "200 Jefferson Dr",
              "type": "WORK",
              "zip": "94025"
            }
          ],
          "birthday": "2012-08-18",
          "emails": [
            {
              "email": "test@fb.com",
              "type": "WORK"
            },
            {
              "email": "test@whatsapp.com",
              "type": "WORK"
            }
          ],
          "name": {
            "first_name": "John",
            "formatted_name": "John Smith",
            "last_name": "Smith"
          },
          "org": {
            "company": "WhatsApp",
            "department": "Design",
            "title": "Manager"
          },
          "phones": [
            {
              "phone": "+1 (940) 555-1234",
              "type": "HOME"
            },
            {
              "phone": "+1 (650) 555-1234",
              "type": "WORK",
              "wa_id": "16505551234"
            }
          ],
          "urls": [
            {
              "url": "https://www.facebook.com",
              "type": "WORK"
            }
          ]
        }
      ]
    }
  }'

Voir la source complète

Exécutez votre code

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

bash send-contact.sh

Conditions préalables

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

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

Créez un fichier nommé send-contact.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-contact.js:

vonage.messages.send({
  to: MESSAGES_TO_NUMBER,
  from: WHATSAPP_SENDER_ID,
  channel: Channels.WHATSAPP,
  messageType: 'custom',
  custom: {
    type: 'contacts',
    contacts: [
      {
        addresses: [
          {
            city: 'Menlo Park',
            country: 'United States',
            country_code: 'us',
            state: 'CA',
            street: '1 Hacker Way',
            type: 'HOME',
            zip: '94025',
          },
          {
            city: 'Menlo Park',
            country: 'United States',
            country_code: 'us',
            state: 'CA',
            street: '200 Jefferson Dr',
            type: 'WORK',
            zip: '94025',
          },
        ],
        birthday: '2012-08-18',
        emails: [
          {
            email: 'test@fb.com',
            type: 'WORK',
          },
          {
            email: 'test@whatsapp.com',
            type: 'WORK',
          },
        ],
        name: {
          first_name: 'John',
          formatted_name: 'John Smith',
          last_name: 'Smith',
        },
        org: {
          company: 'WhatsApp',
          department: 'Design',
          title: 'Manager',
        },
        phones: [
          {
            phone: '+1 (940) 555-1234',
            type: 'HOME',
          },
          {
            phone: '+1 (650) 555-1234',
            type: 'WORK',
            wa_id: '16505551234',
          },
        ],
        urls: [
          {
            url: 'https://www.facebook.com',
            type: 'WORK',
          },
        ],
      },
    ],
  },
})
  .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-contact.js

Conditions préalables

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

Ajouter ce qui suit à build.gradle:

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

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

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

Voir la source complète

Rédiger le code

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

val messageId = client.messages.send(
    whatsappCustom {
        to(MESSAGES_TO_NUMBER)
        from(WHATSAPP_SENDER_ID)
        custom(mapOf(
            "type" to "contacts",
            "contacts" to listOf(
                mapOf(
                    "addresses" to listOf(
                        mapOf(
                            "city" to "Menlo Park",
                            "country" to "United States",
                            "state" to "CA",
                            "country_code" to "us",
                            "street" to "1 Hacker Way",
                            "type" to "HOME",
                            "zip" to "94025"
                        ),
                        mapOf(
                            "city" to "Menlo Park",
                            "country" to "United States",
                            "state" to "CA",
                            "country_code" to "us",
                            "street" to "200 Jefferson Dr",
                            "type" to "WORK",
                            "zip" to "94025"
                        )
                    ),
                    "birthday" to "2012-08-18",
                    "emails" to listOf(
                        mapOf(
                            "email" to "test@fb.com",
                            "type" to "WORK"
                        ),
                        mapOf(
                            "email" to "test@whatsapp.com",
                            "type" to "WORK"
                        )
                    ),
                    "name" to mapOf(
                        "first_name" to "Jayden",
                        "last_name" to "Smith",
                        "formatted_name" to "J. Smith"
                    ),
                    "org" to mapOf(
                        "company" to "WhatsApp",
                        "department" to "Design",
                        "title" to "Manager"
                    ),
                    "phones" to listOf(
                        mapOf(
                            "phone" to "+1 (940) 555-1234",
                            "type" to "HOME"
                        ),
                        mapOf(
                            "phone" to "+1 (650) 555-1234",
                            "type" to "WORK",
                            "wa_id" to "16505551234"
                        )
                    ),
                    "urls" to listOf(
                        mapOf(
                            "url" to "https://www.facebook.com",
                            "type" to "WORK"
                        )
                    )
                )
            )
        ))
    }
)

Voir la source complète

Exécutez votre code

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

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

Lancez la commande suivante gradle pour exécuter votre application, en remplaçant com.vonage.quickstart.kt.messages.whatsapp par le paquet contenant SendWhatsappContact:

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

Conditions préalables

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

Ajouter ce qui suit à build.gradle:

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

Créez un fichier nommé SendWhatsappContact 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 SendWhatsappContact:

var response = client.getMessagesClient().sendMessage(
		WhatsappCustomRequest.builder()
			.from(WHATSAPP_SENDER_ID).to(MESSAGES_TO_NUMBER)
			.custom(Map.of(
				"type", "contacts",
				"contacts", List.of(Map.of(
					"addresses", List.of(
						Map.of(
							"city", "Menlo Park",
							"country", "United States",
							"state", "CA",
							"country_code", "us",
							"street", "1 Hacker Way",
							"type", "HOME",
							"zip", "94025"
						),
						Map.of(
							"city", "Menlo Park",
							"country", "United States",
							"state", "CA",
							"country_code", "us",
							"street", "200 Jefferson Dr",
							"type", "WORK",
							"zip", "94025"
						)
					),
					"birthday", "2012-08-18",
					"emails", List.of(
						Map.of(
							"email", "test@fb.com",
							"type", "WORK"
						),
						Map.of(
							"email", "test@whatsapp.com",
							"type", "WORK"
						)
					),
					Map.of("name", Map.of(
						"first_name", "Jayden",
						"last_name", "Smith",
						"formatted_name", "J. Smith"
					)),
					Map.of("org", Map.of(
						"company", "WhatsApp",
						"department", "Design",
						"title", "Manager"
					)),
					Map.of("phones", List.of(
						Map.of(
							"phone", "+1 (940) 555-1234",
							"type", "HOME"
						),
						Map.of(
							"phone", "+1 (650) 555-1234",
							"type", "WORK",
							"wa_id", "16505551234"
						)
					)),
					Map.of("urls", List.of(
						Map.of(
							"url", "https://www.facebook.com",
							"type", "WORK"
						)
					))
				))
			))
			.build()
);
System.out.println("Message sent successfully. ID: "+response.getMessageUuid());

Voir la source complète

Exécutez votre code

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

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

Lancez la commande suivante gradle pour exécuter votre application, en remplaçant com.vonage.quickstart.messages.whatsapp par le paquet contenant SendWhatsappContact:

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

Conditions préalables

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

Install-Package Vonage

Rédiger le code

Ajouter ce qui suit à SendWhatsAppContact.cs:

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 = "contacts",
        contacts = new []
        {
            new
            {
               name = new {
                first_name = "John",
                formatted_name = "John Smith",
                last_name = "Smith",
               },
               birthday = "2012-08-18",
               emails = new []
               {
                   new
                   {
                       email = "test@fb.com",
                       type = "WORK",
                   },
                   new
                   {
                       email = "test@whatsapp.com",
                       type = "WORK",
                   }
               },
               addresses = new []
               {
                    new
                    {
                         city = "Menlo Park",
                         country = "United States",
                         country_code = "US",
                         state = "CA",
                         street = "1 Hacker Way",
                         type = "WORK",
                         zip = "94025",
                    }
               },
               org = new
               {
                   company = "WhatsApp",
                   department = "Design",
                   title = "Manager",
               },
               urls = new
               {
                   url = "https://www.facebook.com",
                   type = "WORK",
               }
            }
        }
    }
};
var response = await vonageClient.MessagesClient.SendAsync(request);

Voir la source complète

Conditions préalables

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

composer require vonage/client

Créez un fichier nommé send-contact.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);

Voir la source complète

Rédiger le code

Ajouter ce qui suit à send-contact.php:

$custom = [
    "type" => "contacts",
    "contacts" => [
        [
            "addresses" => [
                [
                    "city" => "Menlo Park",
                    "country" => "United States",
                    "country_code" => "us",
                    "state" => "CA",
                    "street" => "1 Hacker Way",
                    "type" => "HOME",
                    "zip" => "94025",
                ],
                [
                    "city" => "Menlo Park",
                    "country" => "United States",
                    "country_code" => "us",
                    "state" => "CA",
                    "street" => "200 Jefferson Dr",
                    "type" => "WORK",
                    "zip" => "94025",
                ],
            ],
            "birthday" => "2012-08-18",
            "emails" => [
                ["email" => "test@fb.com", "type" => "WORK"],
                ["email" => "test@whatsapp.com", "type" => "WORK"],
            ],
            "name" => [
                "first_name" => "John",
                "formatted_name" => "John Smith",
                "last_name" => "Smith",
            ],
            "org" => [
                "company" => "WhatsApp",
                "department" => "Design",
                "title" => "Manager",
            ],
            "phones" => [
                ["phone" => "+1 (940) 555-1234", "type" => "HOME"],
                [
                    "phone" => "+1 (650) 555-1234",
                    "type" => "WORK",
                    "wa_id" => "16505551234",
                ],
            ],
            "urls" => [["url" => "https://www.facebook.com", "type" => "WORK"]],
        ],
    ],
];

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

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

Voir la source complète

Exécutez votre code

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

php send-contact.php

Conditions préalables

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

pip install vonage python-dotenv

Rédiger le code

Ajouter ce qui suit à send-contact.py:

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": "contacts",
        "contacts": [
            {
                "addresses": [
                    {
                        "city": "Menlo Park",
                        "country": "United States",
                        "country_code": "us",
                        "state": "CA",
                        "street": "1 Hacker Way",
                        "type": "HOME",
                        "zip": "94025",
                    },
                    {
                        "city": "Menlo Park",
                        "country": "United States",
                        "country_code": "us",
                        "state": "CA",
                        "street": "200 Jefferson Dr",
                        "type": "WORK",
                        "zip": "94025",
                    },
                ],
                "birthday": "2012-08-18",
                "emails": [
                    {"email": "test@fb.com", "type": "WORK"},
                    {"email": "test@whatsapp.com", "type": "WORK"},
                ],
                "name": {
                    "first_name": "John",
                    "formatted_name": "John Smith",
                    "last_name": "Smith",
                },
                "org": {
                    "company": "WhatsApp",
                    "department": "Design",
                    "title": "Manager",
                },
                "phones": [
                    {"phone": "+1 (940) 555-1234", "type": "HOME"},
                    {
                        "phone": "+1 (650) 555-1234",
                        "type": "WORK",
                        "wa_id": "16505551234",
                    },
                ],
                "urls": [{"url": "https://www.facebook.com", "type": "WORK"}],
            }
        ],
    },
)

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

Voir la source complète

Exécutez votre code

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

python messages/whatsapp/send-contact.py

Conditions préalables

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

gem install vonage

Créez un fichier nommé send-contact.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-contact.rb:

message = client.messaging.whatsapp(
  type: 'custom',
  message: {
    type: "contacts",
    contacts: [
      {
        addresses: [
          {
            city: "Menlo Park",
            country: "United States",
            country_code: "us",
            state: "CA",
            street: "1 Hacker Way",
            type: "HOME",
            zip: "94025"
          },
          {
            city: "Menlo Park",
            country: "United States",
            country_code: "us",
            state: "CA",
            street: "200 Jefferson Dr",
            type: "WORK",
            zip: "94025"
          }
        ],
        birthday: "2012-08-18",
        emails: [
          {
            email: "test@fb.com",
            type: "WORK"
          },
          {
            email: "test@whatsapp.com",
            type: "WORK"
          }
        ],
        name: {
          first_name: "John",
          formatted_name: "John Smith",
          last_name: "Smith"
        },
        org: {
          company: "WhatsApp",
          department: "Design",
          title: "Manager"
        },
        phones: [
          {
            phone: "+1 (940) 555-1234",
            type: "HOME"
          },
          {
            phone: "+1 (650) 555-1234",
            type: "WORK",
            wa_id: "16505551234"
          }
        ],
        urls: [
          {
            url: "https://www.facebook.com",
            type: "WORK"
          }
        ]
      }
    ]
  }
)

client.messaging.send(
  from: WHATSAPP_SENDER_ID,
  to: MESSAGES_TO_NUMBER,
  **message
)

Voir la source complète

Exécutez votre code

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

ruby send-contact.rb

Essayez-le

Lorsque vous exécutez le code, un message de contact WhatsApp est envoyé au numéro de destination. Dans WhatsApp, vous pouvez consulter les détails du contact et l'ajouter au carnet d'adresses si nécessaire.

Plus d'informations