Webhook

Webhookを使用すると、リンクがクリックされたときにリアルタイム通知を受け取ることができます。クリックが発生すると、Linklyは指定されたURL宛てにクリックの詳細情報を含むPOSTリクエストを送信します。

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

ヒント: ほとんどの自動化ユースケースでは、Make連携またはZapier連携の方がカスタムWebhookよりも簡単に設定できます。コード不要で、Webhookを利用した即時クリックトリガーが含まれています。

注意: 両方のレベルでWebhookを設定した場合、そのリンクのクリックに対して両方が発火します。

クリックが発生すると、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アドレスはWebhookペイロードに含まれません。

カスタムコーディングなしで簡単に設定するには、ネイティブ連携をご利用ください：

• Make連携 - 即時クリックトリガー付きのビジュアル自動化プラットフォーム
• Zapier連携 - コード不要でLinklyを数千のアプリに接続

両方の連携は内部的にWebhookを使用していますが、すべての設定を自動的に処理します。

複数のWebhook URL（1行に1つ）を追加できます。クリックが発生すると、すべてのURLに同じペイロードが送信されます。

• Webhookはファイア・アンド・フォーゲット方式です — Linklyは失敗した配信を再試行しません
• Webhookの失敗はリダイレクトに影響しません — ユーザーは常に目的地に到達します
• Webhookエンドポイントが素早く応答するようにしてください（5秒未満推奨）

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

1. 1webhook.siteやRequestBinなどのサービスを使用してWebhook URLを設定
2. 2リンクをクリック
3. 3受信したペイロードを検査
4. 4確認後、本番用Webhook URLに切り替え

APIを使用してWebhookをプログラムで管理することもできます：

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ドキュメントを参照してください。