خطافات الويب

تتيح لك خطافات الويب تلقي إشعارات فورية حول روابطك — سواء عند النقر عليها أو عند إنشاؤها أو تحديثها أو حذفها. يرسل Linkly طلب POST إلى عنوان URL المحدد لديك مع معلومات مفصلة حول كل حدث.

حالات الاستخدام

• منصات الأتمتة: تشغيل سير العمل في Make أو Zapier عند النقر على الروابط
• التحليلات المخصصة: إرسال بيانات النقرات إلى نظام التحليلات الخاص بك
• تحديثات CRM: تحديث سجلات العملاء عند نقرهم على الروابط
• إشعارات Slack: احصل على إشعارات في Slack عند النقر على روابط مهمة
• تتبع العملاء المحتملين: تتبع متى يتفاعل العملاء المحتملون مع روابطك

نصيحة: لمعظم حالات الأتمتة، يعتبر تكامل Make أو تكامل Zapier أسهل في الإعداد من خطافات الويب المخصصة. وهي تتضمن محفزات نقرات فورية مدعومة بخطافات الويب، بدون الحاجة إلى أي برمجة.

ملاحظة: إذا قمت بتكوين خطافات ويب في كلا المستويين، فستعمل كلاهما عند النقر على ذلك الرابط.

الأحداث

يتلقى كل خطاف ويب جميع أنواع الأحداث لنطاقه — خطاف ويب على مستوى الرابط يحصل على أحداث لذلك الرابط، وخطاف ويب على مستوى مساحة العمل يحصل على أحداث لكل رابط في مساحة العمل. تحقق من حقل event في المستوى الأعلى للتمييز بينها:

حمولة خطاف الويب

حمولة النقرة

عند حدوث نقرة، يرسل Linkly طلب POST برسالة JSON بالصيغة التالية:

{
  "event": "click",
  "timestamp": "2025-01-15T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.com",
    "slug": "/abc123",
    "destination": "https://example.com/landing-page",
    "workspace_id": 1,
    "enabled": true,
    "cloaking": false,
    "forward_params": true,
    "block_bots": true,
    "public_analytics": false,
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "spring-sale",
    "og_title": "Special Offer",
    "og_description": "Check out our spring sale!",
    "rules": [
      {
        "what": "country",
        "matches": "US",
        "url": "https://example.com/us-landing"
      }
    ]
  },
  "click": {
    "id": "01KYPGEEPJSPR3S564QRBDGA1W",
    "country": "US",
    "is_eu_country": false,
    "platform": "desktop",
    "browser_name": "Chrome",
    "referer": "https://twitter.com/",
    "isp": "Comcast",
    "bot_name": null,
    "destination": "https://example.com/landing-page",
    "params": {
      "utm_source": "twitter"
    }
  }
}

حقول الحمولة

معلومات الحدث

كائن الرابط

كائن النقرة

ملاحظة الخصوصية: عناوين IP لا تُضمن أبداً في حمولات خطافات الويب.

حمولة دورة حياة الرابط

تشترك الأحداث link.created و link.updated و link.deleted في شكل واحد. لا يوجد كائن click — تحصل على event و timestamp والرابط الكامل:

{
  "event": "link.created",
  "timestamp": "2026-06-20T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.com",
    "slug": "/abc123",
    "workspace_id": 1,
    "enabled": true,
    "rules": []
  }
}

تكاملات منصات الأتمتة

لإعداد أسهل بدون برمجة مخصصة، استخدم التكاملات الأصلية الخاصة بنا:

• تكامل Make - منصة أتمتة مرئية مع محفزات نقرات فورية
• تكامل Zapier - قم بتوصيل Linkly بآلاف التطبيقات بدون رمز

كلا التكاملين يستخدمان خطافات الويب تحت الغطاء ولكنهما يتعاملان مع كل الإعداد تلقائياً.

أفضل الممارسات

خطافات الويب المتعددة

يمكنك إضافة عناوين URL متعددة لخطاف الويب (واحد في كل سطر). ستتلقى جميع عناوين URL نفس الحمولة عند حدوث نقرة.

معالجة الأخطاء

• خطافات الويب إطلاق بدون متابعة - لا يعيد Linkly محاولة التسليمات الفاشلة
• فشل خطاف الويب لا يؤثر أبداً على إعادة التوجيه - يصل المستخدمون دائماً إلى وجهتهم
• تأكد من أن نقطة نهاية خطاف الويب تستجيب بسرعة (أقل من 5 ثوان موصى به)

الأمان

• استخدم نقاط نهاية HTTPS لعناوين URL خطاف الويب
• تحقق من الطلبات الواردة في معالج خطاف الويب
• فكر في إضافة معامل سري إلى عنوان URL خطاف الويب للتحقق

الاختبار

1. 1
   قم بإعداد عنوان URL لخطاف الويب باستخدام خدمة مثل webhook.site أو RequestBin
2. 2
   انقر على رابطك
3. 3
   افحص الحمولة المستلمة
4. 4
   بمجرد التحقق، انتقل إلى عنوان URL خطاف الويب الخاص بك في الإنتاج

وصول API

يمكنك أيضاً إدارة خطافات الويب برمجياً عبر API:

POST   /api/v1/link/:link_id/webhooks
DELETE /api/v1/link/:link_id/webhooks/:hook_id
GET    /api/v1/link/:link_id/webhooks

POST   /api/v1/workspace/:workspace_id/webhooks
DELETE /api/v1/workspace/:workspace_id/webhooks/:hook_id
GET    /api/v1/workspace/:workspace_id/webhooks

راجع وثائق API للتفاصيل.