테스트 기기 설정

에이전트를 출시하기 전에는 지정된 테스트 기기와만 통신할 수 있습니다. 이렇게 하면 최종 사용자의 실수로 인한 사전 액세스를 방지하기 위해 내부적으로 에이전트를 테스트할 수 있습니다.

RBM 에이전트와 통신하려면 테스트 기기에서 RCS를 사용 설정해야 합니다. 일부 Android 기기에서는 기본적으로 RCS가 사용 설정되어 있지 않습니다. 기기의 RCS 상태를 확인하려면 기기의 RCS 상태 확인하기를 참고하세요.

상담사는 하루에 최대 20개의 테스터 초대를 보낼 수 있으며 총 초대 한도는 200개입니다.

기기의 RCS 상태 확인하기

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

기기에서 RCS를 지원하지 않는 경우 메시지 및 Carrier Services 앱의 사전 출시 버전으로 기기를 구성하여 RCS를 사용 설정합니다.

기기에서 RCS를 지원하는 경우 테스터 초대를 보낼 수 있습니다. 기기가 초대를 수락하면 출시되지 않은 에이전트와 메시지를 주고받을 수 있습니다.

기기에서 RCS 사용 설정

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

기기에서 RCS가 활성화되면 테스터 초대를 보낼 수 있습니다.

테스터 초대 보내기

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

기기가 RCS 지원되지 않거나, 테스터 초대에 응답하지 않았거나, 초대를 거부한 경우 상담사가 기기와 통신하려고 하면 403 PERMISSION_DENIED 오류가 표시됩니다.

콘솔

비즈니스 커뮤니케이션 개발자 콘솔을 사용하여 테스터 초대를 보내려면 다음 단계를 따르세요.

  1. 비즈니스 커뮤니케이션 개발자 콘솔을 열고 RBM Google 계정으로 로그인한 후 에이전트를 클릭합니다.
  2. 왼쪽 메뉴에서 기기를 선택합니다.
  3. 국가 코드와 지역 번호를 포함한 기기의 전화번호를 입력하여 테스트 기기 목록에 테스트 기기를 추가합니다. 전화번호를 여러 개 추가하려면 쉼표로 구분하세요.

기기가 목록에 추가되면 초대장이 전송됩니다. 사용자의 기기에 초대 메시지가 표시되며, 사용자는 이를 수락하거나 거부할 수 있습니다.

테스트 기기 목록에는 에이전트 테스트에 초대한 각 기기의 테스터 초대 상태가 자세히 나와 있습니다.

API

RBM Management API로 테스터 초대를 보내려면 다음 단계를 따르세요.

  • 다음 코드를 사용합니다. 형식 지정 및 값 옵션은 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 샘플 에이전트에서 발췌한 것입니다.

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를 쿼리하여 기기의 초대 상태를 확인할 수 있습니다.

콘솔

비즈니스 커뮤니케이션 개발자 콘솔을 사용하여 테스트 기기의 초대 상태를 확인하려면 다음 단계를 따르세요.

  1. 비즈니스 커뮤니케이션 개발자 콘솔을 열고 RBM Google 계정으로 로그인한 후 에이전트를 클릭합니다.
  2. 왼쪽 메뉴에서 기기를 선택합니다.
  3. 국가 코드와 지역 번호를 포함한 기기의 전화번호를 입력하여 테스트 기기 목록에 테스트 기기를 추가합니다. 전화번호를 여러 개 추가하려면 쉼표로 구분하세요.

테스트 기기가 목록에 추가되면 상태 열에서 상태를 확인할 수 있습니다.

API

RBM Management API로 테스트 기기의 초대 상태를 가져오려면 다음을 실행하세요.

  • 다음 코드를 사용합니다. 형식 지정 및 값 옵션은 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`"

모든 테스트 기기의 상태 가져오기

테스터로 초대된 모든 기기의 초대 상태를 쿼리할 수 있습니다.

콘솔

비즈니스 커뮤니케이션 개발자 콘솔로 모든 테스트 기기의 초대 상태를 확인하려면 다음 단계를 따르세요.

  1. 비즈니스 커뮤니케이션 개발자 콘솔을 열고 RBM Google 계정으로 로그인한 후 에이전트를 클릭합니다.
  2. 왼쪽 메뉴에서 기기를 선택합니다.
  3. 국가 코드와 지역 번호를 포함한 기기의 전화번호를 입력하여 테스트 기기 목록에 테스트 기기를 추가합니다. 전화번호를 여러 개 추가하려면 쉼표로 구분하세요.

테스트 기기가 목록에 추가되면 상태 열에서 상태를 확인할 수 있습니다.

API

RBM 관리 API로 모든 테스트 기기의 초대 상태를 확인하려면 다음 단계를 따르세요.

  • 다음 코드를 사용합니다. 형식 지정 및 값 옵션은 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 개발자 콘솔을 사용하여 테스트 기기를 삭제하려면 다음 단계를 따르세요.

  1. 비즈니스 커뮤니케이션 개발자 콘솔을 열고 RBM Google 계정으로 로그인한 후 에이전트를 클릭합니다.
  2. 왼쪽 메뉴에서 기기를 선택합니다.
  3. 테스트 기기 목록에서 기기를 선택하고 메뉴를 클릭합니다.
  4. 기기 삭제를 클릭합니다.

API

RBM 관리 API로 테스트 기기를 삭제하려면 다음 단계를 따르세요.

  • 다음 코드를 사용합니다. 형식 지정 및 값 옵션은 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`"
이전
에이전트 정보 수정
다음
딥 링크