ビジネスメッセージに登録する

ビジネスメッセージでパートナーとして登録すると、会話形式でエージェントを作成することで、ユーザーとブランドの間の会話をビジネス機能を表すエンティティ（ウェブサイトのサポート、ブランドなど）提供します

Google 検索や Google マップで、あなたが管理しているブランドをユーザーが見つけたら、検索結果に [チャット] オプションが表示されます。ユーザーが [チャット] をクリックすると、ブランドのエージェントにメッセージを送信できますこのエージェントは、エージェントが自動的に適用されます。

パートナーとして登録

ビジネスメッセージのパートナー登録、ブランドのエージェントの作成、エージェントを強化する API を使用すると、カスタマーサービス、販売、その他のビジネスアプリケーション向けに開発されました。

Business Communications Developer Console を開きます。
[ビジネスメッセージ] で [パートナーアカウントを作成] をクリックします。

パートナー情報に値を入力します。

フィールド	値
名前	氏名
パートナー名	組織名
パートナーウェブサイト	組織のウェブサイト
地域	ビジネスメッセージサービスをホストするリージョン

で確認できます。

次を確認して同意してくださいビジネスメッセージの利用規約
[作成] をクリックします。

ビジネスメッセージパートナーとして登録され、Business Messages API と Business Communications API をご利用いただけるようになりました。Business Messages API はユーザーにメッセージを送信し、Business Communications API はエージェントを管理します。

サービスアカウントを作成する

Business Messages API と Business Communications API への API 呼び出しを安全に認証するには、サービスアカウントキーと oauth2l コマンドラインツール。

Business Communications Developer Console のホームページで、[パートナーアカウントの設定] をクリックします。
左側のナビゲーションで サービスアカウント。
[鍵を作成]、[作成] の順にクリックします。

ブラウザにサービスアカウントキーがダウンロードされます。サービスアカウントキーを安全な非公開の場所に保存します。すべきでないこと鍵を公開します。このキーは、後で Business Message API と Business Communication API にアクセスする際に必要になります。

で確認できます。

Webook を設定する

Business Messages API と Business Communications API が有効になったので、開始するには Webhook URL を指定する必要がありますメッセージを受信します。

Business Communications Developer Console で [アカウント設定] を開きます。
正しいパートナーアカウントが選択されていることを確認します。
[Business Messages webhook URL] で [Configure] をクリックします。
[Webhook endpoint URL] に、Webhook の URL（ "https://"
clientToken の値をメモします。これは、受信したメールが受信の送信元が Google。
指定された POST リクエストを受け入れるように Webhook を構成します。 clientToken パラメータを使用して書式なしテキストを含む 200 OK レスポンスを送信しますレスポンス本文として secret パラメータの値を指定します。

たとえば、Webhook が次の POST リクエストを受け取ったとします。身体の内容
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
Webhook が clientToken の値を確認します。clientToken の値が確認された場合は、正しくない場合は、レスポンスの本文として 0123456789 を含む 200 OK レスポンスを返します。
コンソールで [確認] をクリックします。

ビジネスメッセージが Webhook の確認を完了すると、ダイアログが閉じます。

詳しくは、例: Webhook URL を更新するをご覧ください。

パートナー情報を取得する

現在のパートナー情報を取得するには、Business Communications API をパートナー ID に置き換えます。

以下のコマンドを実行します。PARTNER_ID は、パートナー ID に置き換えます。

# This code gets the partner.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get

# Replace the __PARTNER_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"get-partner.sh

パートナー情報を更新する

パートナー情報を更新するには、Business Communications Developer Console の [アカウント設定] ページを使用するか、次のコマンドを実行します。

置換 PARTNER_ID は、パートナー ID（パートナー ID は Business Communications Developer Console で確認できます）に置き換えます。また、 UPDATED_FIELDS は、更新するフィールド名に置き換えます。

# This code updates the partner entity.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/patch

# Replace the __PARTNER_ID__, __UPDATED_FIELDS__, __FIELD_NAME__, __FIELD_VALUE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__?updateMask=__UPDATED_FIELDS__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "__FIELD_NAME__": "__FIELD_VALUE__"
}'update-partner.sh

書式設定と値のオプションについては、以下をご覧ください。 partners.patch。

例: 表示名を更新する

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/12345/partners/67890?updateMask=displayName" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
    'displayName': 'XYZ Messaging',
}"

例: Webhook URL を更新する

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/12345?updateMask=productCapabilities" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
  'productCapabilities': [
    {
      'product': 'BUSINESS_MESSAGES',
      'businessMessagesCapability': {
        'webhookUrl': 'https://xyz.messaging.com/webhook',
      },
    },
  ],
}"

次のステップ

パートナーとして登録され、API が有効になりました。ビジネスメッセージを使って開発しますさっそく使い始めるには、最初のエージェントを作成します。

それ以外の場合は、エージェントを作成するブランドを会話で表現したり、Webhook を設定してメッセージを受信する制限します。