ウェブフック

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

ユースケース

• 自動化プラットフォーム: 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": {
    "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(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 ドキュメントを参照してください。