메시지를 처리하기 전에 호출 작성

사전 메시지 웹훅은 고객이 입력을 제출할 때마다 외부 서비스나 애플리케이션을 호출합니다. 어시스턴트가 메시지를 처리하기 전에 외부 서비스에서 메시지를 처리할 수 있습니다.

어시스턴트가 수신 메시지를 처리하기 전에 웹훅이 트리거되도록 하려면 어시스턴트에 사전 메시지 웹훅을 추가하세요.

사용자 지정 채널을 사용하는 경우, 사전 메시지 웹훅은 상태 비저장 및 상태 저장 방식의 /message API 버전 2에서만 작동합니다. 자세한 정보는 API 참조를 참조하십시오. 모든 기본 제공 채널 통합은 이 API를 사용합니다.

다음과 같은 사용 사례에 사전 메시지 웹훅을 사용할 수 있습니다:

고객의 입력을 어시스턴트가 사용하는 언어로 번역합니다.
고객이 제출할 수 있는 이메일 주소 또는 주민등록번호와 같은 개인 식별 정보를 확인하고 제거하십시오.

이 웹훅을 메시지 후 웹훅과 함께 사용할 수 있습니다. 예를 들어 메시지 후 웹훅은 응답을 고객의 언어로 다시 번역하거나 개인정보 보호를 위해 삭제된 정보를 다시 추가하는 등의 작업을 수행할 수 있습니다. 자세한 정보는 메시지를 처리한 후 호출 작성의 내용을 참조하십시오.

개인 엔드포인트가 사용 중인 환경의 경우 웹훅이 인터넷을 통해 트래픽을 전송함을 기억하십시오.

대화 중에 필요할 때 일회성 작업을 수행해야 하는 경우 대화 웹훅을 사용하세요. 예를 들어 어시스턴트가 계정 번호, 사용자 ID, 계정 비밀번호 등 필요한 모든 세부 정보를 수집하면 조건이 충족됩니다. 자세한 정보는 대화 노드에서 프로그래밍 방식 호출 작성을 참조하십시오.

웹훅 정의

모든 수신 메시지를 사전 처리하는 데 사용할 하나의 웹훅 URL을 정의할 수 있습니다.

시작하기 전에

외부 서비스에 대한 프로그래밍 방식의 호출은 다음 요구 사항을 충족해야 합니다:

어시스턴트가 배치되어 고객과 상호작용하는 프로덕션 환경에서 웹훅을 설정하고 테스트하지 마십시오.
호출은 POST HTTP 요청이어야 합니다.
요청 본문은 JSON 오브젝트(Content-Type: application/json)여야 합니다.
호출은 30초 이내에 답해야 합니다.

외부 서비스가 GET 요청만 지원하거나 런타임에 URL 매개변수를 동적으로 지정해야 하는 경우 런타임 값이 포함된 JSON 페이로드가 포함된 POST 요청을 수락하는 중간 서비스를 만드는 것을 고려해 보세요. 그러면 중간 서비스가 대상 서비스에 대한 요청을 작성하고 이 값을 URL 매개변수로 전달한 다음 대화 상자에 응답을 리턴할 수 있습니다.

배포 방법 선택

사전 메시지 웹훅을 설정하는 올바른 단계를 보려면 사용하는 배포 방법을 선택합니다.

사용 중인 배포 유형을 확인하려면 관리 메뉴 클릭합니다. 클래식 환경으로 전환이 표시되면 새 환경을 사용하고 있는 것입니다. 새 환경으로 전환이 표시되면 클래식 환경을 사용하고 있는 것입니다.

다음 링크를 참조하여 배포 유형에 따른 절차에 대해 알아보세요: