Webhooks

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

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

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

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

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

เหตุการณ์

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

Webhook payload

Click payload

เมื่อเกิดคลิก Linkly จะส่งคำขอ POST ที่มี JSON payload ดังต่อไปนี้:

{
  "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"
    }
  }
}

Payload fields

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

ออบเจ็กต์ลิงก์

ออบเจ็กต์คลิก

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

Link lifecycle payload

เหตุการณ์ 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": []
  }
}

การรวม Automation platform

สำหรับการตั้งค่าที่ง่ายขึ้นโดยไม่จำเป็นต้องเขียนโค้ดแบบกำหนดเอง ให้ใช้การรวมแบบเนทีฟของเรา:

• Make Integration - แพลตฟอร์ม automation ที่มีภาพ พร้อมกับ instant click triggers
• Zapier Integration - เชื่อมต่อ Linkly กับแอปพลิเคชันหลายพันตัวโดยไม่มีโค้ด

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

Best practices

Multiple webhooks

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

Error handling

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

ความปลอดภัย

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

การทดสอบ

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

API access

คุณยังสามารถจัดการ 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 Documentation สำหรับรายละเอียด