연동
Zapier
기록된 방문마다 Zap을 실행하고, 다른 앱에서 단축 링크를 만드세요.
Zapier는 여러분의 스크립트와 같은 REST API를 사용합니다. Growth 또는 Ultimate 워크스페이스와 연동 → Zapier(또는 API — 같은 토큰입니다)의 API 토큰이 필요합니다.
앱 연결
- Zapier에서 Letlink 연결을 추가하고, 요청 시 API 토큰을 붙여 넣으세요.
- Zapier는
GET /api/v1/auth/me를 호출하여 이를 확인합니다. - 테스트가 403으로 실패하면 워크스페이스 요금제에 아직 API가 포함되지 않은 것입니다 — Growth로 업그레이드하세요.
트리거: 링크 방문
link_visited 이벤트에 대한 REST Hook입니다. Zap을 켜면 Zapier가 Catch URL과 함께 /api/v1/hooks/subscribe로 POST 요청을 보냅니다. 이후 기록된 각 클릭이 웹훅 페이로드 형식(웹훅 참조)으로 POST됩니다. 필드를 매핑하는 동안 Zapier가 샘플 행을 가져오기 위해 GET /api/v1/visits를 호출할 수도 있으며, 이 엔드포인트는 같은 형식으로 최근 50개의 클릭을 반환합니다.
Zap에서 유용한 필드: link_shortcode, link_destination_url, visitor_device_type, visitor_browser, visitor_referrer, visitor_variation, utm_source, utm_campaign, instagram_username.
작업: 링크 생성
POST /api/v1/links에 매핑됩니다. type, destination, short_code, title, domain과 스마트 유형 필드(ios_url, android_url 등)를 전달할 수 있습니다. Free 요금제의 스마트 유형이나 한도를 초과한 워크스페이스는 Zap 실행 기록에 오류를 반환합니다.
운영 참고 사항
- Letlink에서 토큰을 다시 생성하면 새 값을 붙여 넣을 때까지 Zapier 연결이 끊어집니다.
- Zap을 끄면 훅 구독이 해제됩니다. Catch URL이 남아 있다면 연동 → 웹훅에서 삭제하세요.
- 트래픽이 많은 링크는 기록된 클릭마다 Zap이 한 번씩 실행됩니다. 두 번째 단축 코드를 만들지 말고 Zapier에서 필터링하세요(예:
visitor_variation=qr만).