Webhooks — リンクのクリックをリアルタイムであなたのサーバーへ

Webhooksを使う理由

クリックデータを即座に受け取り、そこから独自のワークフローを構築できます

リアルタイム

クリックが発生した瞬間にイベントが届きます。スケジュールを組んでAPIをポーリングし、更新を待つ必要はありません。

クリックごとの詳細データ

国、都市、端末、OS、ブラウザ、参照元、ボット判定——独自の分析に必要な情報がすべて揃います。

標準でセキュア

すべてのリクエストは自分の秘密鍵でHMAC署名されるため、本物のイベントと偽装リクエストを簡単に見分けられます。

信頼できる配信

サーバーがダウンしている場合は再送されます。すべての試行とステータスは配信ログで確認できます。

活用例

クリックイベントの一般的な送信先

自社の分析基盤やCRM

クリックのたびに自社のデータベースやCRMへ記録し、思い通りのレポートを作成できます。

チャットへの通知

Telegram、Slack、Discordのボットに新しいクリックを即座に通知させ、手作業での確認を不要にします。

自動化

Zapier、Make、n8nでシナリオを実行——クリックイベントがあらゆるアクションのトリガーになります。

Webhookに含まれるデータ

redirects.batchイベント：1つのペイロードに、一定の時間枠内のクリックがまとめて含まれます

{
  "delivery_id": "d_01HXY9F0…",
  "event_type": "redirects.batch",
  "sent_at": "2026-08-04T10:15:00Z",
  "window": { "from": "…10:14:00Z", "to": "…10:15:00Z" },
  "count": 1,
  "truncated": false,
  "events": [
    {
      "event_id":   "e_9f86d0…",
      "link_id":    9053352,
      "datetime":   "2026-08-04T10:14:12Z",
      "country":    "DE",
      "city":       "Berlin",
      "browser":    "Chrome",
      "os":         "Android",
      "device":     "mobile",
      "ref_domain": "t.me",
      "group_id":   null,
      "is_bot":     false
    }
  ]
}

訪問者のIPアドレスは個人情報のため、デフォルトでは送信されません。該当エンドポイントで明示的に有効化した場合のみ含まれます。

Webhooksでできること

柔軟な設定、堅牢なセキュリティ、そして予測可能な配信

バッチ配信

クリックは一定の時間枠でバッチにまとめられて届きます（redirects.batch）。サーバーへのリクエスト数を抑えられます。

配信範囲を自由に選択

アカウント内のすべてのリンク、特定のグループ、または単一のリンク——必要なイベントだけを受け取れます。

HMAC署名

すべてのリクエストは自分の秘密鍵で署名されます。秘密鍵はいつでも再発行できます。

再送と自動無効化

サーバーに到達できない場合は再送されます。応答がないエンドポイントは自動的に無効化されます。

配信ログ

すべての送信履歴をステータスと内容つきで確認可能——問題が起きた原因を簡単に追跡できます。

テスト送信（ping）

実際のトラフィックが来る前にワンクリックで連携を検証——サーバーにテストイベントが届きます。

豊富なイベントデータ

各クリックにlink_id、日時、国、都市、OS、端末、ブラウザ、参照元、ボット判定が含まれます。

デフォルトでプライバシー配慮

特定のエンドポイントで明示的に有効化しない限り、IPアドレスは送信されません。

無料で試す

Webhookの設定方法

5ステップ——サーバーのURL登録からクリックイベントの継続的な受信まで

1

エンドポイントを作成する

Lix.liに登録し、Webhooksセクションを開いて、Lix.liがクリックイベントを送信するサーバーのURLを入力します。

2

配信範囲を選ぶ

どのリンクのイベントを受け取るか決めます：アカウント内のすべてのリンク、特定のグループ、または単一のリンク。

3

署名用の秘密鍵を保存する

Lix.liから秘密鍵が発行されます。すべてのリクエストはHMACで署名されるため、ヘッダーの署名を照合してイベントが確かにLix.liから届いたものか確認できます。

