Webhooks

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

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

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

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

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

الأحداث

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

حمولة Webhook

حمولة النقر

عند حدوث نقرة، يرسل 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": {
    "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 في حمولة webhook.

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

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

{
  "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 بآلاف التطبيقات بدون كود

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

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

عناوين URLs متعددة للويبهوك

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

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

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

الأمان

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

الاختبار

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

وصول API

يمكنك أيضاً إدارة webhooks برمجياً عبر 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 للتفاصيل.