연동
웹훅
기록된 클릭마다 JSON POST를 받습니다. Zapier REST Hooks가 구독하는 것과 같은 이벤트입니다.
Growth 및 Ultimate에서는 클릭이 기록되면 Letlink가 워크스페이스에 등록된 모든 HTTPS URL로 JSON을 POST합니다. 소유자와 관리자는 연동 → 웹훅에서 URL을 추가하거나 삭제할 수 있습니다. 멤버는 목록을 볼 수 있지만 변경할 수 없습니다.
엔드포인트 추가
Content-Type: application/json으로POST를 받는 HTTPS URL을 준비하세요. HTTP는 거부됩니다.- 연동 → 웹훅에 붙여 넣고 저장하세요. 이벤트 이름은
link_visited입니다. - 월 한도를 넘지 않은 네트워크에서 단축 링크 하나를 클릭하세요. 몇 초 안에 요청이 도착합니다 — 전송은 리디렉션 중에 바로 처리되지 않고 대기열을 거칩니다.
API로 구독할 수도 있습니다: target_url과 선택적 event(기본값 link_visited)를 포함해 POST /api/v1/hooks/subscribe를 호출하세요. Zapier REST Hooks도 같은 구독/구독 해제 경로를 호출합니다.
페이로드
본문은 표준 방문 객체입니다. 비어 있는 UTM 또는 스토어 필드는 null입니다.
{
"visit_id": 42,
"visit_time": "2026-09-09T18:01:22+00:00",
"link_type": "utm",
"link_shortcode": "summer",
"link_domain": "letl.ink",
"link_destination_url": "https://example.com/a",
"utm_source": "newsletter",
"utm_campaign": "sep",
"utm_medium": "email",
"google_play_app_url": null,
"google_play_utm_source": null,
"google_play_utm_campaign": null,
"app_store_app_url": null,
"app_store_ct": null,
"instagram_username": null,
"visitor_ip": "203.0.113.10",
"visitor_browser": "Chrome",
"visitor_device_type": "desktop",
"visitor_referrer": "https://mail.example.com/",
"visitor_variation": "hero-b"
}
웹훅이 실행되지 않을 때
- 워크스페이스가 Free 또는 Solo 요금제입니다(
allowsWebhooks가 꺼져 있음). - 월 클릭 추적 한도에 이미 도달했습니다 — 리디렉션은 이루어지지만 기록되지 않으므로 아무것도 전송되지 않습니다.
- 클릭이 저장되기 전에 기기별 방문 제한으로 429가 반환되었습니다.
- 국가 접근 규칙에 의해 방문자가 차단되었습니다. 차단된 방문은 클릭으로 저장되지 않습니다.
- 대상 URL이 다운되었습니다. 전송은 최선의 노력으로 이루어지며 방문자를 지연시켜서는 안 되므로, 실패한 전송은 이 페이지에서 재시도되지 않습니다.
누가 무엇을 받나요
훅은 사용자별로 저장됩니다. 워크스페이스의 어떤 링크가 클릭되든 모든 멤버의 link_visited URL로 알림이 갑니다. 팀원 두 명이 각각 Zapier를 구독했다면 두 Zap이 모두 실행됩니다. 남아 있는 Catch Hook이 계속 실행되지 않도록 사용하지 않는 URL은 삭제하세요.