ウェブフック

ウェブフックを使用すると、リンクについてのリアルタイム通知を受け取ることができます。リンクがクリックされたときだけでなく、作成、更新、削除されたときにも通知を受け取れます。Linklyは、各イベントに関する詳細情報を含むPOSTリクエストを指定されたURL(複数可)に送信します。

ユースケース

• 自動化プラットフォーム: MakeまたはZapierでリンクがクリックされたときにワークフローをトリガーする
• カスタム分析: クリックデータを独自の分析システムに送信する
• CRM更新: 顧客がリンクをクリックしたときに顧客レコードを更新する
• Slack通知: 重要なリンクがクリックされたときにSlackで通知を受け取る
• リード追跡: 見込み客がリンクにどのように関与しているかを追跡する

ヒント: ほとんどの自動化ユースケースの場合、カスタムウェブフックよりもMake統合またはZapier統合の方がセットアップが簡単です。これらには、コーディング不要でウェブフックによって実現される即座なクリックトリガーが含まれています。

注: 両方のレベルでウェブフックを設定した場合、そのリンクへのクリックに対して両方とも発火します。

イベント

すべてのウェブフックはそのスコープのすべてのイベントタイプを受け取ります。リンクレベルのウェブフックはそのリンクのイベントを取得し、ワークスペースレベルのウェブフックはワークスペース内のすべてのリンクのイベントを取得します。トップレベルのeventフィールドをチェックして区別してください:

ウェブフックペイロード

クリックペイロード

クリックが発生すると、Linklyは次のJSONペイロードを含むPOSTリクエストを送信します:

{
  "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アドレスはウェブフックペイロードに含まれることはありません。

リンクライフサイクルペイロード

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(1行に1つ)を追加できます。クリックが発生すると、すべてのURLが同じペイロードを受け取ります。

エラーハンドリング

• ウェブフックは火災と忘れです - Linklyは失敗した配信を再試行しません
• ウェブフックの失敗はリダイレクトに影響を与えません - ユーザーは常に目的地に到達します
• ウェブフックエンドポイントがすばやく応答することを確認してください(推奨:5秒未満)

セキュリティ

• ウェブフックURLにはHTTPSエンドポイントを使用してください
• ウェブフックハンドラーで受信リクエストを検証してください
• 検証のためにウェブフックURLにシークレットパラメータを追加することを検討してください

テスト

1. 1
   webhook.siteまたはRequestBinなどのサービスを使用してウェブフックURLをセットアップします
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ドキュメンテーションを参照してください。