Zapier

Zapier با همان REST API کار می‌کند که اسکریپت‌های خودتان. به یک فضای کاری Growth یا Ultimate و یک توکن API از یکپارچه‌سازی‌ها ← Zapier (یا API — همان توکن است) نیاز دارید.

اتصال اپ

1. در Zapier، اتصال Letlink را اضافه کنید و وقتی خواسته شد، توکن API را جای‌گذاری کنید.
2. Zapier برای تأیید آن GET /api/v1/auth/me را فراخوانی می‌کند.
3. اگر آزمایش با خطای 403 ناموفق شد، پلن فضای کاری هنوز شامل API نیست — به Growth ارتقا دهید.

تریگر: یک لینک بازدید شد

این یک REST Hook روی رویداد link_visited است. وقتی Zap را روشن می‌کنید، Zapier با Catch URL خود به /api/v1/hooks/subscribe درخواست POST می‌فرستد. سپس هر کلیک ثبت‌شده با ساختار payload وب‌هوک 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).