웹훅 트리거: Universal Webhook은 어떻게 작동하나요?
웹훅 트리거 Universal Webhook은 활성화된 HTTP 메서드로 요청이 운영 엔드포인트에 도착하면 AI Flowi Workflow 플로를 시작합니다. GET, POST, PUT, PATCH, DELETE의 다섯 가지 메서드를 지원합니다. Request Data는 정규화된 JSON 출력이며, 테스트 엔드포인트는 플로를 실행하지 않고 요청을 캡처합니다. 상용 연동 개요를 참고하세요.
작성: Ai Flowi · 기술 검토: Janice Lee, 기술 지원, Ai Flowi.
게시일 · 수정일
웹훅이란 무엇인가요?
웹훅은 다른 시스템이 워크플로를 시작하는 엔드포인트로 요청을 보낼 수 있게 합니다. Universal Webhook에서는 운영 엔드포인트가 설정된 플로를 실행하고 수신 요청을 후속 컴포넌트용 JSON 데이터로 변환합니다. 반면 테스트 엔드포인트는 플로를 실행하지 않고 검토할 요청을 캡처합니다. 수신 요청을 전체 워크플로 설계 안에서 이해하려면 이벤트 기반 아키텍처 개요를 읽어보세요.
웹훅에 어떻게 연결하나요?
허용할 HTTP 메서드, 인증, 응답 모드를 설정한 다음, 발신자가 해당 메서드로 생성된 운영 엔드포인트를 호출하도록 하세요. Platform API Key는 플랫폼의 웹훅 인증 정책을 사용하며, External Provider는 플로에서 검증을 설정해야 합니다. 워크플로를 실행하지 않고 요청을 캡처하고 점검하려면 테스트 엔드포인트를 사용하세요.
허용되는 요청
| 설정 또는 출력 | 문서화된 동작 |
|---|---|
| HTTP Methods | GET, POST, PUT, PATCH, DELETE 중 하나 이상을 선택합니다. |
| Request Data | 정규화된 JSON 출력에는 쿼리 매개변수, 헤더, JSON 또는 폼 본문, 원시 본문, 업로드된 파일, 요청 메타데이터가 포함될 수 있습니다. |
| Production Endpoint | 설정된 플로를 실행할 요청을 받도록 생성된 엔드포인트입니다. |
| Test Endpoint | 요청을 캡처하여 Fetch Latest Payload로 가져올 수 있게 합니다. 플로는 실행하지 않습니다. |
합성 요청은 JSON 검증기로 확인하세요. 구문 검사는 필드 검증이나 인증을 대신하지 않습니다.
특정 작업에 맞는 시작 예제가 필요하면 웹훅 입력 검증기를 살펴보고, 데이터 유형에 맞춘 컴포넌트 연결과 설정, 명시된 테스트 범위를 검토하세요.
엔드포인트 공유 전 인증 설정
운영 엔드포인트를 공유하기 전에 Authentication을 선택하세요. Platform API Key는 플랫폼의 웹훅 인증 정책을 유지하므로, 발신자는 해당 정책에서 요구하는 플랫폼 API 키를 제공해야 합니다. External Provider는 플랫폼 API 키 없이 요청을 통과시켜 플로에서 제공업체별 검증을 수행할 수 있게 합니다. External Provider를 선택하면 엔드포인트를 공유하기 전에 플로에서 해당 검증을 설정하세요. 이 설정만으로는 발신자를 검증하지 않습니다. 컴포넌트 참조 문서에는 키 헤더나 전송 형식이 명시되어 있지 않으므로, 발신자 설정에는 플랫폼에 구성된 API 키 지침을 사용하세요.
테스트 엔드포인트에서는 플로 실행이 필요하지 않은 경우 설정된 응답을 미리 볼 수 있습니다. Fetch Latest Payload로 두 엔드포인트 중 어느 쪽이든 가장 최근에 받은 요청을 가져올 수 있습니다. Request Data를 후속 컴포넌트에 연결하기 전에 캡처된 값을 점검하세요. 웹훅에서 Google Sheets로 연결하는 튜토리얼에서는 문서화된 후속 처리 경로를 보여줍니다.
응답 모드
응답 모드는 허용된 각 메서드마다 설정합니다. Immediate는 플로가 백그라운드에서 실행되는 동안 해당 메서드에 설정된 응답을 반환합니다. After Execution은 플로가 끝날 때까지 기다린 다음 설정된 응답을 반환합니다. From Flow는 플로 실행을 기다린 뒤 하나의 Webhook Response 컴포넌트에서 응답을 가져옵니다. 마지막 모드에서는 적용 가능한 응답 컴포넌트가 정확히 하나 있는지 확인하세요.
호출자가 HTTP 405를 받으면 해당 메서드가 활성화되어 있고 위에 문서화된 메서드에 포함되는지 확인하세요. From Flow 응답을 결정할 수 없으면 응답 컴포넌트 수를 확인하세요. 관련 점검 사항은 웹훅 문제 해결을 참고하세요. 호출자의 응답을 해석하려면 메서드 설정을 조사하기 전에 HTTP 상태 코드 참조를 확인하세요.