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 طلب POST إلى /api/v1/hooks/subscribe مع رابط Catch الخاص به. ثم تُرسَل كل نقرة مسجلة بطلب POST بصيغة حمولة Webhook (راجع Webhooks). وأثناء ربط الحقول، قد يستدعي 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 وغيرها). الأنواع الذكية في الخطة المجانية ومساحات العمل التي تجاوزت الحد تُرجع خطأً في سجل تشغيل الـ Zap.

ملاحظات تشغيلية

• إعادة إنشاء الرمز في Letlink تقطع اتصال Zapier حتى تلصق القيمة الجديدة.
• يُفترض أن يؤدي إيقاف الـ Zap إلى إلغاء اشتراك الـ Hook. إذا بقي رابط Catch، فاحذفه من التكاملات ← Webhooks.
• ستُنتج الروابط ذات الزيارات الكثيفة تشغيلًا واحدًا لـ Zap لكل نقرة مسجّلة. صفِّ في Zapier (مثلًا visitor_variation = qr فقط) بدلًا من تسجيل رمز قصير ثانٍ.