ウェブフック

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

ユースケース

  • オートメーションプラットフォーム: リンクがクリックされた時にMakeまたはZapierでワークフローをトリガー
  • カスタム分析: クリックデータを独自の分析システムに送信
  • CRM更新: リンクをクリックした時に顧客レコードを更新
  • Slack通知: 重要なリンクがクリックされた時にSlackで通知を受け取る
  • リード追跡: 見込み客がリンクにエンゲージした時を追跡

ヒント: ほとんどのオートメーション用途では、カスタムウェブフックよりもMake統合またはZapier統合の方が簡単に設定できます。コーディング不要で、ウェブフック搭載の即座クリックトリガーが含まれています。

リンクレベルのウェブフックを設定する方法

1

リンクに移動して、設定したいリンクをクリックします。

2

ウェブフックセクションまでスクロールダウンします。

3

ウェブフックURL(複数可)を1行に1つずつ入力します。

複数のウェブフックURLを追加できます。リンクがクリックされた時、すべてのURLが同じペイロードを受け取ります。

ウェブフックURL(複数可)を1行に1つずつ入力します。
ウェブフックURL(複数可)を1行に1つずつ入力します。
4

保存をクリックします。

リンクレベルのウェブフックは、その特定のリンクがクリックされた時のみ発火します。

ワークスペースレベルのウェブフックを設定する方法

1

設定(サイドバーの歯車アイコン)に移動します。

2

ワークスペース設定をクリックします。

3

ウェブフックURL(複数可)を1行に1つずつ入力します。

複数のウェブフックURLを追加できます。ワークスペース内のいずれかのリンクがクリックされた時、すべてのURLが同じペイロードを受け取ります。

ウェブフックURL(複数可)を1行に1つずつ入力します。
ウェブフックURL(複数可)を1行に1つずつ入力します。
4

設定を保存をクリックします。

ワークスペースレベルのウェブフックは、ワークスペース内のいずれかのリンクがクリックされた時のすべてのクリックで発火します。

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

イベント

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

event送信される条件
clickショートリンクがクリックされた時。訪問者のリクエストデータを含むclickオブジェクトが含まれます。
link.createdワークスペースで新しいリンクが作成された時。
link.updatedリンクの設定が変更された時。自動保存編集を含むすべての更新で発火するため、編集セッションごとに複数受け取る可能性があります。
link.deletedリンクが削除された時。linkオブジェクトは削除前に持っていたスラッグとドメインを保持します。

ウェブフックペイロード

クリックペイロード

クリックが発生したとき、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",
    "metadata": {
      "order_id": "A-10293",
      "crm_contact_id": "3f2b8c1e-9a47-4d0e-b6a5-1c2d3e4f5a6b"
    },
    "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"
    }
  }
}

ペイロードフィールド

イベント情報

フィールド説明
eventclick、link.created、link.updated、またはlink.deleted
timestampクリックのISO 8601タイムスタンプ

リンクオブジェクト

フィールド説明
id一意のリンク識別子
nameリンクのニックネーム
url元の宛先URL
full_urlショートリンクURL
domainカスタムドメイン(設定されている場合)
slugURLパス/スラッグ
metadataリンクに付与された独自のキー値データ(例えば、自社システムのID)。常にオブジェクトで、設定されていない場合は空です。リンクメタデータを参照
destinationこのクリックの実際の宛先(ルールが適用された場合はurlと異なる場合があります)
workspace_idワークスペース識別子
enabledリンクがアクティブかどうか
rulesリダイレクトルール(地域、デバイス、ローテーター)の配列
utm_*設定されている場合のUTMパラメーター
og_*設定されている場合のOpenGraphの設定

クリックオブジェクト

フィールド説明
idこのクリックの一意識別子で、26文字のULID。先頭の文字はクリック時刻をエンコードしているため、IDは平文の文字列として時系列でソートされます
country2文字の国コード(例:"US"、"GB")
is_eu_countryクリックがEUから発生したかどうか
platformデバイスプラットフォーム(desktop、ios、android等)
browser_nameブラウザ名(Chrome、Safari、Firefoxなど)
referer参照URL(利用可能な場合)
ispインターネットサービスプロバイダー
bot_nameボット識別子(人間のクリックではnull)
destinationこのクリックの最終宛先URL
paramsリンクに渡されたクエリパラメーター

プライバシー注記: 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,
    "metadata": {
      "order_id": "A-10293"
    },
    "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ドキュメントを参照してください。

ウェブフックFAQ

ウェブフックはどのようなイベントを送信できますか?

ウェブフックはペイロードのイベントフィールドで識別される4つのイベントで発火します。リンクがクリックされた時にclickが得られ、リンクが変更された時にlink.created、link.updated、およびlink.deletedが得られます。すべてのウェブフックはそのスコープのすべてのイベントタイプを受け取るため、各イベントを処理するためにイベントフィールドで分岐します。

ウェブフックが発火しないのはなぜですか?

ウェブフックURLが有効でアクセス可能であり、ウェブフックがリンクまたはワークスペースに保存されていることを確認してください。クリックイベントの場合、クリックが実際に記録される時のみウェブフックが発火することに注意してください。除外されたIPまたはスキップされたクローラーはトリガーしません。

ウェブフックペイロードの一部のフィールドがnullなのはなぜですか?

情報が利用できない場合(例えばリファラーがない場合)、プライバシー設定が収集を防止した場合、またはクリックがボットからのものの場合(その場合bot_nameが入力されます)、一部のフィールドはnullになる可能性があります。

Linklyは失敗したウェブフック配信を再試行しますか?

いいえ。ウェブフックはファイア・アンド・フォーゲットです。失敗した配信は再試行されず、Linklyはウェブフック配信ステータスを追跡しません。ウェブフックリクエストは5秒後にタイムアウトします。

Linklyはコンバージョントラッキング用のポストバックをサポートしていますか?

いいえ。Linklyウェブフックは送信のみで、クリックが発生した時に発火します。アフィリエイトネットワークまたはプラットフォームからポストバックデータを受け取ることはできません。コンバージョントラッキングの場合は、宛先プラットフォームのネイティブトラッキングを使用するか、クエリパラメーター転送経由でクリックIDを渡すか、BigQuery統合を使用してクリックデータをコンバージョンデータと結合してください。

ウェブフックを使用すべきか、それともMake/Zapierを使用すべきか?

ほとんどのオートメーション用途では、MakeまたはZapier統合の方が設定が簡単です。これらはバックグラウンドでウェブフックを使用していますが、すべての設定を自動的に処理します。独自のシステムにデータを送信する必要がある場合、または統合をより細かく制御する必要がある場合は、カスタムウェブフックを使用します。

リンクとワークスペースの両方にウェブフックを設定できますか?

はい。両方のレベルでウェブフックを設定した場合、そのリンクがクリックされた時に両方が発火します。これは、ワークスペース全体のログに加えて特定のリンクの特定のアクションが必要な場合に便利です。

誰がwebhooksをセットアップできますか?

単一リンク上のwebhooksには書き込みロール以上が必要です。ワークスペースwebhooksには管理者またはオーナーのロールが必要です。ユーザーロールと権限を参照してください。

対応プラン

Business以上で利用可能

プランを比較 →

毎月500クリックを無料で追跡できます。