あなたのサーバーがすべてのInfluticsイベントを受信

    HTTPSエンドポイントを1つ登録し、クリエイター・動画・統計イベントを署名付きJSONで受け取る。

    • 全イベントに署名付きPOST
    • 4種のイベントタイプ
    • テストping付き
    • リトライ間で同一id

    サーバーが受け取る内容

    POST your-url  HTTP/1.1
    X-Influtics-Event: video.created
    X-Influtics-Delivery-Id: 3f2b0c9e-…
    X-Influtics-Signature: ts=1763456122;h1=9f86d081…
    
    {
      "id": "3f2b0c9e-…",
      "type": "video.created",
      "organization_id": "9f1d2b6e-…",
      "occurred_at": "2026-11-18T09:15:22.418Z",
      "data": { "video_id": "6c2a0f4e-…", … }
    }

    動画の全ジャーニーのイベント

    4つすべてか、使うものだけを購読。各リトライは同じボディを運ぶ。

    あなたのサーバー

    signed POST in, 200 out

    上記の各イベントは署名付き配信としてここに届く。creator.trackedはトラッキング開始時に発行。video.deletedは動画が消えたときに発行。全カタログ:

    イベント内容
    creator.trackedクリエイターのトラッキングを開始。blogger id・プラットフォーム・チャンネル名を含む。
    video.created新しい動画を登録。video id・blogger id・external video idを含む。
    stats.updatedトラッキング動画の最新数値。video idとexternal video idを含む。
    video.deletedトラッキング動画が消去。video id・blogger id・external video idを含む。

    生ボディで検証

    タイムスタンプ+生バイトから署名を再計算し、定数時間で比較、5分のずれを許容。

    配信の形状

    signed = ts + ":" + rawBody
    key    = base64(secret)  // 32 bytes
    h1     = hmac_sha256(key, signed)

    verify.js

    import crypto from 'node:crypto'
    
    const key = Buffer.from(secret, 'base64')
    const expected = crypto
      .createHmac('sha256', key)
      .update(ts + ':' + rawBody, 'utf8')
      .digest('hex')
    const ok = crypto.timingSafeEqual(
      Buffer.from(expected, 'hex'),
      Buffer.from(h1, 'hex'),
    )

    ローテーション後は、まず現在のシークレットを試し、24時間は前のものも試す。

    はじめる

    設定→連携→WebhookでHTTPSエンドポイントを保存し、イベントを選択、一度だけ表示されるシークレットをコピーし、テストpingを検証してからハンドラーを記述。セットアップ自体は約10分。

    アプリでセットアップ

    要件:

    • 管理者権限を持つ有効なInfluticsアカウント
    • 安定したホスト名の公開HTTPSエンドポイント
    • パース前に生リクエストボディを読むコード

    受信者からの質問

    関連する連携

    Webhooksとシームレスに連携する他の連携を探す。

    REST API

    REST API

    REST APIであらゆるデータをオンデマンド取得 — webhookプッシュの補完に。

    詳しく見る
    n8n

    n8n

    Influticsをビジュアルワークフローに — webhookからn8nフローを起動、ノードでポーリング。

    詳しく見る

    Webhooks連携を今すぐ始める

    WebhooksをInfluticsに接続し、強力な分析でインフルエンサーマーケティングキャンペーンの追跡を開始。

    100K+

    追跡された動画

    50M+

    分析されたデータポイント

    99.9%

    稼働率