コンタクトを送信する

このコードでは、Messages API を使って連絡先を WhatsApp に送信する方法を説明します。このコードでは Vonage の カスタムオブジェクト 機能をご利用ください。具体的なメッセージフォーマットについてはWhatsApp開発者向けページをご覧下さい。 連絡先メッセージ ドキュメンテーション

例

各コード・スニペットで使用されているすべての変数の説明を以下に示します：

キー説明
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

注： 先頭の + または 00 電話番号を入力する場合は、447700900000のように国番号から入力してください。

前提条件

申込書をお持ちでない場合は、ひとつ作る 。ウェブフックの設定 もご確認ください。

コードを書く

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"
            }
          ]
        }
      ]
    }
  }'

全文を見る

コードを実行する

このファイルをあなたのマシンに保存し、実行する：

bash send-contact.sh

前提条件

申込書をお持ちでない場合は、ひとつ作る 。ウェブフックの設定 もご確認ください。

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

send-contact.js という名前のファイルを作成し、以下のコードを追加する：

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

全文を見る

コードを書く

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

全文を見る

コードを実行する

このファイルをあなたのマシンに保存し、実行する：

node send-contact.js

前提条件

申込書をお持ちでない場合は、ひとつ作る 。ウェブフックの設定 もご確認ください。

build.gradle に以下を追加する：

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

SendWhatsappContact という名前のファイルを作成し、main メソッドに以下のコードを追加する：

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

全文を見る

コードを書く

SendWhatsappContact ファイルのmain メソッドに以下を追加する：

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"
                        )
                    )
                )
            )
        ))
    }
)

全文を見る

コードを実行する

Gradle用のアプリケーション プラグインを使うことで、アプリケーションの実行を簡単にすることができます。build.gradle を以下のように更新する：

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

以下のgradle コマンドを実行し、com.vonage.quickstart.kt.messages.whatsapp をSendWhatsappContact を含むパッケージに置き換えてアプリケーションを実行する：

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

前提条件

申込書をお持ちでない場合は、ひとつ作る 。ウェブフックの設定 もご確認ください。

build.gradle に以下を追加する：

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

SendWhatsappContact という名前のファイルを作成し、main メソッドに以下のコードを追加する：

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

全文を見る

コードを書く

SendWhatsappContact ファイルのmain メソッドに以下を追加する：

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

全文を見る

コードを実行する

Gradle用のアプリケーション プラグインを使うことで、アプリケーションの実行を簡単にすることができます。build.gradle を以下のように更新する：

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

以下のgradle コマンドを実行し、com.vonage.quickstart.messages.whatsapp をSendWhatsappContact を含むパッケージに置き換えてアプリケーションを実行する：

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

前提条件

申込書をお持ちでない場合は、ひとつ作る 。ウェブフックの設定 もご確認ください。

Install-Package Vonage

コードを書く

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

全文を見る

前提条件

申込書をお持ちでない場合は、ひとつ作る 。ウェブフックの設定 もご確認ください。

composer require vonage/client

send-contact.php という名前のファイルを作成し、以下のコードを追加する：

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

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

全文を見る

コードを書く

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

全文を見る

コードを実行する

このファイルをあなたのマシンに保存し、実行する：

php send-contact.php

前提条件

申込書をお持ちでない場合は、ひとつ作る 。ウェブフックの設定 もご確認ください。

pip install vonage python-dotenv

コードを書く

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)

全文を見る

コードを実行する

このファイルをあなたのマシンに保存し、実行する：

python messages/whatsapp/send-contact.py

前提条件

申込書をお持ちでない場合は、ひとつ作る 。ウェブフックの設定 もご確認ください。

gem install vonage

send-contact.rb という名前のファイルを作成し、以下のコードを追加する：

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

全文を見る

コードを書く

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
)

全文を見る

コードを実行する

このファイルをあなたのマシンに保存し、実行する：

ruby send-contact.rb

試してみる

コードを実行すると、WhatsApp 連絡先メッセージが相手先の番号に送信されます。WhatsAppでは連絡先の詳細を確認したり、必要に応じてアドレス帳に追加することができます。

詳細情報