Zapier

Zapier اسی REST API سے بات کرتا ہے جس سے آپ کی اپنی اسکرپٹس۔ آپ کو Growth یا Ultimate ورک اسپیس اور Integrations ← Zapier (یا API — یہ وہی ٹوکن ہے) سے ایک API ٹوکن درکار ہے۔

ایپ جوڑیں

1. Zapier میں Letlink کنکشن شامل کریں اور مانگے جانے پر API ٹوکن پیسٹ کریں۔
2. Zapier اس کی تصدیق کے لیے GET /api/v1/auth/me کو کال کرتا ہے۔
3. اگر ٹیسٹ 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)۔