n8n

n8n می‌تواند به سه روش مختلف جلوی Letlink قرار بگیرد. وب‌هوک‌ها و REST API در Growth و Ultimate کار می‌کنند. گره MCP Client به Ultimate نیاز دارد. صفحه داخل اپ یکپارچه‌سازی‌ها ← n8n است؛ حتی اگر مستندات API را بشناسید، توکن و URL سرور MCP را نشان می‌دهد.

1. تریگر وب‌هوک (Growth و Ultimate)

1. در n8n، یک گره Webhook اضافه کنید. آن را روی POST و حالت production تنظیم کنید و URL محیط عملیاتی را کپی کنید.
2. آن URL را در Letlink در یکپارچه‌سازی‌ها ← وب‌هوک‌ها جای‌گذاری کنید.
3. هر کلیک ثبت‌شده به‌صورت شیء JSON با نام link_visited می‌رسد. link_shortcode، visitor_variation، utm_campaign و غیره را به گره‌های بعدی نگاشت کنید.

این پیش‌فرض مناسب برای «وقتی کسی کلیک کرد، X را انجام بده» است — افزودن یک ردیف به Airtable، اطلاع‌رسانی به یک فضای کاری دیگر Slack، غنی‌سازی IP، باز کردن یک تیکت.

2. درخواست HTTP (Growth و Ultimate)

از نود HTTP Request در n8n روی https://letl.ink/api/v1 استفاده کنید. هدر X-API-KEY را برابر توکنی قرار دهید که از یکپارچه‌سازی‌ها ← n8n می‌گیرید. فراخوانی‌های رایج:

• GET /auth/me — آزمایش اتصال.
• GET /links?domain=letl.ink — فهرست لینک‌ها به همراه مجموع کلیک‌ها.
• POST /links با JSON — ساخت لینک کوتاه از یک فرم، یک CRM یا یک ردیف صفحه‌گسترده.
• GET /visits — اگر وب‌هوک ارسالی نمی‌خواهید، 50 کلیک آخر را به‌صورت زمان‌بندی‌شده دریافت کنید.

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

3. کلاینت MCP (Ultimate)

گره MCP Client در n8n را به Streamable HTTP با آدرس https://letl.ink/mcp و Authorization: Bearer YOUR_TOKEN اشاره دهید. ابزارها همان‌هایی هستند که Claude و ChatGPT می‌بینند: workspace_summary، list_links، get_link، get_recent_visits، create_link. وقتی گردش کار باید از فضای کاری *سؤال بپرسد* به جای اینکه خودش JSON مربوط به REST را تجزیه کند، از این استفاده کنید.

کدام را انتخاب کنید