웹 후크 (Orchestrator)

컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

웹 후크는 채팅 클라이언트나 기타 외부 API와 같은 외부 서비스에 이벤트를 알립니다. 웹 후크는 특정 이벤트가 발생할 때 URL을 설정할 수 있습니다.

Phrase Orchestrator는 타사 시스템의 알림을 모니터링하고 처리하는 서비스를 제공합니다. 이 서비스는 사용자가 HTTP 요청을 지원하는 다양한 외부 시스템과 워크플로를 연결할 수 있도록 합니다.

수신 웹 후크

사용자는 외부 이벤트로부터 수신되는 웹 후크에 대한 새 트리거를 생성할 수 있으며, 시스템은 타사 웹 후크 설정에 필요한 API 키가 포함된 고유한 웹 후크 URL을 자동으로 생성합니다. 생성된 웹 후크 URL은 고유하며 사용자의 계정 및 워크플로와 직접 연결되므로, 각 웹 후크는 하나의 워크플로에만 연결됩니다.

수신 웹 후크 구성

웹 후크를 설정하려면 다음 단계를 따르십시오:

Webhook 트리거를 워크플로로 드래그 앤 드롭합니다.

트리거가 워크플로에 나타납니다.
트리거를 클릭하여 Overview 탭을 엽니다.
Webhook 탭을 선택합니다.
1. Webhook URL 복사
  
  이 URL은 비밀로 간주되어야 하며 공유해서는 안 됩니다. 실수로 공유한 경우 Regenerate를 클릭하여 새 URL을 생성하고 기존 URL을 무효화하십시오.
2. 워크플로 내에서 사용할 데이터가 포함된 페이로드를 보내려면 해당 페이로드의 스키마를 제공하십시오.
  1. 스키마를 제공하려면 Edit webhook을 클릭합니다.
  2. Input Type 선택:
    
    JSON Schemas은 JSON 페이로드를 정의하기 위한 표준입니다. 이를 사용하는 기존 서비스가 있거나 Orchestrator에 연결할 외부 서비스가 제공하는 경우 그대로 복사하십시오.
    - JSON
      
      더 간단한 설정을 위해 샘플 JSON 페이로드를 제공하여 정확한 규칙을 정의하지 않고도 웹 후크를 테스트할 수 있습니다.
    - JSON Schema
      
      JSON 데이터에 대한 구조, 데이터 유형 및 유효성 검사 규칙을 정확하게 정의하십시오.
  3. Save payload schema를 클릭합니다.
    
    웹 후크 트리거에 대한 예상 데이터 구조의 미리 보기가 표시됩니다.
3. 필요한 경우 Filters 탭을 열어 트리거에 필터를 추가하십시오.

워크플로가 게시된 후 이를 트리거하려면 웹 후크 URL로 POST 요청을 보내십시오. 구성된 스키마가 없는 워크플로의 경우 본문은 비어 있음 상태여야 합니다. 구성된 스키마가 적용된 경우 페이로드는 스키마와 일치 항목이어야 합니다.

발신 웹 후크

사용자는 데이터를 수신할 뿐만 아니라 외부 시스템으로 업데이트를 자동으로 전송하는 워크플로를 설정할 수 있습니다. 발신 웹 후크 작업을 통해 사용자는 외부 시스템에서 특정 작업을 자동으로 트리거할 수 있습니다.

다른 서비스의 웹 후크는 HTTP 요청 보내기 작업을 통해 트리거될 수 있습니다.

발신 웹 후크 설정

발신 웹 후크를 설정하려면 다음 단계를 따르십시오:

워크플로에 Send HTTP Request 작업을 드래그 앤 드롭합니다.
작업을 클릭하여 설정을 엽니다.
Parameters 탭을 선택하고 필요한 설정을 제공하십시오.
Save parameters를 클릭합니다.