메시지를 처리하기 전에 호출 작성
사전 메시지 웹훅은 고객이 입력을 제출할 때마다 외부 서비스나 애플리케이션에 전화를 겁니다. 어시스턴트가 메시지를 처리하기 전에 외부 서비스에서 메시지를 처리할 수 있습니다.
보조 프로그램이 수신 메시지를 처리하기 전에 웹훅이 트리거되기를 원한다면, 사전 메시지 웹훅을 보조 프로그램에 추가하십시오.
다음과 같은 사용 사례에 사전 메시지 웹훅을 사용할 수 있습니다:
고객의 입력을 어시스턴트가 사용하는 언어로 번역합니다.
고객이 제출할 수 있는 이메일 주소 또는 주민등록번호와 같은 개인 식별 정보를 확인하고 제거하십시오.
이 웹훅을 포스트 메시지 웹훅과 함께 사용할 수 있습니다. 예를 들어, 메시지 후속 조치 웹훅은 응답을 고객의 언어로 다시 번역하거나, 개인정보 보호를 위해 제거된 정보를 다시 추가하는 등의 작업을 수행할 수 있습니다. 자세한 정보는 메시지를 처리한 후 호출 작성의 내용을 참조하십시오.
참고: 사설 엔드포인트를 사용하는 환경에서는 웹훅이 인터넷을 통해 트래픽을 전송한다는 점을 유의하십시오.
대화 중에 필요할 때 일회성 작업을 수행해야 하는 경우 대화 웹훅을 사용하세요. 예를 들어 어시스턴트가 계정 번호, 사용자 ID, 계정 비밀번호 등 필요한 모든 세부 정보를 수집하면 조건이 충족됩니다. 자세한 내용은 ‘대화 상자에서 프로그래밍 방식으로 호출하기’를 참조하세요.
웹훅 정의
모든 수신 메시지를 사전 처리하는 데 사용할 하나의 웹훅 URL을 정의할 수 있습니다.
시작하기 전에
외부 서비스에 대한 프로그래밍 방식의 호출은 다음 요구 사항을 충족해야 합니다:
어시스턴트가 배치되어 고객과 상호작용하는 프로덕션 환경에서 웹훅을 설정하고 테스트하지 마십시오.
호출은 POST HTTP 요청이어야 합니다.
요청 본문은 JSON 오브젝트(
Content-Type: application/json)여야 합니다.호출은 30초 이내에 답해야 합니다.
참고: 외부 서비스가 GET 요청만 지원하는 경우, 또는 실행 시점에 URL 매개변수를 동적으로 지정해야 하는 경우, 실행 시점의 값을 포함하는 JSON 페이로드를 가진 POST 요청을 수신하는 중계 서비스를 구축하는 것을 고려해 보십시오. 그러면 중간 서비스가 대상 서비스에 대한 요청을 작성하고 이 값을 URL 매개변수로 전달한 다음 대화 상자에 응답을 리턴할 수 있습니다.
배포 방법 선택
메시지 후 웹훅을 설정하는 올바른 단계를 보려면 사용하는 배포 방법을 선택합니다.
현재 사용 중인 배포 유형을 확인하려면 ‘관리’ 메뉴를 클릭하세요 
. 클래식 환경으로 전환이 표시되면 새 환경을 사용하고 있는 것입니다. 새 환경으로 전환이 표시되면 클래식 환경을 사용하고 있는 것입니다.
참고: 배포 유형은 watsonx Orchestrate 에는 적용되지 않습니다.
다음 링크를 참조하여 배포 유형에 따른 절차에 대해 알아보세요: