테스트 기기

에이전트는 시작할 때까지 지정된 테스트 기기와만 통신할 수 있습니다. 이렇게 하면 최종 사용자에게 실수로 인한 사전 체험판을 방지하면서 내부적으로 에이전트를 테스트할 수 있습니다.

RBM 에이전트와 통신하려면 테스트 기기에 RCS가 사용 설정되어 있어야 합니다. 일부 Android 기기에는 기본적으로 RCS가 사용 설정되어 있지 않습니다. 기기의 RCS 상태를 확인하고 필요한 경우 출시 전 버전의 메시지 및 이동통신사 서비스 앱으로 기기를 구성하여 RCS를 사용 설정할 수 있습니다.

기기에서 RCS를 사용 설정하면 에이전트를 테스트할 기기를 초대하는 테스터 요청을 보낼 수 있습니다. 기기가 요청을 수락하면 기기에서 요청이 해제된 에이전트로부터 메시지를 수신하고 응답할 수 있습니다.

에이전트는 일일 최대 20개의 테스터 요청을 전송할 수 있으며, 총 요청은 200회로 제한됩니다. RBM API를 통해 테스터를 추가하고 200개가 넘는 요청을 보내는 경우 RBM 플랫폼은 429 RESOURCE_EXHAUSTED 응답을 반환합니다.

기기의 RCS 상태 확인하기

메시지 앱에서 메시지 설정으로 이동합니다.
RCS 채팅을 탭합니다. 'RCS 채팅'을 찾을 수 없다면 채팅 기능을 탭합니다.
상태 값을 찾습니다.

상태가 연결됨인 경우 기기에서 RCS가 활성 상태입니다.

다음 단계

RCS가 기기에서 활성화되어 있으면 테스터 요청을 전송할 준비가 된 것입니다. 기기에서 RCS가 비활성 상태인 경우 RBM 에이전트로 RBM 테스트를 시작하기 전에 기기에서 RCS를 사용 설정해야 합니다.

기기에서 RCS 사용 설정

Android 기기에서 RCS를 사용 설정하려면 메시지 앱에서 RCS 채팅을 사용 설정하세요.

다음 단계

RCS가 기기에서 활성화되면 테스터 요청을 전송할 수 있습니다.

테스터 요청 보내기

RCS 지원 기기를 테스터로 초대하려면 테스터 요청을 보냅니다. 기기에서 요청을 수락하면 에이전트가 메시지, 이벤트, 요청을 기기로 전송할 수 있습니다.

기기가 RCS를 지원하지 않거나, 테스터 요청에 응답하지 않거나, 요청을 거부하면 에이전트는 기기와의 통신을 시도할 때 403 PERMISSION_DENIED 오류가 발생합니다.

옵션 1: 비즈니스 커뮤니케이션 개발자 콘솔을 사용하여 테스터 요청 보내기

비즈니스 커뮤니케이션 개발자 콘솔을 열고 RBM Google 계정으로 로그인한 후 에이전트를 클릭합니다.
왼쪽 탐색 메뉴에서 기기를 클릭합니다.
테스트 기기 추가에서 기기의 전화번호를 입력하고 추가를 클릭합니다.

테스트 기기 목록에는 에이전트 테스트를 위해 초대한 각 기기의 테스터 요청 상태가 자세히 설명되어 있습니다.

옵션 2: RBM API로 테스터 요청 보내기

다음 코드는 테스터 요청을 보냅니다. 형식 지정 및 값 옵션은 phones.testers을 참고하세요.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('../libs/rbm_api_helper');

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

이 코드는 RBM 샘플 에이전트에서 발췌한 것입니다.

Java

import com.google.rbm.samples.lib.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 샘플 에이전트에서 발췌한 것입니다.

다음 단계

기기가 테스터 요청을 수락하면 에이전트에 지정된 테스트 기기입니다. 기기에 메시지, 이벤트, 기능 확인을 전송하여 에이전트의 기능과 워크플로를 테스트할 수 있습니다.

테스트 기기 삭제

테스트 기기를 삭제하면 기기가 실행되지 않는 에이전트에서 메시지를 더 이상 수신할 수 없습니다. RBM 플랫폼은 에이전트가 전송했거나 테스트 기기에 저장된 메시지를 삭제하지 않습니다.

비즈니스 커뮤니케이션 개발자 콘솔을 열고 RBM Google 계정으로 로그인한 후 에이전트를 클릭합니다.
왼쪽 탐색 메뉴에서 기기를 클릭합니다.
테스트 기기 목록에서 기기를 찾고 목록 항목의 메뉴를 클릭합니다.
기기 삭제를 클릭합니다.