Webhooks — 링크 클릭을 실시간으로 내 서버에 받기

Webhooks가 필요한 이유

클릭 데이터를 그 즉시 받아서, 그 위에 나만의 워크플로우를 만들어 보세요

실시간

클릭이 발생하는 순간 이벤트가 도착합니다. API를 주기적으로 폴링하며 업데이트를 기다릴 필요가 없습니다.

클릭마다 상세 데이터

국가, 도시, 기기, OS, 브라우저, 유입 경로, 봇 여부까지 — 자체 분석에 필요한 정보를 모두 받을 수 있습니다.

기본적으로 안전

모든 요청은 자신의 시크릿 키로 HMAC 서명되므로, 진짜 이벤트와 위조된 요청을 손쉽게 구분할 수 있습니다.

안정적인 전송

서버가 다운되면 전송이 재시도됩니다. 모든 시도와 상태는 전송 로그에서 확인할 수 있습니다.

활용 사례

클릭 이벤트를 보통 어디로 보내는지

자체 분석 시스템이나 CRM

모든 클릭을 자체 데이터베이스나 CRM에 저장하고, 원하는 방식으로 리포트를 만들어 보세요.

채팅 알림

Telegram, Slack, Discord 봇이 새 클릭을 즉시 알려주도록 만들어, 수동 확인 없이도 알 수 있습니다.

자동화

Zapier, Make, n8n에서 시나리오를 실행하세요: 클릭 이벤트 하나가 어떤 동작이든 트리거할 수 있습니다.

Webhook으로 어떤 데이터가 오나요

redirects.batch 이벤트: 하나의 payload에 특정 시간대의 클릭들이 묶여서 전달됩니다

{
  "delivery_id": "d_01HXY9F0…",
  "event_type": "redirects.batch",
  "sent_at": "2026-08-04T10:15:00Z",
  "window": { "from": "…10:14:00Z", "to": "…10:15:00Z" },
  "count": 1,
  "truncated": false,
  "events": [
    {
      "event_id":   "e_9f86d0…",
      "link_id":    9053352,
      "datetime":   "2026-08-04T10:14:12Z",
      "country":    "DE",
      "city":       "Berlin",
      "browser":    "Chrome",
      "os":         "Android",
      "device":     "mobile",
      "ref_domain": "t.me",
      "group_id":   null,
      "is_bot":     false
    }
  ]
}

방문자의 IP 주소는 개인정보이기 때문에 기본적으로 전송되지 않으며, 해당 endpoint에서 명시적으로 활성화한 경우에만 포함됩니다.

Webhooks로 할 수 있는 것

유연한 설정, 탄탄한 보안, 예측 가능한 전송

배치 단위 이벤트 전송

클릭은 특정 시간대 단위로 묶여서(redirects.batch) 전달되어, 서버로 가는 요청 수를 줄여줍니다.

원하는 범위 지정

계정의 모든 링크, 특정 그룹, 또는 링크 하나 — 필요한 이벤트만 받을 수 있습니다.

HMAC 서명

모든 요청은 시크릿 키로 서명됩니다. 시크릿 키는 언제든 재발급할 수 있습니다.

재시도 및 자동 비활성화

서버에 도달할 수 없으면 재시도하며, 계속 응답이 없는 endpoint는 자동으로 비활성화됩니다.

전송 로그

모든 전송 내역을 상태와 본문까지 기록하여, 문제가 생겼을 때 원인을 쉽게 추적할 수 있습니다.

테스트 전송(ping)

실제 트래픽이 들어오기 전에 클릭 한 번으로 연동을 검증하세요 — 서버로 테스트 이벤트가 전송됩니다.

풍부한 이벤트 데이터

클릭마다 link_id, 시각, 국가, 도시, OS, 기기, 브라우저, 유입 경로, 봇 여부가 함께 전달됩니다.

기본적으로 프라이버시 보호

특정 endpoint에서 명시적으로 활성화하지 않는 한 IP 주소는 전송되지 않습니다.

무료로 체험하기

Webhook 설정 방법

다섯 단계 — 서버 URL 등록부터 클릭 이벤트가 실시간으로 흘러들어오기까지

1

endpoint 만들기

Lix.li에 가입하고 Webhooks 메뉴를 연 다음, Lix.li가 클릭 이벤트를 보낼 서버 URL을 입력하세요.

2

범위 선택하기

어떤 링크의 이벤트를 받을지 정하세요: 계정의 모든 링크, 특정 그룹, 또는 링크 하나.

3

서명용 시크릿 저장하기

Lix.li가 시크릿 키를 발급해 줍니다. 모든 요청은 HMAC로 서명되므로, 헤더의 서명을 확인해 이벤트가 실제로 Lix.li에서 왔는지 확인하세요.

4

테스트 요청 보내기

