n8n

يمكن أن يعمل n8n أمام Letlink بثلاث طرق مختلفة. تعمل Webhooks وREST API في Growth وUltimate. أما عقدة MCP Client فتتطلب Ultimate. والصفحة داخل التطبيق هي التكاملات ← n8n؛ وتعرض رمزك ورابط MCP حتى لو كنت تعرف وثائق API بالفعل.

1. مشغّل Webhook (Growth وUltimate)

1. في n8n، أضف عقدة Webhook. بدّلها إلى POST ووضع الإنتاج، وانسخ رابط الإنتاج.
2. الصق هذا الرابط ضمن التكاملات ← Webhooks في Letlink.
3. تصل كل نقرة مسجّلة ككائن JSON ‏link_visited. اربط link_shortcode وvisitor_variation وutm_campaign وغيرها بالعقد اللاحقة.

هذا هو الخيار الافتراضي المناسب لسيناريو «عندما ينقر أحدهم، افعل كذا» — أضف صفًا في Airtable، أو أرسل إشعارًا إلى مساحة عمل Slack أخرى، أو أثرِ بيانات عنوان IP، أو افتح تذكرة.

2. HTTP Request (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 نقرة وفق جدول زمني إذا كنت لا تريد Webhook للدفع.

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

3. MCP Client (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 بنفسه.

أيها تختار