이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Business Messages에 등록

Business Messages의 파트너로 등록하면 에이전트를 만들어 사용자와 브랜드 간의 대화(웹사이트 지원 및 브랜드 위치와 같은 비즈니스 기능을 나타내는 대화 항목)를 사용 설정할 수 있습니다.

사용자가 Google 검색 또는 Google 지도에서 관리하는 브랜드를 사용자가 검색하면 검색결과에 채팅 옵션이 표시됩니다. 사용자가 채팅을 클릭하면 브랜드 에이전트에 메시지를 보낼 수 있습니다. 에이전트를 사용하면 사용자의 메시지를 수신하고 응답할 수 있습니다.

파트너 등록

Business Messages의 파트너로 등록하고, 브랜드를 위한 에이전트를 만들고, 에이전트를 구동하는 API를 활용하여 고객 서비스, 영업, 기타 비즈니스 애플리케이션에 메시징 환경을 사용할 수 있습니다.

비즈니스 커뮤니케이션 개발자 콘솔을 엽니다.
비즈니스 메시지에서 파트너 계정 만들기를 클릭합니다.
파트너 정보 값을 입력하세요.

필드 값

이름 성명

파트너 이름 조직 이름

파트너 웹사이트 조직 웹사이트

리전 Business Messages 서비스를 호스팅할 리전

필드	값
이름	성명
파트너 이름	조직 이름
파트너 웹사이트	조직 웹사이트
리전	Business Messages 서비스를 호스팅할 리전

Business Messages 서비스 약관을 검토하고 이에 동의합니다.
만들기를 클릭합니다.

이제 Business Messages 파트너로 등록되었으며 Business Messages 및 Business Communications API에 액세스할 수 있습니다. Business Communications API는 사용자에게 메시지를 보내고 Business Communications API는 에이전트를 관리합니다.

서비스 계정 만들기

Business Messages 및 Business Communications API에 대한 API 호출을 안전하게 인증하려면 서비스 계정 키와 OAuth2l 명령줄 도구가 필요합니다.

비즈니스 커뮤니케이션 개발자 콘솔 홈페이지에서 파트너 계정 설정을 클릭합니다.
왼쪽 탐색 메뉴에서 서비스 계정을 클릭합니다.
키 만들기를 클릭한 다음 만들기를 클릭합니다.

브라우저에서 서비스 계정 키를 다운로드합니다. 서비스 계정 키를 안전한 비공개 위치에 저장하세요. 키를 공개적으로 공유하지 마세요. 나중에 Business Message API 및 Business Communication API에 액세스하려면 이 키가 필요합니다.

웹북 설정

이제 Business Messages 및 Business Communications API가 사용 설정되었으므로 메시지 수신을 시작하려면 웹훅 URL을 지정해야 합니다.

비즈니스 커뮤니케이션 개발자 콘솔에서 계정 설정을 엽니다.
올바른 파트너 계정이 선택되었는지 확인합니다.
Business Messages 웹훅 URL에서 구성을 클릭합니다.
웹훅 엔드포인트 URL에 'https://'로 시작하는 웹훅 URL을 입력합니다.
clientToken 값을 기록해 둡니다. 수신한 메시지가 Google에서 보낸 것인지 확인하는 데 필요합니다.
지정된 clientToken 매개변수와 함께 POST 요청을 수락하도록 웹훅을 구성하고 secret 매개변수의 일반 텍스트 값을 응답 본문으로 사용하여 200 OK 응답을 전송합니다.

예를 들어 웹훅이 다음 본문 콘텐츠와 함께 POST 요청을 수신하는 경우
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
웹훅에서 clientToken 값을 확인하고 clientToken이 올바르면 0123456789를 응답 본문으로 사용하여 200 OK 응답을 반환합니다.
콘솔에서 확인을 클릭합니다.

Business Messages가 웹훅을 확인하면 대화상자가 닫힙니다.

Business Communication API로 웹훅을 구성하는 방법을 보려면 예: 웹훅 URL 업데이트를 참조하세요.

파트너 정보 보기

현재 파트너 정보를 가져오려면 파트너 ID로 Business Communications API를 쿼리할 수 있습니다.

다음 명령어를 실행합니다. PARTNER_ID를 파트너 ID로 바꿉니다.


# This code gets the partner.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get

# Replace the __PARTNER_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"get-partner.sh

파트너 정보 업데이트

파트너 정보를 업데이트하려면 비즈니스 커뮤니케이션 개발자 콘솔의 계정 설정 페이지를 사용하거나 다음 명령어를 실행하세요.

PARTNER_ID를 파트너 ID로 바꾸고(파트너 ID는 비즈니스 커뮤니케이션 개발자 콘솔에서 확인할 수 있음) UPDATED_FIELDS를 업데이트하는 필드 이름으로 바꿉니다.


# This code updates the partner entity.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/patch

# Replace the __PARTNER_ID__, __UPDATED_FIELDS__, __FIELD_NAME__, __FIELD_VALUE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__?updateMask=__UPDATED_FIELDS__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "__FIELD_NAME__": "__FIELD_VALUE__"
}'update-partner.sh

형식 지정 및 값 옵션은 partners.patch를 참고하세요.

예: 표시 이름 업데이트

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/12345/partners/67890?updateMask=displayName" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
    'displayName': 'XYZ Messaging',
}"

예: 웹훅 URL 업데이트

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/12345?updateMask=productCapabilities" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
  'productCapabilities': [
    {
      'product': 'BUSINESS_MESSAGES',
      'businessMessagesCapability': {
        'webhookUrl': 'https://xyz.messaging.com/webhook',
      },
    },
  ],
}"

다음 단계

이제 등록 파트너이고 API를 사용 설정했으므로 Business Messages를 사용한 개발을 시작할 수 있습니다. 빠르게 시작하려면 첫 번째 에이전트 만들기를 참조하세요.

그렇지 않으면 대화에서 브랜드를 나타내는 에이전트를 만들고 사용자로부터 메시지를 수신하도록 웹훅을 구성하는 방법을 알아보세요.