Zapier

Zapier আপনার নিজের স্ক্রিপ্টের মতোই একই REST API ব্যবহার করে। আপনার দরকার একটি Growth বা Ultimate ওয়ার্কস্পেস এবং ইন্টিগ্রেশন → 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)।