실시간 이벤트에서 실시간으로 데이터를 캡처하고 사용자에게 표시하기 위해 메시지와 WebHook 이벤트를 구독하는 데 WebHook 노드를 사용할 수 있습니다. WebHook 노드를 사용하여 서버 측 유효성 검사, 비즈니스 로직 실행 또는 백엔드 서버 API 호출을 수행할 수 있습니다. 또한, Kore.ai SDK 도구 BotKit을 사용하여 WebHook 노드를 스크립트 노드에 연결하고 응답을 처리함으로써 필요에 따라 이벤트 핸들러를 추가하고 메시지와 WebHook 이벤트를 제어할 수 있습니다.

앱 생성 및 등록

WebHook 이벤트에 액세스하고 대화 작업에서 WebHook 노드를 사용하려면 봇의 배포 -> 통합 탭에서 앱을 구독하고 설정해야 합니다. 자세한 내용은 SDK 설정을 참조하세요.

1. 상단 메뉴에서 배포 탭을 선택합니다
2. 왼쪽 메뉴에서 통합 -> 상담사 전환을 클릭합니다.
3. 상담사 전환 페이지에서 앱 이름 드롭다운 목록 옆에 있는 추가를 클릭합니다.
4. 클라이언트 앱 생성 창에서 이름 필드에 앱 이름을 입력합니다. 예: SDK 앱.
5. 다음을 클릭합니다.
6. 클라이언트 ID 및 클라이언트 시크릿은 앱이 성공적으로 생성됨 메시지와 함께 생성됩니다.
7. 완료를 클릭합니다.
8. 콜백 URL 필드에 Kore.ai가 데이터를 푸시하기를 원하는 애플리케이션의 URL을 입력하세요. 예: https://koremessenger.com/postURL. 참고: 생성한 등록 앱은 봇의 모든 작업에 적용되는 콜백 URL을 기반으로 합니다. 각 작업은 고유한 SDK 설정을 가질 수 있지만, 콜백 URL은 동일합니다. 라이브 상담사 전환에 필요한 별도 애플리케이션 콜백 URL을 위한 별도 봇을 생성합니다.
9. PII 데이터 섹션에서 민감 정보를 처리하는 방법을 정의합니다. 상담사 세션이 진행 중일 때 마스킹되지 않은 데이터를 공유해야 하는 경우 PII 삭제를 사용함으로 설정되었을 때도 원본 데이터를 마스킹하지 않고 상담사 BotKit으로 전송을 선택합니다. 또는 민감 데이터를 마스킹하고 상담사 BotKit으로 전송의 기본 설정을 선택합니다.
10. 커넥터를 사용한 액세스 섹션에서 URL이 방화벽 뒤에 있는지 그리고 커넥터를 사용해야 하는지 여부를 지정합니다.
11. 저장을 클릭합니다. 성공적으로 구독됨 메시지가 표시됩니다.

설정

대화 작업에서 WebHook 노드를 설정하려면 다음 단계를 수행합니다. 참고: 플랫폼의 v9.0 이후에는 서비스 노드가 봇 조치 노드로 분류됩니다. 봇 조치 노드에 대해 자세히 알아보려면 여기를 클릭하세요.

노드 추가

1. Webhook 노드를 추가하려는 대화 작업을 엽니다.
2. 지정된 위치에 Webhook 노드를 추가합니다. 노드를 추가하는 단계의 경우, 여기를 참조하세요.
3. Webhook 창은 기본적으로 구성 요소 속성 탭이 선택되어 표시됩니다.
4. 연결 속성을 설정할 수 있습니다.자세한 내용은 여기를 참조하세요.

You can use the WebHook node to subscribe to a message and WebHook events to capture real-time data from real-time events and show them to the user. You can use the WebHook node for server-side validation, execute business logic, or make backend server API calls. Also, you can use the Kore.ai SDK Tool BotKit to add event handlers, control the messages and WebHook events as required by connecting the WebHook node to a script node to process the response.

Create and Register an App

To get access to WebHook events and use WebHook nodes in your dialog task, you need to subscribe and configure an app in the Deploy -> Integrations tab of your Bot. For more information, refer to SDK Configuration.

1. Select the Deploy tab from the top menu
2. On the left menu, click Integrations -> Agent Transfer.
3. On the Agent Transfer page, click Add next to the App Name drop-down list.
4. On the Create Client App window, enter the app name in the Name field. For example, SDK App.
5. Click Next.
6. The Client ID and Client Secret are generated along with the App Created Successfully message.
7. Click Done.
8. In the Callback URL field, enter the URL for your application that you want Kore.ai to push data to. For example, https://koremessenger.com/postURL.
   Note: The registration app you create is based on the Callback URL applicable to all tasks for the bot. While each task can have unique SDK configurations, the Callback URL is the same. Create separate bots for separate application Callback URLs for live agent transfers.
9. Under the PII Data section, define how sensitive information should be handled. If there is a need to share unmasked data when an agent session is in progress, even when PII redaction is enabled, select the Do not mask and send original data to Agent BotKit. Else, go with the default setting of Mask and send sensitive data to Agent BotKit.
10. Under the Access Using a Connector section, indicate if your URL is behind a firewall and a Connector has to be used.
11. Click Save. The Successfully subscribed message is displayed.

Set-Up

Setting up a Webhook node in a dialog task involves the following steps:

Note: Post v9.0 of the platform, the Service node is categorized under the Bot Action node. For details on the Bot Action node, click here.

Add Node

1. Open the dialog task to add the Webhook node.
2. Add Webhook node in the designated place. For steps in adding nodes, refer here.
3. The Webhook window is displayed with the Component Properties tab selected by default.
4. You can configure the Connection Properties, refer here for details.