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

웹훅 설정

웹훅은 파트너가 만든 HTTPS 콜백으로, 에이전트가 메시지와 이벤트에 응답하는 방식을 지정합니다. Dialogflow와 같은 사전 빌드된 자동 솔루션을 사용하지 않는 경우 커스텀 웹훅을 설정하여 에이전트의 동작을 정의해야 합니다.

파트너 수준 및 에이전트 수준 웹훅

파트너 수준 또는 에이전트 수준에서 웹훅을 설정할 수 있습니다. 파트너 수준 웹훅은 유지관리하는 모든 에이전트에 적용되지만, 에이전트 수준 웹훅은 각각 하나의 개별 에이전트에 적용됩니다.

고유한 동작으로 여러 에이전트를 운영하는 경우 에이전트 수준 설정을 사용하여 에이전트마다 다른 웹훅을 설정하는 것이 좋습니다. 반면 에이전트가 비슷한 동작을 하거나 에이전트가 하나만 있는 경우에는 파트너 수준 웹훅을 사용할 수 있습니다.

파트너 수준 웹훅과 에이전트 수준 웹훅이 모두 구성된 경우 에이전트 수준 웹훅이 특정 에이전트보다 우선하고 파트너 수준 웹훅이 에이전트 수준 웹훅이 없는 에이전트에 적용됩니다.

파트너 수준 웹훅을 설정하려면 다음 단계를 따르세요.

비즈니스 커뮤니케이션 개발자 콘솔을 열고 Business Messages Google 계정으로 로그인합니다.
계정 설정을 엽니다.
올바른 파트너 계정이 선택되었는지 확인합니다.
Business Messages 웹훅 URL에서 구성을 클릭합니다.
웹훅 엔드포인트 URL에 애플리케이션의 URL과 '/callback/'을 입력합니다. 예를 들어 'https://PROJECT_ID.appspot.com/callback/'과 같은 형식일 수 있습니다.
clientToken 값을 기록해 둡니다. Google에서 보낸 메일인지 확인하는 데 필요합니다.
지정된 clientToken 매개변수를 사용하여 POST 요청을 수락하고 보안 비밀 매개변수의 일반 텍스트 값을 응답 본문으로 사용하여 200 OK 응답을 보내도록 웹훅을 구성합니다. 예를 들어 웹훅이 다음 본문 콘텐츠와 함께 POST 요청을 수신한다고 가정해 보겠습니다.
```
{
"clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
이 경우 웹훅이 clientToken 값을 확인하고 clientToken가 올바르면 0123456789를 응답 본문으로 사용하여 200 OK 응답을 반환합니다.
콘솔에서 확인을 클릭합니다. Business Messages가 웹훅을 확인하면 대화상자가 닫힙니다.

파트너 수준 웹훅에서 에이전트로 전송된 메시지를 수신합니다. 특정 에이전트의 메시지가 대신 다른 웹훅에 전달되도록 하려면 에이전트 수준 웹훅을 설정하면 됩니다.