Эта страница переведена с помощью 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:

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

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

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

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 .

Java

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 .

Python

# 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 .

C#

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:

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

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

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:

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

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

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:

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

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

Java

Python

C#

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

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

Консоль

API

cURL

Получите информацию о состоянии всех тестовых устройств.

Консоль

API

cURL

Извлечь тестовое устройство

Консоль

API

cURL

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