첫 번째 에이전트 빌드

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

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

기본 요건

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

테스트 기기 설정

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

기기의 RCS 상태 확인하기

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

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

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

다음 단계

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

에이전트 설정

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

상담사의 리전 확인

RBM API는 비즈니스가 지역 및 비즈니스 요구사항을 준수할 수 있도록 세 가지 지역 엔드포인트를 지원합니다. RBM 상담사는 다음 세 지역 중 하나에 있을 수 있습니다.

  • 북미
  • 유럽
  • 아시아 태평양

상담사를 만들 때는 관련 규정, 요구사항, 최종 사용자와의 거리를 기준으로 리전을 선택하세요. 지역은 국가별로 다르지 않습니다. 상담사가 운영되는 지역을 식별합니다. Google은 이 정보를 사용하여 메시지 데이터를 저장할 위치와 메시지 트래픽을 적절하게 라우팅하는 방법을 결정합니다.

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

네트워크에서 RBM 콘텐츠를 승인하는 이동통신사는 이 결제 프레임워크를 사용하여 구독자에게 RBM 메시지를 전송하는 비용도 청구합니다.

  • 대화형 - 특정 기간 내에 여러 A2P 및 P2A 메시지로 구성된 대화에 대한 요금입니다.
  • 단일 메시지 - 리치 RBM 콘텐츠 (예: 리치 카드 또는 캐러셀이 포함된 메시지)가 포함된 단일 메시지에 대한 요금입니다.
  • 기본 메시지 - 최대 160자(영문 기준)의 일반 텍스트 메시지에 대한 요금입니다.

상담사를 만들 때 상담사 로직의 동작과 가장 일치하는 결제 카테고리를 선택합니다.

  • 대화형 - 이 에이전트는 메시지가 양방향으로 교환되는 복잡한 사용자 상호작용에 참여합니다.

다음 두 카테고리는 결코 대화형 결제 이벤트를 생성하지 않습니다. 이동통신사는 전송되는 콘텐츠에 따라 각 메시지에 대해 기본 메시지 또는 단일 메시지 가격을 청구합니다.

  • 단일 메시지 - 이 상담사는 일반적으로 서식 있는 메시지를 보내고 답장을 받기를 거의 기대하지 않습니다.
  • 기본 메시지 - 이 상담사는 SMS 업그레이드를 RBM으로 구현하며 답장을 받지 않는 경우가 많습니다. 일반적으로 상담사는 최대 160자(영문 기준)의 일반 텍스트 메시지를 전송해야 합니다. 하지만 상담사는 제한되지 않습니다. 프로그래밍된 경우 더 풍부한 콘텐츠를 전송할 수 있으며 이에 따라 요금이 청구됩니다.

에이전트를 출시하기 전에 에이전트의 결제 카테고리를 변경할 수 있습니다. 다른 결제 카테고리로 변경하는 방법을 알아보려면 Google에 문의하세요.

상담사의 사용 사례 파악

각 RBM 상담사는 최종 사용자와의 대화의 성격을 반영하고 비즈니스가 비즈니스 규칙을 준수하는 데 도움이 되는 사전 정의된 사용 사례를 보유해야 합니다. RBM은 다음과 같은 네 가지 사용 사례를 지원합니다.

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

각 사용 사례를 사용해야 하는 시점에 관한 자세한 설명은 적절한 사용 사례 선택을 참고하세요.

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

에이전트 만들기

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

  1. Business Communications Developer Console을 열고 RBM 파트너 Google 계정으로 로그인합니다.
  2. 에이전트 만들기를 클릭합니다.
  3. 상담사 유형에서 RCS 비즈니스 메시지를 선택합니다.
  4. 브랜드에서 상담사가 대리할 브랜드를 선택하거나 새 브랜드 추가를 클릭하고 브랜드 이름을 입력합니다.
  5. 상담사 이름을 입력하고 상담사 리전, 결제 카테고리, 사용 사례를 선택합니다. 그런 다음 에이전트 만들기를 클릭합니다.
  6. 상담사가 지원 가능한 경우 상담사 이름을 클릭합니다.

상담사가 지원을 시작하면 비즈니스 및 브랜딩 정보를 추가할 수 있습니다. 상담사를 참고하세요.

테스트 기기 초대

이제 에이전트가 생성되었고 테스트 기기에 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의 권장사항을 검토하고 에이전트가 메시지를 전송하고 수신하는 방법을 알아봅니다.

이전
파트너 계정 설정