Webhooks

Webhooks อนุญาตให้คุณรับการแจ้งเตือนแบบเรียลไทม์เกี่ยวกับลิงก์ของคุณ — ทั้งเมื่อมีการคลิกและเมื่อสร้าง อัปเดต หรือลบ Linkly ส่งคำขอ POST ไปยัง URL ที่ระบุของคุณพร้อมข้อมูลโดยละเอียดเกี่ยวกับแต่ละเหตุการณ์

กรณีการใช้งาน

• แพลตฟอร์มอัตโนมัติ: เริ่มต้นเวิร์กโฟลว์ใน Make หรือ Zapier เมื่อคลิกลิงก์
• Analytics ที่กำหนดเอง: ส่งข้อมูลการคลิกไปยังระบบ analytics ของคุณเอง
• อัปเดต CRM: อัปเดตบันทึกลูกค้าเมื่อพวกเขาคลิกลิงก์
• Slack Notifications: รับการแจ้งเตือนใน Slack เมื่อคลิกลิงก์ที่สำคัญ
• Lead Tracking: ติดตามเมื่อลูกค้าเข้าร่วมกับลิงก์ของคุณ

เคล็ดลับ: สำหรับกรณีการใช้งานการทำให้อัตโนมัติส่วนใหญ่ Make integration หรือ Zapier integration ของเราจะง่ายกว่าการตั้งค่า webhooks ที่กำหนดเอง พวกเขารวมการเริ่มต้นการคลิกแบบทันที่ที่ขับเคลื่อนโดย webhooks โดยไม่ต้องเขียนโค้ด

หมายเหตุ: หากคุณกำหนดค่า webhooks ในทั้งสองระดับ ทั้งสองอย่างจะทำงานสำหรับการคลิกบนลิงก์นั้น

เหตุการณ์

ทุก webhook ได้รับเหตุการณ์ทั้งหมดสำหรับขอบเขตของมัน — webhook ระดับลิงก์ได้รับเหตุการณ์สำหรับลิงก์นั้น webhook ระดับพื้นที่ทำงานได้รับเหตุการณ์สำหรับลิงก์ทุกรายการในพื้นที่ทำงาน ตรวจสอบฟิลด์ event ระดับบนสุดเพื่อแยกแยะพวกมัน:

Webhook payload

Click payload

เมื่อเกิดการคลิก Linkly ส่งคำขอ POST พร้อม payload 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"
    }
  }
}

ฟิลด์ Payload

ข้อมูลเหตุการณ์

วัตถุลิงก์

วัตถุคลิก

หมายเหตุความเป็นส่วนตัว: ไม่มีการรวม IP address ใน webhook payloads

Link lifecycle payload

เหตุการณ์ 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 Integration - แพลตฟอร์มอัตโนมัติด้วยภาพพร้อมการเริ่มต้นการคลิกแบบทันที่
• Zapier Integration - เชื่อมต่อ Linkly กับแอปพลิเคชันนับพันโดยไม่ต้องเขียนโค้ด

ทั้งการรวมใช้ webhooks ภายใต้ประทุน แต่จัดการการตั้งค่าทั้งหมดโดยอัตโนมัติ

Best practices

Webhooks หลายรายการ

คุณสามารถเพิ่ม URL webhook หลายรายการ (หนึ่งต่อบรรทัด) ได้ URL ทั้งหมดจะได้รับ payload เดียวกันเมื่อเกิดการคลิก

การจัดการข้อผิดพลาด

• Webhooks คือ fire-and-forget - Linkly ไม่พยายามส่งใหม่สำหรับการส่งที่ล้มเหลว
• ความล้มเหลวของ webhook ไม่มีผลต่อการเปลี่ยนเส้นทาง — ผู้ใช้ไปถึงปลายทางเสมอ
• ตรวจสอบว่า webhook endpoint ตอบสนองอย่างรวดเร็ว (< 5 วินาทีแนะนำ)

ความปลอดภัย

• ใช้ HTTPS endpoints สำหรับ URL webhook
• ตรวจสอบคำขอขาเข้าใน webhook handler ของคุณ
• พิจารณาเพิ่มพารามิเตอร์ลับลงใน URL webhook ของคุณเพื่อการตรวจสอบ

ทดสอบ

1. 1
   ตั้งค่า URL webhook โดยใช้บริการเช่น webhook.site หรือ RequestBin
2. 2
   คลิกลิงก์ของคุณ
3. 3
   ตรวจสอบ payload ที่ได้รับ
4. 4
   เมื่อตรวจสอบแล้ว ให้เปลี่ยนไปใช้ URL webhook การผลิตของคุณ

API access

คุณยังสามารถจัดการ webhooks โดยใช้ prograสามารถผ่าน 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 Documentation สำหรับรายละเอียด