# 워크플로우 액션 - 웹훅(아웃바운드)
## 워크플로우 액션 - 웹훅(아웃바운드)
워크플로우 빌더에서 아웃바운드 웹훅 액션을 사용하는 방법을 알아보세요. HighLevel에서 외부 애플리케이션이나 서비스로 연락처 데이터(및 기타 정보)를 실시간으로 자동 전송하여 강력한 커스텀 연동을 구현하고 자동화 기능을 확장하는 방법을 알아보겠습니다.
***
**목차**
* [워크플로우 액션 웹훅이란?](#워크플로우-액션-웹훅이란)
* [아웃바운드 웹훅 사용의 주요 이점](#아웃바운드-웹훅-사용의-주요-이점)
* [웹훅 액션 설정 및 구성 방법](#웹훅-액션-설정-및-구성-방법)
* [웹훅 세부사항 구성](#웹훅-세부사항-구성)
* [커스텀 데이터 추가](#커스텀-데이터-추가)
* [웹훅 데이터(페이로드) 이해](#웹훅-데이터페이로드-이해)
* [테스트 및 라이브 전환](#테스트-및-라이브-전환)
* [데이터 형식 세부사항](#데이터-형식-세부사항)
* [자주 묻는 질문](#자주-묻는-질문)
***
## **워크플로우 액션 웹훅이란?**
워크플로우 액션 웹훅은 HighLevel에서 다른 소프트웨어 애플리케이션으로 정보를 자동으로 전송하는 강력한 메신저 역할을 하는 도구입니다. 이 기능을 통해 HighLevel을 웹 요청을 수신할 수 있는 거의 모든 외부 시스템과 연결할 수 있어, 커스텀 연동의 무한한 가능성을 열어줍니다.
아웃바운드 웹훅은 HighLevel 워크플로우에서 특정 대상 URL로 전송되는 자동화된 메시지입니다. 연락처가 워크플로우의 웹훅 단계에 도달하면, HighLevel이 해당 연락처와 트리거 이벤트에 대한 관련 데이터를 수집하여 "페이로드"로 패키징한 후 제공된 URL로 전송합니다. 이를 통해 HighLevel 외부의 다른 애플리케이션에서 작업을 트리거하거나, 데이터를 동기화하거나, 프로세스를 시작할 수 있습니다.
***
### **아웃바운드 웹훅 사용의 주요 이점**
웹훅은 복잡한 연동 과제를 해결하고 네이티브 연동만으로는 불가능한 고급 자동화 전략을 활용할 수 있게 해줍니다.
* **무제한 연동**: 수천 개의 서드파티 앱과 서비스(Zapier, Make, 커스텀 도구 등)에 연결하여 HighLevel 외부에서 작업을 트리거할 수 있습니다.
* **실시간 데이터 동기화**: 워크플로우에서 이벤트가 발생하는 즉시 외부 데이터베이스, 스프레드시트 또는 분석 플랫폼으로 데이터를 전송합니다.
* **커스터마이징된 자동화**: 다이렉트 메일 발송, 독점 CRM 업데이트, 외부 강의 플랫폼에 사용자 등록 등 다른 시스템에서 고유한 프로세스를 트리거합니다.
* **향상된 보고**: 워크플로우 및 연락처 데이터를 비즈니스 인텔리전스 도구로 전송하여 고급 커스텀 보고서와 대시보드를 구축합니다.
* **궁극적인 유연성**: 정확한 비즈니스 요구사항에 맞춘 맞춤형 솔루션을 생성하여 HighLevel 자동화의 성능을 확장합니다.
***
### **웹훅 액션 설정 및 구성 방법**
원하는 대상으로 데이터를 전송하도록 웹훅이 올바르게 설정되도록 다음 지침을 따르세요.
1. 로케이션의 메인 메뉴에서 **Automation(자동화)** 탭으로 이동하여 워크플로우 빌더로 이동합니다.
2. 새 워크플로우를 **생성**하거나 기존 워크플로우를 선택하여 **편집**합니다.
3. 워크플로우에 최소한 하나의 **트리거**가 구성되어 있는지 확인합니다(예: "연락처 태그 추가").
4. 액션을 추가하려는 워크플로우 캔버스의 위치에서 \*\*더하기 아이콘(+)\*\*을 클릭합니다. 화면 오른쪽에 액션 패널이 열립니다.
5. '액션' 패널 검색창에 `**webhook**`을 입력합니다.
6. 목록에서 **Webhook** 옵션을 선택합니다. 이렇게 하면 워크플로우에 단계가 추가되고 'Webhook' 구성 패널이 열립니다.
***
### **웹훅 세부사항 구성**
웹훅이 올바르게 작동하려면 적절한 구성이 중요합니다. 이 섹션에서는 웹훅 구성 패널의 각 필드를 설명하고, 올바른 장소에 올바른 정보로 데이터가 전송되도록 하는 방법을 안내합니다.
웹훅 액션을 추가하면 구성 패널이 나타납니다. 설정 방법은 다음과 같습니다:
* **Action Name(액션 이름):** 웹훅의 목적을 설명하는 이름을 지정합니다(예: "신규 리드 Slack으로 전송" 또는 "외부 DB 업데이트"). 이렇게 하면 나중에 워크플로우에서 단계를 쉽게 식별할 수 있습니다.
* **Method(메소드):** 요청에 대한 HTTP 메소드를 선택합니다. POST가 데이터 전송에 가장 일반적인 메소드이며 기본값으로 선택됩니다.
* **URL:** 데이터를 수신할 외부 서비스의 고유 URL을 입력합니다. 이는 가장 중요한 필드이므로 대상 서비스에서 올바르게 복사하여 붙여넣기했는지 확인하세요.
***
### **커스텀 데이터 추가**
웹훅 페이로드에 추가 커스텀 정보를 포함할 수 있습니다.
1. CUSTOM DATA 섹션 하단에서 **+ Add item(항목 추가)** 버튼을 클릭합니다.
2. \*\*Key(키)\*\*와 **Value(값)** 필드가 있는 새 행이 나타납니다.
3. **Key(키):** 전송하는 데이터 필드의 라벨입니다(예: `lead_source` 또는 `product_interest`). 공백 없는 단순한 텍스트 문자열이어야 합니다.
4. **Value(값):** 전송하려는 데이터입니다. 일반 텍스트를 사용하거나 커스텀 값을 사용하여 동적 데이터를 삽입할 수 있습니다(예: `{{contact.source}}` 또는 `{{custom_fields.product_id}}`).
모든 세부사항을 입력한 후, 패널 하단의 파란색 **Save Action(액션 저장)** 버튼을 클릭하여 구성을 저장합니다.
***
### **웹훅 데이터(페이로드) 이해**
"페이로드"라고 알려진 웹훅으로 전송되는 데이터에는 중요한 정보가 포함되어 있습니다. 기본적으로 포함되는 데이터와 워크플로우의 트리거가 받는 정보에 미치는 영향을 알아보겠습니다. 이는 외부 시스템에서 데이터를 올바르게 처리하는 데 필수적입니다.
#### **표준 데이터**
기본적으로 모든 웹훅은 워크플로우에 관련된 연락처에 대한 표준 정보 세트를 전송합니다. 여기에는 다음이 포함됩니다:
* 전체 이름, 이름, 성
* 이메일 및 전화번호
* 주소
* 태그
* 연락처와 관련된 모든 표준 및 커스텀 필드
포함된 모든 표준 필드의 전체 목록은 구성 패널에서 **standard data(표준 데이터)** 링크를 클릭하여 공식 문서를 확인하세요.
#### **트리거 종속 데이터**
웹훅 페이로드에는 워크플로우를 시작한 특정 트리거와 관련된 추가 데이터가 포함될 수 있습니다. 이는 이해해야 할 중요한 개념입니다.
* **예시:** 워크플로우 트리거가 "예약 완료"인 경우, 웹훅 페이로드에는 해당 특정 예약에 대한 세부사항(예: 시작 시간, 캘린더 ID, 예약 상태)도 포함됩니다.
* **중요사항:** 트리거가 특정 객체와 관련되지 않은 경우(예: "연락처 태그 추가" 트리거), 예약이나 기회 관리와 같은 다른 객체의 데이터는 페이로드에 **포함되지 않습니다**. 필요한 데이터를 얻으려면 올바른 트리거를 사용해야 합니다.
***
### **테스트 및 라이브 전환**
워크플로우를 활성화하기 전에 웹훅을 테스트하여 데이터가 올바르게 전송되는지 확인하는 것이 중요합니다. 이 섹션에서는 테스트 프로세스, 실행 로그에서 결과를 검토하는 방법, 마지막으로 워크플로우를 게시하는 방법을 안내합니다.
웹훅을 테스트하기 위해 여러 무료 사이트를 사용할 수 있습니다. 가 좋은 옵션입니다. "무료 웹훅 테스트"로 구글 검색해보세요.
1. 웹훅 액션을 **저장**한 후, 빌더 오른쪽 상단에서 **Test Workflow(워크플로우 테스트)** 버튼을 클릭합니다.
2. '연락처에 대한 테스트 실행' 패널이 열립니다. SELECT CONTACTS 드롭다운을 사용하여 시스템에서 **테스트 연락처**를 선택합니다.
3. 파란색 **Run Test(테스트 실행)** 버튼을 클릭합니다. 이렇게 하면 웹훅 액션 실행을 포함하여 해당 연락처에 대한 전체 워크플로우가 실행됩니다.
4. 테스트가 성공했는지 확인하려면 **Execution Logs(실행 로그)** 탭을 클릭합니다.
5. 테스트 연락처에 대한 로그 항목을 찾습니다. 실행됨 상태의 웹훅 액션이 표시되어야 합니다. 이는 HighLevel이 제공한 URL로 데이터를 성공적으로 전송했음을 확인해 줍니다.
6. 웹훅이 예상대로 작동하는 것을 확인했으면, 오른쪽 상단의 **Publish(발행)** 토글을 클릭하여 워크플로우를 라이브로 설정하고 실제 이벤트에 의해 트리거될 수 있도록 합니다.
***
### **데이터 형식 세부사항**
연락처 데이터와 하위 계정(로케이션) 객체 데이터는 기본적으로 사용할 수 있지만, 예약, 할 일 등과 같은 다른 관련 객체들은 워크플로우에 해당 트리거가 적용된 경우에만 포함됩니다.
예를 들어, 예약의 날짜와 시간은 워크플로우가 "예약 완료"와 같은 예약 참조를 입력 트리거로 가지고 있는 경우에만 검색할 수 있습니다. 마찬가지로 파이프라인의 다양한 기회의 기회 담당자는 워크플로우가 "파이프라인 변경"과 같은 기회 관리 트리거를 가지고 있는 경우에만 사용할 수 있습니다.
```json
{
// 연락처 표준 필드
first_name,
last_name,
full_name,
email,
phone,
tags,
address1,
city,
state,
country,
timezone,
date_created,
postal_code,
company_name,
website,
date_of_birth,
contact_source,
full_address,
contact_type,
gclid,
...
... 연락처 커스텀 필드
...
// 로케이션 데이터는 대부분 모든 웹훅에서 항상 존재, 키 필드: location
location: {
name,
address,
city,
state,
country,
postalCode,
fullAddress,
id
}
// 해당하는 경우 기회 관리, 루트 레벨에 추가
opportunity_name,
status,
lead_value,
opportunity_source,
source,
pipleline_stage, // 파이프라인 단계 이름
pipeline_id,
id,
pipeline_name,
// 해당하는 경우 캠페인, 필드 키: campaign
campaign: {
id,
name
},
// 해당하는 경우 사용자, 필드 키: user
user: {
firstName,
lastName,
email,
phone,
extension,
address1,
city,
state,
country,
postalCode
},
// 해당하는 경우 예약, 필드 키: calendar
calendar: {
id, // 캘린더 id
calendarName, // calendar.name,
title, // 예약 제목
selectedTimezone, // 로케이션 타임존 또는 'UTC'
appointmentId,
startTime: // selectedTimezone에 따른 시작시간 'YYYY-MM-DDTHH:mm:ss' 형식
endTime: // selectedTimezone에 따른 종료시간 'YYYY-MM-DDTHH:mm:ss' 형식
status,
appoinmentStatus,
address,
notes,
date_created,
created_by, // 사용자가 생성한 경우 사용자명
created_by_user_id // 사용자가 생성한 경우 사용자 id
created_by_meta: { // 내부 필드
source,
channel
},
last_updated_by_meta: { // 내부 필드
source,
channel
}
},
// 해당하는 경우 2단계 주문폼, 필드 키: order
order: {
... // 동적 데이터, 예시 데이터를 얻기 위해 테스트를 실행하세요
},
// 해당하는 경우 인보이스, 필드 키: invoice
invoice: {
... // 동적 데이터, 예시 데이터를 얻기 위해 테스트를 실행하세요
},
// 해당하는 경우 할 일, 필드 키: task
task: {
title,
body,
dueDate: // UTC 타임존으로 변환된 마감일 'YYYY-MM-DDTHH:mm:ss' 형식
}
// 해당하는 경우 노트, 필드 키: note
note: {
body
}
// 해당하는 경우 메시지, 필드 키: message
message: {
type,
body,
direction,
status
}
// 해당하는 경우 워크플로우, 필드 키: workflow
workflow: {
id,
name
}
}
```
***
### **자주 묻는 질문**
**Q: 아웃바운드 웹훅과 인바운드 웹훅의 차이점은 무엇인가요?**
아웃바운드 웹훅(이 액션)은 HighLevel *에서* 외부 서비스 *로* 데이터를 전송합니다. 인바운드 웹훅(워크플로우 트리거의 한 유형)은 외부 서비스 *에서* HighLevel *로* 데이터를 수신하여 워크플로우를 시작합니다.
**Q: 웹훅에서 전송된 정확한 데이터를 어떻게 볼 수 있나요?**
실행 로그는 액션이 실행되었음을 확인해 주지만 데이터 페이로드 자체는 표시하지 않습니다. 데이터를 보려면 테스트 중에 URL로 설정하여 `webhook.site`와 같은 무료 웹훅 테스트 도구를 사용할 수 있습니다. 또는 수신 애플리케이션의 수신 데이터 로그를 확인할 수 있습니다.
**Q: 웹훅 액션이 실행 로그에서 오류를 표시합니다. 어떻게 해야 하나요?**
먼저 웹훅 구성의 URL이 100% 정확하고 활성화되어 있는지 다시 확인하세요. 둘째, 수신 애플리케이션이 POST 요청을 받을 수 있도록 설정되어 있고 HighLevel의 데이터 형식을 처리할 수 있는지 확인하세요. 마지막으로 외부 애플리케이션의 오류 로그에서 요청이 실패한 이유에 대한 구체적인 세부사항을 확인하세요.
**Q: 해당 트리거를 사용하지 않고 특정 기회나 예약에 대한 데이터를 전송할 수 있나요?**
아니요. 데이터 페이로드는 컨텍스트에 따라 달라집니다. 기회와 같은 특정 객체에 대한 데이터를 얻으려면 워크플로우가 해당 기회와 관련된 이벤트(예: "파이프라인 단계 변경")에 의해 트리거되어야 합니다. "태그 추가"와 같은 일반적인 트리거는 연락처 수준 데이터만 전송합니다.
**Q: 웹훅과 함께 사용할 수 있는 인기 있는 도구는 무엇인가요?**
웹훅은 일반적으로 Zapier나 Make(이전 Integromat)와 같은 연동 플랫폼으로 데이터를 전송하는 데 사용되며, 이를 통해 수천 개의 다른 앱에 연결할 수 있습니다. 또한 커스텀 서버, Google 시트(Zapier와 같은 서비스를 통해) 또는 Slack과 같은 커뮤니케이션 도구로 데이터를 전송하는 데도 사용됩니다.
**Q: 이 기능을 사용하려면 개발자여야 하나요?**
HighLevel에서 웹훅 액션을 설정하는 것은 간단하며 코딩이 필요하지 않습니다. 하지만 데이터를 전송하려는 서비스에서 대상 URL을 가져와야 합니다. 해당 서비스가 무엇을 받을 것으로 예상하는지 이해하는 것이 도움이 되지만, 많은 서비스에서 URL과 모든 필요한 지침을 제공합니다.
**Q: 웹훅 액션을 통해 이미지/파일을 전송할 수 있나요?**
아니요, 웹훅 액션을 사용하여 이미지/파일을 전송할 수 없습니다.
***
*원문 최종 수정: Mon, 16 Mar, 2026 at 11:23 AM* *Hyperclass 사용 가이드 — hyperclass.ai*
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://hyperclass.gitbook.io/hyperclass-docs/workflows/workflow-action-webhook-outbound.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.