# Webhook.site를 사용하여 API 요청 문제 해결하는 방법

Webhook.site는 연동, 워크플로우 또는 커스텀 API 호출에서 전송되는 원시 HTTP 요청을 검사하고 수집할 수 있는 무료 서드파티 도구입니다. Webhook.site를 사용하면 웹훅 페이로드를 쉽게 디버깅하고, 구성을 확인하며, 페이로드를 하이퍼클래스나 프로덕션 엔드포인트로 보내기 전에 문제를 해결할 수 있습니다.

***

## 목차

* [Webhook.site란 무엇인가요?](#webhooksite란-무엇인가요)
* [작동 방식](#작동-방식)
  * [1단계: Webhook.site 방문](#1단계-webhooksite-방문)
  * [2단계: 고유한 테스트 웹훅 옆의 "클립보드에 복사" 클릭](#2단계-고유한-테스트-웹훅-옆의-클립보드에-복사-클릭)
  * [3단계: Zapier 등 커스텀 연동으로 이동](#3단계-zapier-등-커스텀-연동으로-이동)
  * [4단계: 하이퍼클래스 API URL을 Webhook.site 테스트 URL로 교체](#4단계-하이퍼클래스-api-url을-webhooksite-테스트-url로-교체)
  * [5단계: 업데이트 저장](#5단계-업데이트-저장)
  * [6단계: 페이로드 데이터 검토](#6단계-페이로드-데이터-검토)
  * [7단계: 복사 클릭](#7단계-복사-클릭)

***

## Webhook.site란 무엇인가요?

Webhook.site는 모든 수신 웹훅 요청을 수집하여 실시간으로 표시하는 고유한 테스트 URL을 즉시 생성합니다. 다음과 같은 용도에 이상적입니다:

* 원시 웹훅 페이로드 수집(헤더, 본문, 메서드)
* 실제 엔드포인트로 보내기 전에 요청 구조 검증
* Zapier, Make(Integromat), 커스텀 앱 또는 기타 자동화 도구의 연동 문제 해결

**중요**: 이 가이드의 단계들은 고급 연동을 위한 것이며 정보 제공 목적으로만 작성되었습니다. 현재 저희는 복잡성으로 인해 기본 또는 고급 API를 지원하거나 서비스하지 않지만, 시작하고 연결하는 데 도움이 되는 많은 도구와 그룹이 있습니다! API 지원을 받으려면 Developer Council Slack 커뮤니티에 참여하세요: [**https://www.gohighlevel.com/dev-slack**](https://www.gohighlevel.com/dev-slack)

또한 매월(마지막에서 두 번째 금요일) Developer Council Zoom 통화를 진행하며, 이벤트 캘린더에서 확인할 수 있습니다: [**https://www.gohighlevel.com/events**](https://www.gohighlevel.com/events)

더 많은 정보와 API 문서 링크를 확인하려면 개발자 웹사이트를 방문하세요: <https://marketplace.gohighlevel.com/docs/>

***

## 작동 방식

### 1단계: Webhook.site 방문

브라우저에서 <https://webhook.site>를 열어주세요. 고유한 테스트 URL이 자동으로 생성됩니다.

![Webhook.site 홈페이지](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155064186797/original/78EqPHmlHxnXgPeQwPPVXkY78oq_19psgw.png?1770213973)

### 2단계: 고유한 테스트 웹훅 옆의 "클립보드에 복사" 클릭

홈페이지에서 고유한 테스트 웹훅 옆의 "Copy to clipboard"를 클릭하세요.

![클립보드에 복사 버튼](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/48204558661/original/AMwU34bm7Qtr34Kv-qg5tlrcbmjHLwVPEg.png?1647882452)

### 3단계: Zapier 등 커스텀 연동으로 이동

이 예시에서는 Zapier를 사용하고 있으며, Webhook.site를 테스트에 사용하려면 "Set Up Action"을 클릭해야 합니다.

![Zapier 설정 액션](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/48204558665/original/y413VeWzjcuvSTcRG3D7Qr0i-WG1OsdbRg.png?1647882452)

### 4단계: 하이퍼클래스 API URL을 Webhook.site 테스트 URL로 교체

테스트 목적으로 하이퍼클래스 API URL을 Webhook.site URL로 일시적으로 교체하세요. 하이퍼클래스에 데이터를 POST하는 다른 커스텀 연동에서도 비슷한 과정을 따르게 됩니다.

![URL 교체](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/48204558659/original/u3eeM4pSIkQSw2ivNF_WpkezIC7Rrd2j4Q.png?1647882452)

### 5단계: 업데이트 저장

변경사항을 저장한 다음, 일반적으로 웹훅을 실행하는 플로우를 실행하세요. 도구나 연동(Zapier, Integromat 등)에 내장된 테스트 도구가 있더라도 사용하지 마세요. 대신 실제 사례를 사용하세요. 웹훅이 폼 제출 시 트리거되는 경우 폼에 가서 테스트를 제출하세요. 외부 시스템에서 액션이 수행될 때 자동화가 실행되는 경우 해당 액션을 수행하세요.

이렇게 하면 개발자와 함께 가장 정확한 정보를 얻을 수 있으며, 고급 API 관련 문제를 해결할 때 매우 유용합니다.

### 6단계: 페이로드 데이터 검토

다음으로 웹훅이 실행될 때마다 하이퍼클래스가 받는 원시 데이터가 표시됩니다. 이를 API 문서 웹사이트의 정보와 비교하여 구성을 테스트할 수 있습니다.

![페이로드 데이터 검토](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/48204626853/original/rZKm85AvhyACSqZ3wxKtgoFf4Zkh8lDLMQ.png?1647895301)

### 7단계: 복사 클릭

원시 데이터 입력 상자 오른쪽 상단의 Copy를 클릭하여 전체 페이로드를 복사하세요. 개발자와의 문제 해결이나 하이퍼클래스 팀과의 협업을 위해 저장해두세요.

![페이로드 복사](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/48204626854/original/KfqMVOZpTrJV0t0LHq6GHcGcIK1t1AR3oQ.png?1647895301)

***

*원문 최종 수정: Wed, 4 Feb, 2026 at 8:07 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/developer/how-to-use-webhook-site-to-troubleshoot-your-api-requests.md?ask=<question>
```

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.
