웹훅은 파트너가 생성한 HTTPS 콜백으로 에이전트의 작동 방식을 지정합니다. 메시지와 이벤트에 응답해야 합니다 사전 빌드된 자동화된 Dialogflow 같은 솔루션을 커스텀 웹훅을 설정하여 에이전트의 동작을 정의해야 합니다.
파트너 수준 및 에이전트 수준 웹훅
파트너 수준 또는 상담사 수준에서 웹훅을 설정할 수 있습니다. 파트너 수준 웹훅은 유지관리하는 모든 상담사에게 적용되지만 상담사 수준은 각각 하나의 개별 에이전트에 적용됩니다.
행동이 각기 다른 여러 상담사를 운영하는 경우 각 에이전트에 서로 다른 웹훅을 설정할 수 있습니다. 다른 한쪽에는 상담사의 행동이 비슷한 경우 또는 상담사가 한 명뿐인 경우 파트너 수준 웹훅을 사용할 수 있습니다
파트너 수준 웹훅과 에이전트 수준 웹훅을 모두 구성한 경우 에이전트 수준 웹훅이 특정 에이전트에 우선하는 반면 파트너 수준 웹훅은 상담사 수준이 없는 상담사에게 적용됩니다. 웹훅을 설정할 수도 있습니다
파트너 수준 웹훅 설정
파트너 수준 웹훅을 설정하려면 다음 단계를 따르세요.
- 비즈니스 커뮤니케이션 개발자 콘솔을 엽니다. Business Messages Google 계정으로 로그인합니다.
- 계정 설정을 엽니다.
- 올바른 파트너 계정을 선택했는지 확인합니다.
- Business Messages 웹훅 URL에서 구성을 클릭합니다.
- 웹훅 엔드포인트 URL에 애플리케이션의 URL과 '/callback/'을 함께 입력합니다. 예를 들어 'https://PROJECT_ID.appspot.com/callback/'과 같은 형태일 수 있습니다.
clientToken
값을 기록합니다. 이를 통해 받은 메시지가 Google에서 보낸 것인지 확인해야 합니다.지정된
clientToken
매개변수를 사용하고 일반 텍스트와 함께200 OK
응답을 전송합니다. 보안 비밀 매개변수의 값을 응답 본문으로 사용합니다. 예를 들어 웹훅은 다음 본문 콘텐츠가 포함된 POST 요청을 수신합니다.{ "clientToken":"SJENCPGJESMGUFPY", "secret":"0123456789" }
이 경우 웹훅은
clientToken
값을 확인해야 합니다.clientToken
이 올바르면0123456789
이 포함된200 OK
응답을 반환합니다. 응답 본문입니다.콘솔에서 확인을 클릭합니다. Business Messages에서 웹훅을 확인하면 대화상자가 닫힙니다
에이전트 수준 웹훅 설정
파트너 수준 웹훅에서 에이전트에 전송된 메시지를 수신합니다. 만약 특정 에이전트의 메시지가 다른 웹훅으로 전달되도록 하려면 에이전트 수준 웹훅을 설정할 수 있습니다
- 비즈니스 커뮤니케이션 개발자 콘솔을 엽니다. Business Messages Google 계정으로 로그인합니다.
- 에이전트를 클릭합니다.
- 통합을 클릭합니다.
- Webhook(웹훅)에서 Configure(구성)를 클릭합니다.
- 웹훅 엔드포인트 URL에 'https://'.
clientToken
값을 기록합니다. Google에서 보낸 메시지가 제대로 전송되었는지 Google에서 수신하는 사용자 수지정된
clientToken
매개변수를 생성하고 200 OK 응답을 보안 비밀 매개변수를 사용하세요. 예를 들어 웹훅이 POST 요청을 수신한다고 가정하겠습니다. 다음 본문 내용 포함:{ "clientToken":"SJENCPGJESMGUFPY", "secret":"0123456789" }
이 경우 웹훅은
clientToken
값을 확인해야 합니다.clientToken
이(가) 정답입니다. 보안 비밀 URL이 포함된200 OK
응답을 반환하세요. 매개변수를0123456789
로 설정합니다.콘솔에서 확인을 클릭합니다. Business Messages에서 웹훅을 확인하면 대화상자가 닫힙니다