웹 후크 (오케스트레이터)

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

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

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

수신 웹 후크

사용자는 시스템이 제3자 웹 후크 설정을 위한 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 요청을 보내십시오. 구성된 스키마가 없는 워크플로의 경우 본문은 비어 있어야 합니다. 구성된 스키마가 적용된 경우 페이로드는 스키마와 일치해야 합니다.

발신 웹 후크

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

다른 서비스의 웹 후크는 Send HTTP Request 작업을 통해 트리거할 수 있습니다.

발신 웹 후크 구성

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

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