첫 번째 에이전트 빌드

사용자는 기기에서 Google 메시지와 같은 RCS 지원 메시지 앱을 통해 상담사와 상호작용합니다. 이 빠른 시작에서는 테스트 기기에 간단한 메시지를 보내고 응답을 받을 수 있는 기본 RBM 에이전트를 만듭니다.

RBM 지원 대화를 통한 메시지 흐름

기본 요건

상담사를 시작하려면 다음 항목이 필요합니다.

테스트 기기 설정

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

기기의 RCS 상태 확인하기

  1. 메시지 앱에서 버튼을 탭한 다음 설정을 탭합니다.

  2. 채팅 기능을 탭하고 상태 값을 찾습니다.

    상태가 연결됨이면 기기에서 RCS가 활성화된 것입니다.

다음 단계

기기에서 RCS가 활성화되면 상담사를 설정할 수 있습니다. 기기에서 RCS가 비활성 상태인 경우 RBM 에이전트를 테스트하려면 먼저 기기에서 RCS를 사용 설정해야 합니다.

에이전트 설정

RBM 에이전트는 RBM API를 사용하여 메시지, 이벤트, 기타 요청을 사용자에게 전송합니다. 상담사를 만들 때 RBM API에 대한 액세스를 사용 설정하고 상담사의 기본 정보를 정의합니다.

상담사의 리전 확인

RBM 상담사는 북미, 유럽, 아시아 태평양의 세 지역 중 한 곳에 있을 수 있습니다. RBM API는 비즈니스가 지역 및 비즈니스 요구사항을 준수할 수 있도록 세 가지 지역 엔드포인트를 지원합니다.

상담사를 만들 때 관련 규정, 요구사항, 최종 사용자와의 거리를 기준으로 상담사의 지역을 선택하세요. 이 리전은 에이전트가 작동하는 위치와 데이터가 저장될 위치를 결정합니다.

나 또는 대상 사용자가 이러한 지역에 해당하지 않는 경우 지연 시간을 최소화하기 위해 가장 가까운 리전을 선택합니다. 예를 들면 다음과 같습니다.

  • 중남미에 거주하는 경우 북미 지역을 선택합니다.
  • 아프리카에 거주하는 경우 유럽 지역을 선택합니다.
  • 오스트레일리아에 거주하는 경우 아시아 태평양 지역을 선택합니다.

타겟 이동통신사를 기준으로 상담사의 지역을 결정하지 마세요. 모든 지역에서 전 세계 이동통신사에 동등하게 액세스할 수 있습니다.

상담사의 결제 카테고리 확인

RBM 에이전트를 만들 때는 에이전트가 사용자와 상호작용하는 방식에 따라 결제 카테고리를 지정해야 합니다. 상담사의 의도한 행동과 가장 일치하는 카테고리를 선택합니다.

  • 대화형: 사용자와 멀티턴 대화를 하는 상담사를 위한 기능입니다.
  • 기본 메시지 또는 단일 메시지: 잦은 답장을 기대하지 않고 메시지를 보내는 상담사를 위한 기능입니다.

에이전트를 출시하기 전에만 에이전트의 결제 카테고리를 변경할 수 있습니다. 출시 후 결제 카테고리를 변경해야 하는 경우 rbm-support@google.com으로 이메일을 보내세요.

RBM 결제 모델에 관한 자세한 내용은 RBM 결제 FAQ를 참고하세요.

상담사의 사용 사례 파악

각 RBM 상담사에는 사전 정의된 사용 사례가 있어야 합니다. 이렇게 하면 상담사를 분류하고 우수한 사용자 환경을 위해 적절한 비즈니스 규칙을 적용하는 데 도움이 됩니다. RBM은 다음과 같은 네 가지 사용 사례를 지원합니다.

  • OTP: 계정을 안전하게 인증하거나 거래를 확인하는 데 필요한 일회용 비밀번호입니다.
  • 거래: 의심스러운 계정 활동 알림, 구매 확인, 배송 알림 등 고객의 기존 서비스 또는 제품과 직접 관련된 정보를 공유하는 알림, 업데이트 또는 알림입니다.
  • 프로모션: 인지도, 참여도, 판매를 높이기 위해 신규 또는 기존 고객에게 판매, 마케팅, 프로모션 메시지를 전송합니다.
  • 다목적: 계정 알림을 보낸 후 할인 혜택을 제공하거나 새 제품 또는 서비스로 업그레이드하는 등 거래 메시지와 프로모션 메시지를 결합한 대화입니다.

사용 사례마다 전송할 수 있는 항목에 관한 규칙이 다릅니다. 각 사용 사례에 대해 자세히 알아보고 상담사에게 가장 적합한 사용 사례를 찾으려면 상담사에게 적합한 사용 사례 선택을 참고하세요.

출시를 위해 상담사를 제출한 후에는 사용 사례를 변경할 수 없습니다. 상담사를 제출하기 전에 거주 국가의 사용 사례 및 비즈니스 규칙을 확인하세요.

에이전트 만들기

Business Communications Developer Console에서 상담사를 만들려면 다음 안내를 따르세요.

에이전트를 만들려면 다음 안내를 따르세요.

  1. Business Communications Developer Console로 이동하여 RBM 파트너 Google 계정으로 로그인합니다.
  2. 홈페이지에서 + 상담사 만들기를 클릭합니다.
  3. 새 RCS 비즈니스 메시지 상담사 창에서 다음 정보를 지정합니다.
  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를 비즈니스 커뮤니케이션 개발자 콘솔의 상담사 정보 페이지에 있는 상담사 ID로 바꿉니다.
  • PATH_TO_SERVICE_ACCOUNT_KEY를 이전에 만든 키의 경로로 바꿉니다.

테스트 기기에서 상담사로부터 'Hello, world!' 메시지를 받게 됩니다. 테스트 기기에 메시지가 표시되지 않으면 명령어에 전화번호와 서비스 계정 키의 경로를 올바르게 입력하고 형식을 지정했는지 확인합니다.

추천 답장 및 리치 카드와 같은 다양한 유형의 메시지를 보내려면 메시지 보내기를 참고하세요.

다음 단계

이제 에이전트가 테스트 기기로 메시지를 보낼 수 있으므로 비즈니스 요구사항에 맞는 앱을 빌드할 차례입니다. 원하는 언어로 샘플 에이전트를 가져와 샘플의 리드미에 나온 안내를 따릅니다.

샘플 에이전트를 구성한 후 RBM의 권장사항을 검토하고 에이전트가 메시지를 전송하고 수신하는 방법을 알아봅니다.

이전
파트너 계정 설정