เว็บฮุก

เว็บฮุกช่วยให้คุณได้รับการแจ้งเตือนแบบเรียลไทม์เกี่ยวกับลิงก์ของคุณ — ทั้งเมื่อถูกคลิก และเมื่อสร้าง อัปเดต หรือลบ 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, และ 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 กับหลายพันแอปโดยไม่ต้องเขียนโค้ด

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

แนวปฏิบัติที่ดีที่สุด

เว็บฮุกหลายตัว

คุณสามารถเพิ่มหลาย 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 สำหรับรายละเอียด