문서

웹훅 — 개요 및 설정 Pro

Savebase 웹훅을 사용하면 라이브러리를 Zapier, Make, Slack, Airtable, Discord나 자체 백엔드 등 모든 자동화 도구에 연결할 수 있습니다. 게시물이 저장, 태그 지정, 삭제 또는 복원될 때마다 Savebase는 등록한 엔드포인트로 HTTP POST를 보냅니다.

Pro 기능

웹훅은 Pro와 Lifetime에서 사용할 수 있습니다. 다음에서 업그레이드하세요. savebase.space/pricing.

개요

라이브러리에 이벤트가 발생하면 Savebase는 해당 이벤트에 등록되고 활성화된 모든 웹훅 주소로 서명된 JSON 데이터를 보냅니다. 원한다면 연동별 하나씩 여러 주소를 등록할 수 있습니다.

웹훅 설정

1

설정 → 웹훅으로 이동하세요

다음으로 이동: Dashboard → Settings → Webhooks.
2

웹훅 추가 클릭

엔드포인트 URL (HTTPS 필수)과 선택 사항인 라벨을 입력한 뒤 구독할 이벤트를 선택하세요.
3

서명 시크릿 복사

웹훅을 만든 후 다음을 표시하고 복사하세요: 서명 비밀키. 요청이 Savebase에서 왔는지 확인하는 데 사용하세요.
4

엔드포인트 테스트

클릭 테스트 이벤트 보내기 예시 데이터를 즉시 보내려면.

지원되는 이벤트

이벤트실행 시점
post.saved새 게시물이 라이브러리에 추가됩니다
post.tagged게시물에 태그가 추가됩니다
post.deleted게시물이 휴지통으로 이동됩니다
post.restored게시물이 휴지통에서 복원됩니다

페이로드 형식

모든 이벤트는 같은 JSON 봉투 구조를 사용합니다:

bash
{
  "event": "post.saved",
  "timestamp": "2026-03-11T12:00:00.000Z",
  "data": {
    "id": 123,
    "url": "https://x.com/user/status/...",
    "title": "Post title or null",
    "source": "x",
    "author_name": "username",
    "tags": ["design", "ai"],
    "saved_at": "2026-03-11T12:00:00.000Z"
  }
}

Zapier 연동

1

새 Zap 만들기

Zapier에서 다음을 클릭하세요: Create Zap 그리고 다음을 검색하세요. Webhooks by Zapier 트리거 앱으로 선택하세요.
2

Catch Hook 선택

선택 Catch Hook. Zapier가 고유한 웹훅 URL을 생성합니다.
3

Savebase에 URL 등록

Zapier URL을 다음 위치에 복사하세요 Settings → Webhooks 이벤트를 선택하세요.
4

트리거 테스트

게시물을 저장하세요. Zapier가 페이로드를 감지합니다. 다음을 매핑하세요: data.url, data.title등을 작업 단계에 추가하세요.
5

작업 추가

Google Sheets 행, Slack 메시지, Notion 페이지, Discord 게시물 등 원하는 Zapier 작업을 연결하세요.

Zapier에 기본 서명 검증 기능 없음

Zapier에 Filter 또는 Code 단계를 추가하여 다음을 검증하세요: X-Savebase-Signature 보안 검증이 필요하면 헤더를 확인하세요.

Make (Integromat)

1

새 시나리오 만들기

Make에서 다음을 추가하세요: 웹훅 → 사용자 지정 웹훅 트리거 모듈.
2

Savebase에 등록

Make URL을 다음 위치에 복사하세요 Settings → Webhooks.
3

데이터 구조 파악

Savebase에 게시물을 저장하세요. Make가 페이로드 구조를 자동 감지합니다.
4

시나리오 만들기

지도 data.url, data.source및 기타 필드를 Airtable, Notion, 이메일 등의 후속 모듈로 전달하세요.