Создайте своего первого агента

Пользователи взаимодействуют с агентами через приложение для обмена сообщениями с поддержкой RCS, такое как Google Messages , на своих устройствах. В этом кратком руководстве вы создадите базовый агент RBM, который сможет отправлять простое сообщение на тестовое устройство и получать ответ.

Поток сообщения в беседе с поддержкой RBM

Предварительные условия

Прежде чем приступить к работе с агентом, вам понадобятся следующие элементы:

Настройте тестовое устройство

Для связи с не запущенным агентом RBM тестовое устройство должно иметь поддержку RCS, но не все устройства Android могут получать сообщения RCS по умолчанию. Вы можете проверить статус RCS вашего устройства и, при необходимости, включить RCS , настроив свое устройство с использованием предварительных версий приложений «Сообщения» и «Службы оператора связи».

Проверьте статус RCS вашего устройства

  1. В приложении «Сообщения» нажмите кнопку , затем нажмите «Настройки» .

  2. Нажмите «Функции чата» и найдите значение «Статус» .

    Если состояние «Подключено» , RCS на вашем устройстве активен.

Следующие шаги

Если RCS активен на вашем устройстве, вы готовы настроить свой агент . Если RCS неактивен на вашем устройстве, вам необходимо включить RCS на вашем устройстве, прежде чем вы сможете протестировать свой агент RBM.

Настройте своего агента

Агенты RBM используют RBM API для отправки сообщений , событий и других запросов пользователям. Создавая агента, вы включаете доступ к API RBM и определяете основную информацию вашего агента.

Определить регион агента

Агенты RBM могут существовать в одном из трех регионов: Северная Америка, Европа и Азиатско-Тихоокеанский регион. API RBM поддерживает три региональные конечные точки , помогая предприятиям соблюдать региональные и бизнес-требования.

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

Если вы или ваши предполагаемые пользователи не вписываются в эти регионы, выберите ближайший к вам регион, чтобы минимизировать задержку. Например:

  • Если вы находитесь в Латинской Америке, выберите регион Северная Америка.
  • Если вы находитесь в Африке, выберите регион Европа.
  • Если вы находитесь в Австралии, выберите Азиатско-Тихоокеанский регион.

Не выбирайте регион своего агента на основе целевых операторов связи. Все регионы имеют равный доступ к операторам связи по всему миру.

Определите платежную категорию агента

При создании агента RBM вам необходимо указать его категорию биллинга в зависимости от того, как агент будет взаимодействовать с пользователями. Выберите категорию, которая наиболее точно соответствует предполагаемому поведению вашего агента:

  • Разговорный : для агентов, которые участвуют в многоходовых беседах с пользователями.
  • Базовое сообщение или одиночное сообщение : для агентов, которые отправляют сообщения, не ожидая частых ответов.

Вы можете изменить категорию биллинга вашего агента только перед его запуском. Если вам нужно изменить категорию выставления счетов после запуска, отправьте электронное письмо по адресу rbm-support@google.com .

Дополнительную информацию о модели выставления счетов RBM см. в разделе часто задаваемых вопросов по выставлению счетов RBM .

Определите вариант использования агента

Каждый агент RBM должен иметь заранее определенный вариант использования. Это помогает классифицировать вашего агента и применять правильные бизнес-правила для удобства пользователей. RBM поддерживает четыре варианта использования:

  • OTP : одноразовые пароли, необходимые для безопасной аутентификации учетной записи или подтверждения транзакции.
  • Транзакционные : уведомления, обновления или оповещения, которые передают информацию, непосредственно имеющую отношение к существующим услугам или продуктам клиента, например оповещения о подозрительных действиях в учетной записи, подтверждения покупок и уведомления об отправке.
  • Рекламные сообщения : продажи, маркетинг и рекламные сообщения новым или существующим клиентам с целью повышения осведомленности, вовлеченности и продаж.
  • Многоразовое использование : разговоры, в которых сочетаются транзакционные и рекламные сообщения, например отправка уведомления об учетной записи с последующим предложением скидки или переходом на новый продукт или услугу.

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

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

Создать агент

Следуйте этим инструкциям, чтобы создать своего агента в консоли разработчика Business Communications.

Чтобы создать агента:

  1. Перейдите в консоль разработчика Business Communications и войдите в свою учетную запись Google партнера RBM.
  2. На главной странице нажмите + Создать агента .
  3. В окне «Новый агент RCS Business Messaging» укажите следующую информацию:
  4. Нажмите Создать агента .

Как только ваш агент станет доступен, вы сможете добавить информацию о бизнесе и брендинге. См. раздел Создание агента .

Пригласите свое тестовое устройство

Теперь, когда у вас есть агент и ваше тестовое устройство поддерживает RCS, вы можете пригласить свое устройство протестировать ваш агент.

  1. На панели навигации слева нажмите «Устройства» .
  2. В поле «Добавить тестовые устройства » введите номер телефона вашего устройства и нажмите «Добавить» .
  3. На тестовом устройстве примите запрос тестера для вашего агента.

Если вы не получили приглашение на тестовое устройство, убедитесь, что RCS включен на вашем устройстве.

Отправить сообщение

Благодаря зарегистрированному тестовому устройству ваш агент теперь может отправлять сообщения .

Для безопасной аутентификации вызовов API вам понадобится ключ учетной записи службы. Если вы еще не создали ключ сервисной учетной записи для своей партнерской учетной записи , сейчас самое время это сделать.

В терминале на вашей машине разработки выполните следующую команду:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!"
  }
}'
  • Замените REGION на asia , europe или us , в зависимости от региона вашего агента.
  • Замените PHONE_NUMBER номером телефона вашего тестового устройства. Включите код страны, код города и ведущий + , но не используйте разделители. Например, +14155555555 .
  • Замените AGENT ID на свой идентификатор агента, расположенный на странице информации об агенте в консоли разработчика Business Communications.
  • Замените PATH_TO_SERVICE_ACCOUNT_KEY на путь к ключу , который вы создали ранее.

Вы должны получить сообщение «Привет, мир!» сообщение от вашего агента на тестовом устройстве. Если вы не получили сообщение на тестовом устройстве, убедитесь, что вы правильно ввели и отформатировали номер телефона и путь к ключу своей учетной записи службы в команде.

Чтобы отправлять различные типы сообщений, например предлагаемые ответы и расширенные карточки, см. раздел «Отправка сообщений» .

Следующие шаги

Теперь, когда ваш агент может отправлять сообщения на тестовое устройство, пришло время создать что-то, что соответствует потребностям вашего бизнеса. Получите образец агента на предпочитаемом вами языке и следуйте инструкциям в README образца.

Настроив образец агента, ознакомьтесь с лучшими практиками RBM и узнайте, как агенты отправляют и получают сообщения.

Назад
Настройте свою партнерскую учетную запись,Настройте свою партнерскую учетную запись