n8n

n8n có thể kết nối với Letlink theo ba cách khác nhau. Webhook và REST API hoạt động trên Growth và Ultimate. Node MCP Client cần Ultimate. Trang trong ứng dụng là Tích hợp → n8n; trang này hiển thị token và URL MCP của bạn ngay cả khi bạn đã biết tài liệu API.

1. Trình kích hoạt webhook (Growth và Ultimate)

1. Trong n8n, thêm node Webhook. Chuyển sang POST, chế độ production, và sao chép URL production.
2. Dán URL đó vào Letlink Tích hợp → Webhook.
3. Mỗi lượt nhấp được ghi nhận đến dưới dạng đối tượng JSON link_visited. Ánh xạ link_shortcode, visitor_variation, utm_campaign, v.v. vào các node phía sau.

Đây là lựa chọn mặc định phù hợp cho “khi có người nhấp, hãy làm X” — thêm một dòng vào Airtable, thông báo tới một không gian làm việc Slack khác, bổ sung thông tin IP, mở ticket.

2. HTTP Request (Growth và Ultimate)

Dùng node HTTP Request của n8n gọi tới https://letl.ink/api/v1. Đặt header X-API-KEY bằng token từ Tích hợp → n8n. Các lệnh gọi thường dùng:

• GET /auth/me — kiểm tra kết nối.
• GET /links?domain=letl.ink — danh sách liên kết kèm tổng lượt nhấp.
• POST /links với JSON — tạo liên kết rút gọn từ biểu mẫu, CRM hoặc một dòng bảng tính.
• GET /visits — lấy 50 lượt nhấp mới nhất theo lịch nếu bạn không muốn dùng webhook đẩy.

GET https://letl.ink/api/v1/links?domain=letl.ink
Header: X-API-KEY = YOUR_TOKEN

3. MCP Client (Ultimate)

Trỏ node MCP Client của n8n tới Streamable HTTP https://letl.ink/mcp với Authorization: Bearer YOUR_TOKEN. Các công cụ giống hệt những gì Claude và ChatGPT thấy: workspace_summary, list_links, get_link, get_recent_visits, create_link. Dùng cách này khi workflow cần *hỏi* không gian làm việc thay vì tự phân tích JSON từ REST.

Nên chọn cách nào