4

テストリクエストを送信する

「テスト」（ping）をクリックし、サーバーがリクエストを受理して2xxを返すことを確認します。実際のトラフィックが来る前に連携を検証できます。

5

配信ログを確認する

ログにはすべての送信、ステータス、再送の記録が表示されます。サーバーに到達できない場合は再送され、応答がないエンドポイントは自動的に無効化されます。

Webhookを設定する

Webhooksに関するよくある質問

Webhookとは何ですか？

Webhookとは、何らかのイベントが発生したときにLix.liが自動的にあなたのサーバーへ送信するHTTP通知です。APIをポーリングする必要はなく、リンクがクリックされた瞬間にデータが自動的に届きます。

どのようなイベントが送信されますか？

短縮リンクへのクリックです。イベントはバッチで届き（event_type = redirects.batch）、各クリックには日時、国、都市、OS、端末、ブラウザ、参照元、ボット判定が含まれます。

データはどのような形式で届きますか？

HTTP POSTによるJSON形式です。本文にはdelivery_id、時間枠、countなどの管理用フィールドと、各クリックのデータを含むevents配列が含まれます。リクエスト本文の完全な例はこのページに掲載しています。

リクエストが本当にLix.liから届いたものか、どう確認しますか？

すべてのリクエストは秘密鍵をもとにHMACで署名されています。ヘッダーの署名をリクエスト本文と照合すれば、偽装リクエストを排除できます。秘密鍵はいつでも再発行（ローテーション）可能です。

サーバーが一時的にダウンしている場合はどうなりますか？

配信は自動的に再試行されます。エンドポイントが長時間応答しない場合は一時的に無効化されますが、すべての試行とステータスは配信ログに残るため、気づかないうちにイベントが失われることはありません。

特定のリンクのイベントだけを受け取ることはできますか？

できます。配信範囲を選択可能です：アカウント内のすべてのリンク、特定のグループのリンク、または単一のリンク。これにより不要なトラフィックがサーバーに届くことを防げます。

訪問者のIPアドレスは送信されますか？

デフォルトでは送信されません。個人情報にあたるためです。IPアドレスは、該当エンドポイントの設定で明示的に有効化した場合のみイベントに含まれます。

Webhooksはどのプランで利用できますか？

WebhooksはPremiumプランでご利用いただけます。登録してPremiumにアップグレードすると、エンドポイントを接続できます。

クリックイベントを起点に独自の連携を構築する

数分でWebhookを設定して、クリックデータを必要な場所へ届けましょう。

Lix.liのWebhooksは、短縮リンクのクリック通知を自動的に受け取る仕組みです。APIを常にポーリングする代わりに、サーバーのURLを登録しておくだけで、Lix.liがクリックの瞬間にそこへHTTP POSTを送信します。これは短縮リンクにおける典型的なHTTPコールバック であり、クリックイベントをリアルタイムで自社システムへ届けます。

すべてのリクエスト本文はredirects.batchイベントで、クリックの配列を含みます。各クリックには日時、国、都市、ブラウザ、OS、端末、参照元、ボット判定が含まれます。このデータを自社のデータベースや CRMに保存したり、Telegram、Slack、Discordへのクリック通知に変換したり、Zapier、Make、n8nのトリガーとして利用したりできます。リクエストはHMAC署名によって保護されており、ヘッダーの署名を照合して偽装を排除でき、必要に応じて秘密鍵を再発行することもできます。

配信は予測可能です。サーバー障害時にはイベントが再送され、応答のないエンドポイントは一時的に無効化され、すべての試行が配信ログに記録されます。配信範囲はすべてのリンク、特定のグループ、単一のリンクに限定でき、実際のトラフィックが来る前にテスト送信（ping）で連携を検証することも可能です。Webhooksは通常の Lix.liの短縮リンク、QRコード、統計機能と併用でき、Premiumプランでご利用いただけます。