Zapier

Zapier giao tiếp với cùng REST API như các script của riêng bạn. Bạn cần không gian làm việc Growth hoặc Ultimate và một API token từ Tích hợp → Zapier (hoặc API — đó là cùng một token).

Kết nối ứng dụng

1. Trong Zapier, thêm kết nối Letlink và dán API token khi được yêu cầu.
2. Zapier gọi GET /api/v1/auth/me để xác minh.
3. Nếu kiểm tra thất bại với lỗi 403, gói của không gian làm việc chưa bao gồm API — hãy nâng cấp lên Growth.

Trigger: liên kết được truy cập

Đây là REST Hook cho sự kiện link_visited. Khi bạn bật Zap, Zapier sẽ POST tới /api/v1/hooks/subscribe kèm Catch URL của nó. Sau đó, mỗi lượt nhấp được ghi nhận sẽ được POST theo cấu trúc payload webhook (xem Webhook). Trong lúc bạn ánh xạ trường, Zapier cũng có thể gọi GET /api/v1/visits để lấy các dòng mẫu — endpoint đó trả về 50 lượt nhấp gần nhất với cùng cấu trúc.

Các trường hữu ích trong Zap: link_shortcode, link_destination_url, visitor_device_type, visitor_browser, visitor_referrer, visitor_variation, utm_source, utm_campaign, instagram_username.

Hành động: tạo liên kết

Tương ứng với POST /api/v1/links. Bạn có thể truyền type, destination, short_code, title, domain và các trường của loại thông minh (ios_url, android_url, v.v.). Loại thông minh trên gói Free và không gian làm việc vượt giới hạn sẽ trả về lỗi vào nhật ký chạy của Zap.

Ghi chú vận hành

• Tạo lại token trong Letlink sẽ làm mất kết nối Zapier cho đến khi bạn dán giá trị mới.
• Tắt Zap sẽ hủy đăng ký hook. Nếu một Catch URL còn sót lại, hãy xóa nó trong Tích hợp → Webhook.
• Liên kết có lưu lượng lớn sẽ tạo một lần chạy Zap cho mỗi lượt nhấp được ghi nhận. Hãy lọc trong Zapier (ví dụ chỉ khi visitor_variation = qr) thay vì tạo mã rút gọn thứ hai.