Updates : ознакомьтесь с примечаниями к выпуску, чтобы узнать о новых функциях и обновлениях продукта. , Обновления : Ознакомьтесь с примечаниями к выпуску , чтобы узнать о новых функциях и обновлениях продукта.

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

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

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

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

Агенты могут отправлять не более 20 приглашений для тестирования в день, при этом общий лимит составляет 200 приглашений.

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

В приложении «Сообщения» перейдите в настройки «Сообщения» .
Нажмите «RCS-чаты» . Если вы не можете найти «RCS-чаты», нажмите «Функции чата» .
Найдите значение статуса .

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

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

Включите RCS на вашем устройстве

Чтобы включить RCS на устройстве Android, включите чаты RCS в приложении «Сообщения» .

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

Отправить приглашение тестировщику

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

Если устройство не поддерживает RCS, не ответило на приглашение тестировщика или отклонило его, ваш агент получит ошибку 403 PERMISSION_DENIED при попытке установить связь с устройством.

Консоль

Чтобы отправить приглашение тестировщику с помощью консоли разработчика Business Communications:

Откройте консоль разработчика бизнес-коммуникаций , войдите в свою учетную запись RBM Google и выберите своего агента.
В левом меню выберите Устройства .
Добавьте тестовое устройство в список тестовых устройств , введя его номер телефона, включая код страны и код города. Чтобы добавить несколько номеров, разделите их запятыми.

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

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

API

Чтобы отправить приглашение тестировщику с помощью API управления RBM:

Используйте следующий код. Параметры форматирования и значений см. в разделе testers .

cURL

curl -X POST "https://businesscommunications.googleapis.com/v1/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`" \
-d '{"phone_number": "PHONE_NUMBER", "agentId": "AGENT_ID"}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', function(response) {
   console.log(response);
});

Этот код является отрывком из примера агента RBM .

Ява

import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Register the device as a tester
   rbmApiHelper.registerTester("+12223334444");
} catch(Exception e) {
   e.printStackTrace();
}

Этот код является отрывком из примера агента RBM .

Питон

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Send the tester invite to a device
rbm_service.invite_tester('+12223334444')

Этот код является отрывком из примера агента RBM .

С#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

// Register the device as a tester
rbmApiHelper.RegisterTester("+12223334444");

Этот код является отрывком из примера агента RBM .

Если вы отправите более 200 приглашений, платформа RBM вернет в ответ код ошибки 429 RESOURCE_EXHAUSTED .

Повторно отправить приглашение тестировщику

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

Статус устройства	Результат
`PENDING`	Приглашение тестировщика отправляется на устройство.
`ACCEPTED`	Приглашение тестировщика не отправляется на устройство, которое сохраняет статус `ACCEPTED` .
`DECLINED`	Приглашение тестировщика отклонено. Перед повторной отправкой приглашения необходимо удалить тестовое устройство . В противном случае запрос не будет выполнен.

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

Получить статус приглашения тестового устройства

Когда вы приглашаете тестировщика, он может принять или отклонить приглашение на своём устройстве. Вы можете запросить API статус приглашения устройства.

Консоль

Чтобы получить статус приглашения тестового устройства с помощью консоли разработчика Business Communications:

Откройте консоль разработчика бизнес-коммуникаций , войдите в свою учетную запись RBM Google и выберите своего агента.
В левом меню выберите Устройства .
Добавьте тестовое устройство в список тестовых устройств , введя его номер телефона, включая код страны и код города. Чтобы добавить несколько номеров, разделите их запятыми.

Когда тестовое устройство добавляется в список, вы можете проверить его статус в столбце «Статус» .

API

Чтобы получить статус приглашения тестового устройства с помощью API управления RBM:

Используйте следующий код. Параметры форматирования и значений см. в разделе testers .

cURL

curl -X GET "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

Получить статус всех тестовых устройств

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

Консоль

Чтобы проверить статус приглашения всех тестовых устройств с помощью консоли разработчика Business Communications:

Откройте консоль разработчика бизнес-коммуникаций , войдите в свою учетную запись RBM Google и выберите своего агента.
В левом меню выберите Устройства .
Добавьте тестовое устройство в список тестовых устройств , введя его номер телефона, включая код страны и код города. Чтобы добавить несколько номеров, разделите их запятыми.

Когда тестовое устройство добавляется в список, вы можете проверить его статус в столбце «Статус» .

API

Чтобы проверить статус приглашения всех тестовых устройств с помощью API управления RBM:

Используйте следующий код. Параметры форматирования и значений см. в разделе testers .

cURL

curl -X GET "https://businesscommunications.googleapis.com/v1/testers?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

Удалить тестовое устройство

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

Консоль

Чтобы удалить тестовое устройство с помощью консоли разработчика Business Communications:

Откройте консоль разработчика бизнес-коммуникаций , войдите в свою учетную запись RBM Google и выберите своего агента.
В левом меню выберите Устройства .
Выберите устройство в списке тестовых устройств и нажмите меню .
Нажмите Удалить устройство .

API

Чтобы удалить тестовое устройство с помощью API управления RBM:

Используйте следующий код. Параметры форматирования и значений см. в разделе testers .

cURL

curl -X DELETE "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

Изменить информацию об агенте

Глубокие ссылки

Настройте тестовое устройство Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

Включите RCS на вашем устройстве

Отправить приглашение тестировщику

Консоль

API

cURL

Node.js

Ява

Питон

С#

Повторно отправить приглашение тестировщику

Получить статус приглашения тестового устройства

Консоль

API

cURL

Получить статус всех тестовых устройств

Консоль

API

cURL

Удалить тестовое устройство

Консоль

API

cURL

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