노코드 자동화를 만들다 보면 가장 많이 듣는 단어 중 하나가 Webhook입니다. Make, n8n, Zapier, Pabbly Connect 등 대부분의 자동화 플랫폼에서 Webhook은 시작점 역할을 합니다.
하지만 처음 접하는 분들은 “Webhook이 제대로 들어오는지 어떻게 확인하지?”라는 고민을 가장 먼저 하게 됩니다.
저 역시 Make 자동화를 처음 만들 때 API는 연결했는데 이벤트가 들어오는지 확인할 방법을 몰라 한참을 헤맸던 기억이 있습니다. 알고 보니 무료 서비스 하나만 이용하면 몇 초 만에 테스트가 가능했습니다.
이번 글에서는 Webhook 테스트를 가장 쉽고 빠르게 하는 방법을 소개하겠습니다.
Webhook 테스트가 필요한 이유
Webhook은 특정 이벤트가 발생했을 때 다른 서비스로 데이터를 전송하는 기능입니다.
예를 들어
- 회원가입
- 주문 완료
- 구글 폼 제출
- 결제 완료
와 같은 이벤트가 발생하면 지정된 URL로 데이터를 전달합니다.
하지만 실제 운영 전에 반드시 확인해야 하는 것이 있습니다.
- 데이터가 정상적으로 전달되는지
- JSON 형식이 맞는지
- 필요한 값이 모두 포함되어 있는지
- 오류 없이 응답하는지
이 과정을 바로 Webhook 테스트라고 합니다.
가장 쉬운 방법은 Webhook.site 이용하기
Webhook 테스트를 위해 가장 많이 사용하는 서비스가 Webhook.site입니다.
별도의 회원가입도 필요 없으며 사이트에 접속하는 순간 고유한 URL이 생성됩니다.
사용 방법도 매우 간단합니다.
1. Webhook.site 접속
사이트에 접속하면 자동으로 URL이 하나 생성됩니다.
예시
https://webhook.site/xxxxxx
이 주소가 테스트용 Webhook URL입니다.
2. 자동화 프로그램에 URL 입력
Make나 n8n에서 Webhook 주소 대신 생성된 URL을 입력합니다.
또는
- API 프로그램
- Postman
- CURL
- 자체 프로그램
어디에서든 해당 URL로 데이터를 보내면 됩니다.
3. 데이터 확인
데이터가 도착하면 화면에 바로 표시됩니다.
확인 가능한 내용은 다음과 같습니다.
- HTTP Method
- Header
- Body
- JSON 데이터
- 전송 시간
- 응답 코드
덕분에 어느 부분에서 문제가 발생했는지 쉽게 확인할 수 있습니
Postman으로도 Webhook 테스트 가능
API 개발을 많이 한다면 Postman도 좋은 선택입니다.
POST 요청을 생성한 뒤
- URL 입력
- Body 선택
- JSON 작성
후 Send 버튼만 누르면 됩니다.
예시 JSON
{
“name”: “홍길동”,
“email”: “test@example.com”,
“status”: “success”
}
Webhook.site에서는 위 JSON이 그대로 수신되는 모습을 확인할 수 있습니다.
Make 사용자라면 이렇게 활용하세요
제가 실제 자동화를 만들 때 가장 많이 사용하는 방법입니다.
Google Forms 제출 →
Webhook.site →
Make →
Google Sheets
순서로 연결하면 데이터가 어떤 형태로 들어오는지 먼저 확인할 수 있습니다.
예전에는 Make에서 오류가 발생하면 원인을 찾느라 시간을 많이 소비했는데, 이제는 Webhook.site에서 먼저 데이터를 확인한 후 시나리오를 연결하니 오류를 훨씬 빠르게 해결할 수 있었습니다.
특히 JSON 구조를 먼저 확인하고 매핑을 진행하면 대부분의 실수를 예방할 수 있었습니다.
Webhook 테스트 시 자주 발생하는 문제
URL이 잘못 입력된 경우
가장 흔한 실수입니다.
공백이나 문자 하나만 달라도 데이터는 전송되지 않습니다.
POST 대신 GET 요청
대부분의 Webhook은 POST 방식을 사용합니다.
요청 방식을 반드시 확인하세요.
Content-Type 오류
JSON이라면
application/json
헤더가 포함되어야 합니다.
방화벽 또는 보안 설정
회사 내부 서버에서는 외부 접근이 차단되는 경우도 있습니다.
이 경우 서버 설정도 함께 확인해야 합니다.
Webhook 테스트를 먼저 하면 개발 시간이 크게 줄어듭니다
Webhook은 자동화의 시작점입니다.
데이터가 제대로 들어오는지만 확인해도 이후 작업은 훨씬 수월해집니다.
저도 처음에는 Make 오류라고 생각했던 문제가 사실은 API에서 잘못된 JSON을 보내고 있었던 경우가 많았습니다. Webhook.site를 사용하기 시작한 이후에는 원인을 찾는 시간이 크게 줄었고, 자동화 구축 속도도 눈에 띄게 빨라졌습니다.
자동화를 처음 시작하는 분이라면 복잡한 디버깅보다 Webhook 테스트부터 진행하는 습관을 들이는 것을 추천합니다. 작은 확인 과정 하나가 이후의 시행착오를 크게 줄여주며, 안정적인 자동화 구축에도 많은 도움이 될 것입니다.