Webhooks (Orchestrator)

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

웹후크는 채팅 클라이언트나 다른 외부 API 등 외부 서비스에 이벤트를 알려줘. 웹후크는 특정 이벤트가 발생할 때 URL을 설정할 수 있어.

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

수신 웹후크

사용자는 외부 이벤트로부터 수신 웹후크에 대한 새로운 트리거를 생성할 수 있고, 시스템은 제3자 웹후크 설정을 위한 API 키와 함께 고유한 웹후크 URL을 자동으로 생성해. 생성된 웹후크 URL은 고유하고 사용자의 계정과 워크플로에 직접 연결되어 있어서, 각 웹후크는 하나의 워크플로에만 연결돼.

수신 웹후크 구성

수신 웹후크를 구성하려면 다음 단계를 따라:

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

트리거가 워크플로에 나타나.
트리거를 클릭하여 Overview 탭을 엽니다.
Webhook 탭을 선택합니다.
1. Webhook URL 복사
  
  이 URL은 비밀로 간주돼야 하고 공유하면 안 돼. 우연히 공유됐다면, Regenerate을 클릭해서 새로 만들고 기존 걸 무효화해.
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를 클릭합니다.