"테스트"(ping) 버튼을 눌러 서버가 요청을 정상적으로 받고 2xx를 응답하는지 확인하세요. 실제 트래픽이 들어오기 전에 연동을 검증할 수 있습니다.

5

전송 로그 확인하기

로그에서 모든 전송 내역과 상태, 재시도 기록을 확인할 수 있습니다. 서버에 접근할 수 없으면 전송이 재시도되고, 계속 응답이 없는 endpoint는 자동으로 비활성화됩니다.

Webhook 설정하기

Webhooks 자주 묻는 질문

Webhook이 무엇인가요?

Webhook은 어떤 이벤트가 발생했을 때 Lix.li가 자체적으로 내 서버로 보내는 HTTP 알림입니다. 어떤 API도 폴링할 필요 없이, 링크가 클릭되는 순간 데이터가 자동으로 도착합니다.

어떤 이벤트가 전송되나요?

단축 링크의 클릭 이벤트입니다. 이벤트는 배치 단위로 전달되며(event_type = redirects.batch), 각 클릭마다 시각, 국가, 도시, OS, 기기, 브라우저, 유입 경로, 봇 여부가 함께 전송됩니다.

데이터는 어떤 형식으로 오나요?

HTTP POST로 전송되는 JSON입니다. 본문에는 delivery_id, 시간대, count 같은 메타 정보와, 각 클릭 데이터를 담은 events 배열이 포함됩니다. 이 페이지에 전체 요청 본문 예시가 있습니다.

요청이 실제로 Lix.li에서 왔는지 어떻게 확인하나요?

모든 요청은 시크릿 키를 기반으로 HMAC 서명됩니다 — 헤더의 서명을 요청 본문과 대조하면 위조 요청을 걸러낼 수 있습니다. 시크릿 키는 언제든 재발급(로테이션)할 수 있습니다.

서버가 일시적으로 다운되면 어떻게 되나요?

전송이 자동으로 재시도됩니다. endpoint가 오랫동안 응답이 없으면 일시적으로 비활성화되며, 모든 시도와 상태는 전송 로그에 남기 때문에 이벤트가 눈치채지 못한 채 사라지는 일은 없습니다.

특정 링크의 이벤트만 받을 수 있나요?

네. 범위를 선택할 수 있습니다: 계정의 모든 링크, 특정 그룹의 링크, 또는 링크 하나. 이렇게 하면 서버에 불필요한 트래픽이 들어오지 않습니다.

방문자의 IP 주소도 전송되나요?

기본적으로는 전송되지 않습니다. 개인정보이기 때문입니다. 해당 endpoint 설정에서 명시적으로 활성화한 경우에만 이벤트에 IP가 포함됩니다.

Webhooks는 어떤 요금제에서 사용할 수 있나요?

Webhooks는 Premium 요금제에서 사용할 수 있습니다. 가입 후 Premium으로 업그레이드하면 endpoint를 연결할 수 있습니다.

클릭 이벤트를 기반으로 나만의 연동을 만들어 보세요

단 몇 분이면 Webhook을 설정할 수 있습니다 — 클릭 데이터를 필요한 곳에 정확히 받아보세요.

Lix.li의 Webhooks는 단축 링크에 대한 클릭 알림을 자동으로 받는 방법입니다. API를 계속 폴링하는 대신, 서버 URL만 등록해두면 클릭이 발생하는 순간 Lix.li가 그곳으로 HTTP POST를 보내줍니다. 이는 단축 링크를 위한 전형적인 HTTP callback 방식으로, 클릭 이벤트를 실시간으로 내 시스템에 전달합니다.

모든 요청 본문은 클릭 배열을 담은 redirects.batch 이벤트입니다: 각 클릭마다 시각, 국가, 도시, 브라우저, 운영체제, 기기, 유입 경로, 봇 여부가 함께 담깁니다. 이 데이터를 자체 데이터베이스나 CRM에 저장하거나, Telegram·Slack·Discord로 클릭 알림을 보내거나, Zapier·Make·n8n의 트리거로 활용하기도 쉽습니다. 요청은 HMAC 서명으로 보호되어, 헤더의 서명을 본문과 대조해 위조 요청을 걸러낼 수 있고, 필요할 때마다 시크릿 키를 재발급할 수 있습니다.

전송 결과는 예측 가능합니다: 서버 장애가 발생하면 이벤트가 재시도되고, 계속 응답이 없는 endpoint는 일시적으로 비활성화되며, 모든 시도는 전송 로그에서 확인할 수 있습니다. 범위를 모든 링크, 특정 그룹, 또는 링크 하나로 제한할 수 있고, 실제 트래픽이 들어오기 전에 테스트 전송(ping)으로 연동을 검증할 수도 있습니다. Webhooks는 일반 Lix.li 단축 링크, QR 코드, 통계 기능과 함께 사용할 수 있으며 Premium 요금제에서 제공됩니다.