웹훅

웹훅 개요

Lenit이 이벤트 발생 시 등록된 URL로 POST 요청을 보내는 기능. 자사 서버에서 이걸 받아 카카오 알림톡·이메일·푸시 등 자체 채널로 알림을 발송하거나, Slack·JANDI·Zapier 등으로 연동할 수 있습니다.

무엇을 할 수 있나요?

시나리오어떻게
상태 변경 → 관련 사용자에게 알림"다크모드 만들어주세요" 아이디어가 완료됨으로 바뀌면 그 아이디어에 투표/댓글한 사용자에게 자사 카카오 알림톡 발송
공지 발행 → 연관 사용자에게 알림공지를 특정 아이디어와 link해서 발행하면 그 아이디어 관련 사용자에게 자동 발송
Slack 채널 알림새 아이디어가 올라오면 #product-feedback 채널에 자동 알림
Zapier / n8n노코드 자동화 도구로 Notion 페이지 자동 생성, 이메일 캠페인 트리거 등

한 기능, 여러 타겟 — 자동 포맷 변환

웹훅 URL을 어떤 걸 넣느냐에 따라 백엔드가 자동으로 적절한 포맷으로 변환합니다.

URL 패턴자동 변환
hooks.slack.com/...Slack Block Kit 메시지
wh.jandi.com/...JANDI connectInfo
그 외 모든 URLLenit 표준 JSON envelope (event + eventLabel + data + audience)

한 조직에서 여러 개를 동시에 등록할 수 있고, 각 엔드포인트마다 받을 이벤트와 audience를 다르게 설정할 수 있습니다.

실제 운영 예시
text
1
2
3
4
1. https://hooks.slack.com/...    → 개발팀, 모든 이벤트
2. https://wh.jandi.com/...       → 마케팅팀, 공지만
3. https://api.mycompany.com/...  → 자사 서버, 상태 변경 + audience
4. https://hooks.zapier.com/...   → Notion 자동화

페이로드 기본 구조 (자사 서버용)

POST 본문 — Lenit 표준 envelope
json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "event": "idea.status_changed",
  "eventLabel": "아이디어 상태 변경",
  "data": {
    "ideaId": "...",
    "title": "다크모드 지원",
    "oldStatus": "투표중",
    "newStatus": "완료됨",
    "updatedAt": "2026-04-25T21:45:56",
    "audience": {
      "author":     { "externalId": "user_001", "traits": { "plan": "pro" } },
      "commenters": [ { "externalId": "user_002", "traits": {} } ],
      "voters":     [ { "externalId": "user_003", "traits": {} } ],
      "reactors":   [ { "externalId": "user_004", "traits": {} } ]
    }
  }
}

요청 헤더:

  • Content-Type: application/json
  • X-Lenit-Event: idea.status_changed

등록하기

  1. 관리자 대시보드 → 사이드바 팀 & 연동 → 웹훅 진입
  2. + 새 웹훅 추가 클릭
  3. URL 입력 → 받을 이벤트 체크 → audience 그룹 체크 → 저장
  4. 실제 동작 확인은 webhook.site 같은 임시 수신 URL 로 등록 후, 보드에서 아이디어 상태 변경 등 이벤트를 실제로 발생시켜 페이로드를 검사하세요.
참고별도의 '테스트 발송' 버튼은 제공하지 않습니다
이벤트 발화 조건이 실제 운영 흐름과 동일해야 audience(투표자·댓글러·작성자) 가 의미 있게 채워지므로, 더미 발송 대신 실제 이벤트로 검증하는 방식을 권장합니다.

다음 단계

←설치 가이드이벤트 종류→