웹훅

웹훅을 사용하면 링크가 클릭될 때 실시간 알림을 받을 수 있습니다. 클릭이 발생하면 Linkly가 지정된 URL로 POST 요청을 보내며, 클릭에 대한 자세한 정보가 포함됩니다.

사용 사례

• 자동화 플랫폼: Make 또는 Zapier에서 링크 클릭 시 워크플로우 트리거
• 맞춤 분석: 클릭 데이터를 자신의 분석 시스템으로 전송
• CRM 업데이트: 고객이 링크를 클릭할 때 고객 레코드 업데이트
• Slack 알림: 중요한 링크가 클릭될 때 Slack에서 알림 수신
• 리드 추적: 잠재 고객이 링크에 참여할 때 추적

팁: 대부분의 자동화 사용 사례의 경우, Make 통합 또는 Zapier 통합이 맞춤 웹훅보다 설정하기 더 쉽습니다. 이들은 웹훅으로 구동되는 즉시 클릭 트리거를 포함하며 코딩이 필요하지 않습니다.

참고: 두 수준 모두에서 웹훅을 구성하면 해당 링크의 클릭 시 둘 다 실행됩니다.

웹훅 페이로드

클릭이 발생하면 Linkly는 다음 JSON 페이로드를 포함한 POST 요청을 보냅니다:

{
  "event": "click",
  "timestamp": "2025-01-15T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.com",
    "slug": "/abc123",
    "destination": "https://example.com/landing-page",
    "workspace_id": 1,
    "enabled": true,
    "cloaking": false,
    "forward_params": true,
    "block_bots": true,
    "public_analytics": false,
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "spring-sale",
    "og_title": "Special Offer",
    "og_description": "Check out our spring sale!",
    "rules": [
      {
        "what": "country",
        "matches": "US",
        "url": "https://example.com/us-landing"
      }
    ]
  },
  "click": {
    "country": "US",
    "is_eu_country": false,
    "platform": "desktop",
    "browser_name": "Chrome",
    "referer": "https://twitter.com/",
    "isp": "Comcast",
    "bot_name": null,
    "destination": "https://example.com/landing-page",
    "params": {
      "utm_source": "twitter"
    }
  }
}

페이로드 필드

이벤트 정보

링크 객체

클릭 객체

개인정보 보호 참고사항: IP 주소는 웹훅 페이로드에 포함되지 않습니다.

자동화 플랫폼 통합

맞춤 코딩 없이 더 쉽게 설정하려면 기본 통합을 사용하세요:

• Make 통합 - 즉시 클릭 트리거를 포함한 시각적 자동화 플랫폼
• Zapier 통합 - 코드 없이 Linkly를 수천 개의 앱과 연결

두 통합 모두 내부적으로 웹훅을 사용하지만 모든 설정을 자동으로 처리합니다.

모범 사례

여러 웹훅

여러 웹훅 URL을 추가할 수 있습니다(한 줄에 하나씩). 클릭이 발생하면 모든 URL이 동일한 페이로드를 수신합니다.

오류 처리

• 웹훅은 fire-and-forget - Linkly는 실패한 전달을 재시도하지 않습니다
• 웹훅 실패는 리다이렉트에 영향을 주지 않습니다 - 사용자는 항상 목적지에 도달합니다
• 웹훅 엔드포인트가 빠르게 응답하는지 확인하세요(5초 이내 권장)

보안

• 웹훅 URL에 HTTPS 엔드포인트를 사용하세요
• 웹훅 핸들러에서 들어오는 요청을 검증하세요
• 검증을 위해 웹훅 URL에 비밀 매개변수를 추가하는 것을 고려하세요

테스트

1. 1
   webhook.site 또는 RequestBin 같은 서비스를 사용하여 웹훅 URL 설정
2. 2
   링크를 클릭합니다
3. 3
   수신한 페이로드를 검사합니다
4. 4
   확인 후 프로덕션 웹훅 URL로 전환합니다

API 액세스

API를 통해 프로그래밍 방식으로 웹훅을 관리할 수도 있습니다:

POST   /api/v1/link/:link_id/webhooks
DELETE /api/v1/link/:link_id/webhooks/:hook_id
GET    /api/v1/link/:link_id/webhooks

POST   /api/v1/workspace/:workspace_id/webhooks
DELETE /api/v1/workspace/:workspace_id/webhooks/:hook_id
GET    /api/v1/workspace/:workspace_id/webhooks

자세한 내용은 API 문서를 참조하세요.