STAGE 8 · Lv.42

웹훅(Webhook) 개념과 활용

웹훅의 개념, WP Webhooks 플러그인, 커스텀 웹훅 엔드포인트, 페이로드 구조, 보안 설정을 배웁니다.

웹훅이란?

폴링(Polling) vs 웹훅(Webhook)

두 시스템이 데이터를 교환하는 방식에는 크게 두 가지가 있습니다: 폴링(Polling)과 웹훅(Webhook)입니다.

폴링(Polling)은 클라이언트가 주기적으로 서버에 "새 데이터 있어?"라고 물어보는 방식입니다. 마치 택배가 왔는지 5분마다 현관문을 열어보는 것과 같습니다. 대부분의 경우 "아직 없어"라는 답을 받게 되어 불필요한 요청이 낭비됩니다.

웹훅(Webhook)은 서버가 이벤트가 발생했을 때 즉시 클라이언트에게 알려주는 방식입니다. 택배 배달이 완료되면 초인종을 누르는 것과 같습니다. 불필요한 확인이 없으므로 효율적이고, 이벤트 발생 즉시 알 수 있어 실시간에 가깝습니다.

기술적으로 웹훅은 HTTP 콜백(Callback)입니다. 이벤트가 발생하면, 소스 시스템이 미리 등록된 URL로 HTTP POST 요청을 보냅니다. 이 URL을 웹훅 URL 또는 콜백 URL이라고 합니다.

📝

이벤트
발생

→

📨

HTTP POST
전송

→

🎯

수신 URL
(웹훅)

→

⚡

처리
실행

비교 항목	폴링(Polling)	웹훅(Webhook)
데이터 전달 방식	클라이언트가 주기적 요청	서버가 즉시 전송
실시간성	간격에 따라 지연	즉시 (수초 이내)
서버 부하	높음 (빈 요청 다수)	낮음 (필요할 때만)
구현 난이도	간단	보통
신뢰성	높음	재시도 필요
API 비용	요청마다 소비	이벤트 시에만

💡 Make.com과 웹훅

Make.com에서 WordPress Watch Posts 모듈은 폴링 방식입니다 (최소 1분 간격). 하지만 Make.com의 Webhook 트리거를 사용하면 WordPress에서 이벤트가 발생하는 즉시 시나리오가 실행됩니다. 실시간에 가까운 자동화가 필요하다면 웹훅 방식을 사용하세요.

웹훅의 구성 요소

웹훅 URL (Endpoint)

이벤트 데이터를 수신할 URL입니다. 수신 측(예: Make.com)이 제공하는 고유한 URL로, 이 URL로 HTTP POST 요청이 전송됩니다. 예: https://hook.make.com/abc123xyz789

페이로드 (Payload)

웹훅 요청에 포함되는 데이터입니다. 주로 JSON 형식으로 이벤트의 상세 정보를 담고 있습니다. 예를 들어 새 글 발행 웹훅의 페이로드에는 글 제목, 내용, URL, 작성자 등의 정보가 포함됩니다.

이벤트 (Event/Trigger)

웹훅을 발동시키는 조건입니다. "새 글 발행", "댓글 작성", "주문 접수" 등이 이벤트가 됩니다. WordPress에서는 Action Hook을 통해 이벤트를 감지합니다.

시크릿 (Secret/Signature)

웹훅 요청의 진위를 검증하기 위한 비밀 키입니다. 발신 측이 페이로드를 시크릿으로 서명하고, 수신 측이 같은 시크릿으로 서명을 검증합니다. 위조된 요청을 방지합니다.

// 웹훅 요청 예시
POST https://hook.make.com/abc123xyz789
Content-Type: application/json
X-WP-Webhook-Signature: sha256=a1b2c3d4e5f6...

{
  "event": "post_published",
  "post_id": 123,
  "title": "새로운 블로그 글",
  "url": "https://blog.com/new-post/",
  "author": {
    "id": 1,
    "name": "관리자"
  },
  "categories": ["기술", "자동화"],
  "published_at": "2026-04-01T09:30:00+09:00"
}
    

🔒

여기까지는 미리보기입니다

웹훅(Webhook) 개념과 활용
무료 가입하면 이어서 볼 수 있고, 강의를 완료할 때마다 XP와 레벨이 쌓입니다.

Google로 3초 만에 시작 →🧵 Threads로 시작 무료 공개 강의 둘러보기 (Lv.1~3)