Zapier

Zapier 의 공식 액션 Webhooks by Zapier 만으로 Thunderbit 를 처음부터 끝까지 다룰 수 있습니다. 두 단계 Zap —— 트리거가 발화하고, Webhook 이 /distill 로 POST 합니다.

셋업

Trigger —— 무엇이든 고르세요(Google Sheets 신규 행, Slack 신규 메시지, 스케줄 등).

Action 1: Webhooks by Zapier → POST

• URL: https://openapi.thunderbit.com/openapi/v1/distill
• Payload Type: JSON
• Data:
  • url —— 트리거에서 매핑
  • renderMode —— basic(JS 무거운 페이지면 advanced)
• Headers:
  • Authorization —— Bearer YOUR_API_KEY
  • Content-Type —— application/json

Action 2(선택) —— data.markdown 을 Notion / Airtable / Slack / OpenAI 로 흘려보내세요.

비동기 배치 작업

Zapier 의 webhook 액션은 최대 30 초까지 기다립니다 —— /distill 에는 충분하지만 /batch/distill 에는 빠듯합니다. 두 가지 옵션이 있습니다.

옵션 A —— Catch Hook 콜백

1. 별도 Zap 에 Webhooks by Zapier → Catch Hook 트리거를 추가하고 URL 복사
2. 배치 제출 Zap 에서 callback.url 을 그 hook 으로 지정
3. 배치가 끝나면 catch-hook Zap 이 발화 —— Looping 액션으로 results 순회

옵션 B —— 스케줄 + 폴링

Zap 두 개를 운용할 수 없으면 5 분마다 도는 Schedule by Zapier 트리거를 만들고 status: COMPLETED 가 될 때까지 GET /batch/{jobId} 를 호출하세요.

팁

• API Key 는 Zapier Storage 레코드에 저장해서 여러 Zap 에 붙여넣지 마세요
• 다운스트림 단계 전에 빈 결과를 거르려면 응답에 Filter by Zapier 를 적용하세요

관련 문서

• Webhook 가이드
• n8n · Make.com