Эта страница переведена с помощью Cloud Translation API.

Зарегистрируйтесь в бизнес-сообщениях

Когда вы регистрируетесь в качестве партнера в Business Messages, вы можете разрешить общение между пользователями и брендами, создав агентов — диалоговые объекты, которые представляют бизнес-функции, такие как поддержка веб-сайтов и местоположения брендов.

Когда пользователь находит бренд, которым вы управляете, в Поиске Google или на Картах Google, в результатах поиска отображается параметр Чат . Когда пользователь нажимает Чат , он может отправлять сообщения агенту бренда. Агент позволяет получать сообщения пользователя и отвечать на них.

Зарегистрируйтесь как партнер

Зарегистрировавшись в качестве партнера в Business Messages, создав агентов для брендов и используя API-интерфейсы, которые обеспечивают работу вашего агента, вы можете включить возможности обмена сообщениями для обслуживания клиентов, продаж и других бизнес-приложений.

Откройте консоль разработчика бизнес-коммуникаций .
В разделе Деловые сообщения щелкните Создать учетную запись партнера .

Введите значения для информации о партнере:

Поле	Ценность
Ваше имя	Ваше полное имя
Имя партнера	Название вашей организации
Сайт партнера	Сайт вашей организации
Область, край	Регион, в котором вы хотите разместить службу бизнес-сообщений

Прочтите и примите Условия предоставления услуг для деловых сообщений .
Щелкните Создать .

Теперь вы зарегистрированы в качестве партнера Business Messages и имеете доступ к API Business Messages и Business Communications. API Business Messages отправляет сообщения пользователям, а API Business Communications управляет агентами.

Создать учетную запись службы

Для безопасной проверки подлинности вызовов API к API бизнес-сообщений и бизнес-коммуникаций вам потребуется ключ сервисной учетной записи и инструмент командной строки oauth2l .

На домашней странице консоли разработчика Business Communications щелкните Параметры учетной записи партнера .
На левой панели навигации нажмите Сервисный аккаунт .
Щелкните Создать ключ , затем щелкните Создать .
Ваш браузер загружает ключ сервисной учетной записи. Храните ключ служебной учетной записи в безопасном частном месте. Не делитесь своим ключом публично. Этот ключ понадобится вам позже для доступа к API бизнес-сообщений и делового общения.

Установите свою веб-книгу

Теперь, когда Business Messages и Business Communications API включены, вы должны указать URL-адрес веб-перехватчика, чтобы начать получать сообщения .

Откройте настройки учетной записи в консоли разработчика Business Communications.
Убедитесь, что выбран правильный партнерский аккаунт.
Для URL-адреса веб-перехватчика Business Messages щелкните Настроить .
В поле URL- адрес конечной точки веб -перехватчика введите URL-адрес веб-перехватчика, начинающийся с «https://».
Обратите внимание на значение clientToken . Он нужен вам, чтобы убедиться, что получаемые вами сообщения исходят от Google .
Настройте свой веб-перехватчик для приема запроса POST с указанным параметром clientToken и отправки ответа 200 OK с обычным текстовым значением secret параметра в качестве тела ответа.
Например, если ваш веб-перехватчик получает запрос POST со следующим содержимым тела
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
ваш веб-перехватчик должен подтвердить значение clientToken и, если clientToken правильный, вернуть ответ 200 OK с 0123456789 в качестве тела ответа.
В консоли нажмите Подтвердить .
Когда Business Messages проверит ваш веб-перехватчик, диалоговое окно закроется.

См. Пример: обновление URL-адреса веб -перехватчика, чтобы узнать, как настроить веб-перехватчик с помощью API для делового общения.

Получить информацию о партнере

Чтобы получить текущую информацию о партнере, вы можете запросить Business Communications API со своим идентификатором партнера.

Выполните следующую команду. Замените PARTNER_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 или выполнить следующие команды.

Замените PARTNER_ID своим идентификатором партнера (идентификатор партнера можно найти в консоли разработчика Business Communications) и замените 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',
}"

Пример: обновить 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, вы можете приступить к разработке с помощью Business Messages. Чтобы быстро приступить к работе, см. статью Создание первого агента .

В противном случае узнайте, как создавать агентов для представления ваших брендов в беседах и настраивать веб-перехватчик для получения сообщений от пользователей.