ウェブフックの設定 - Pubrio Documentation

ウェブフックはモニター結果を受信する推奨方法です。モニターがトリガーすると、Pubrioは設定されたURLにJSONペイロードを含むPOSTリクエストをリアルタイムで送信します。

前提条件

モニターアクセス権のあるPubrio APIキー
パブリックにアクセス可能なHTTPSエンドポイント（またはusewebhook.comのテストURL）

クイックテスト： usewebhook.comを使用して無料の一時的なウェブフックURLを生成できます。デプロイなしですべての受信ペイロードを確認できます。

ステップ1：ウェブフック配信先でモニターを作成

curl -X POST https://api.pubrio.com/monitors/create \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "name": "My First Monitor",
    "detection_mode": "signal_first",
    "signal_types": ["jobs"],
    "signal_filters": [
      {
        "signal_type": "jobs",
        "filters": {
          "locations": ["US"]
        }
      }
    ],
    "destination_type": "webhook",
    "destination_config": {
      "webhook_url": "https://usewebhook.com/YOUR_WEBHOOK_ID",
      "headers": {
        "X-Custom-Auth": "your-secret-token"
      },
      "body": {
        "pipeline": "my-webhook"
      }
    },
    "max_records_per_trigger": 5,
    "profile_id": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/monitors/create",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY"
    },
    json={
        "name": "My First Monitor",
        "detection_mode": "signal_first",
        "signal_types": ["jobs"],
        "signal_filters": [
            {
                "signal_type": "jobs",
                "filters": {
                    "locations": ["US"]
                }
            }
        ],
        "destination_type": "webhook",
        "destination_config": {
            "webhook_url": "https://usewebhook.com/YOUR_WEBHOOK_ID",
            "headers": {
                "X-Custom-Auth": "your-secret-token"
            },
            "body": {
                "pipeline": "my-webhook"
            }
        },
        "max_records_per_trigger": 5,
        "profile_id": 1
    }
)

print(response.json())

const response = await fetch("https://api.pubrio.com/monitors/create", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY"
  },
  body: JSON.stringify({
    name: "My First Monitor",
    detection_mode: "signal_first",
    signal_types: ["jobs"],
    signal_filters: [
      {
        signal_type: "jobs",
        filters: {
          locations: ["US"]
        }
      }
    ],
    destination_type: "webhook",
    destination_config: {
      webhook_url: "https://usewebhook.com/YOUR_WEBHOOK_ID",
      headers: {
        "X-Custom-Auth": "your-secret-token"
      },
      body: {
        pipeline: "my-webhook"
      }
    },
    max_records_per_trigger: 5,
    profile_id: 1
  })
});

console.log(await response.json());

レスポンス：

{
  "data": {
    "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "My First Monitor",
    "detection_mode": "signal_first",
    "destination_type": "webhook",
    "is_active": true,
    "is_paused": false,
    "masked_signature": "7••••••••••••••••8df",
    "created_at": "2026-04-06T10:00:00.000Z",
    "signature": "71a2b3c4-d5e6-f789-0abc-def123456789"
  }
}

headers オブジェクトは毎回の配信にカスタムHTTPヘッダーを追加します（認証に便利）。body オブジェクトはウェブフックペイロードのルートレベルにカスタムフィールドを追加します。

レスポンスの signature を保存してください — 受信ペイロードの検証に必要です。これは作成時、シグネチャ公開エンドポイント、または is_signature_reveal: true を指定したモニタールックアップでのみ返されます。

ステップ2：ウェブフック接続を検証

ウェブフック検証エンドポイントを使用してエンドポイントが到達可能かテストします。これはプレースホルダーデータを含むサンプルペイロードを送信します — クレジットは消費されず、実際のシグナルは取得されません。

curl -X POST https://api.pubrio.com/monitors/webhook/validate \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "detection_mode": "signal_first",
    "signal_types": ["jobs"],
    "signal_filters": [
      {
        "signal_type": "jobs",
        "filters": { "locations": ["US"] }
      }
    ],
    "destination_type": "webhook",
    "destination_config": {
      "webhook_url": "https://usewebhook.com/YOUR_WEBHOOK_ID",
      "headers": { "X-Custom-Auth": "your-secret-token" },
      "body": { "pipeline": "my-webhook" }
    },
    "profile_id": 1
  }'

成功したレスポンスには、送信されたサンプルリクエストペイロードとエンドポイントが返したレスポンスが含まれます — 本番稼働前に接続が正常であることを確認できます。

ステップ3：実データでテスト

接続が検証されたら、プロセストライエンドポイントを使用して実際の実行をトリガーします。これは実際のシグナルを取得しウェブフックに配信します — tried_at に最近の過去の日付を使用してデータが利用可能であることを確認してください：

curl -X POST https://api.pubrio.com/monitors/process/try \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "tried_at": "2026-01-01T00:00:00.000Z",
    "profile_id": 1
  }'

validateと異なり、tryエンドポイントは実際のスキャンを実行しクレジットを消費します。実際のペイロードが正しく届くことを確認し、スケジュールされたスキャンが開始される前に結果をすばやく推定するために使用してください。

ステップ4：シグネチャの検証

各モニターには、受信ペイロードがPubrioからのものであることを確認するための一意のシグネチャがあります。

curl -X POST https://api.pubrio.com/monitors/signature/reveal \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "profile_id": 1
  }'

{
  "data": {
    "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "signature": "71a2b3c4-d5e6-f789-0abc-def123456789"
  }
}

このシグネチャを受信ペイロードの monitor.monitor_id と比較して真正性を検証します。

ウェブフックペイロード構造

ペイロードはモニターの detection_mode に応じて異なります：

シグナルファースト
カンパニーファースト

signal_first モードでは、ペイロードにトップレベルの signals 配列が含まれます：

{
  "monitor": {
    "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "My Signal Monitor",
    "detection_mode": "signal_first",
    "signal_types": ["jobs", "news"],
    "signal_filters": [...],
    "company_filters": {...},
    "is_company_enrichment": true,
    "is_people_enrichment": true,
    "people_enrichment_configs": [...]
  },
  "metadata": {
    "total_signals": 3,
    "total_companies": 2,
    "total_people": 5
  },
  "triggered_at": "2026-04-05T20:29:43.832Z",
  "signals": [
    {
      "signal_type": "jobs",
      "signal": {
        "signal_type": "jobs",
        "job_search_id": "...",
        "companies": [
          {
            "domain_search_id": "...",
            "company_name": "...",
            "domain": "...",
            ...
          }
        ],
        ...
      },
      "companies": [
        {
          "domain_search_id": "...",
          "company_name": "...",
          "domain": "...",
          "logo_url": "...",
          "country_code": "...",
          "company_size": 5000,
          "industry": "...",
          "people": [...],
          "emails": [...],
          "phones": [...],
          ...
        }
      ]
    },
    {
      "signal_type": "news",
      "signal": {
        "signal_type": "news",
        "news_search_id": "...",
        "news_id": "...",
        "title": "...",
        "summary": "...",
        "published_at": "...",
        "source": "...",
        "category": "...",
        "companies": [...],
        ...
      },
      "companies": [...],
      ...
    },
    ...
  ],
  "pipeline": "my-webhook"
}

各シグナルエントリにはシグナルの詳細と、関連するエンリッチメント済み企業と人物が含まれます。

company_first モードでは、ペイロードにエンリッチメント済み企業データとネストされたシグナルを含むトップレベルの companies 配列が含まれます：

{
  "monitor": {
    "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "My Company Monitor",
    "detection_mode": "company_first",
    "signal_types": ["jobs", "news", "advertisements"],
    "signal_filters": [...],
    "company_filters": {...},
    "is_company_enrichment": true,
    "is_people_enrichment": true,
    "people_enrichment_configs": [...]
  },
  "metadata": {
    "total_signals": 4,
    "total_companies": 2,
    "total_people": 8
  },
  "triggered_at": "2026-04-03T17:45:27.228Z",
  "companies": [
    {
      "company_name": "Acme Corp",
      "domain": "acmecorp.com",
      "domain_search_id": "...",
      "country_code": "US",
      "logo_url": "...",
      "linkedin_name": "acmecorp",
      "company_size": 5200,
      "industry": "Enterprise Software",
      "estimated_revenue": 50000000,
      "founded_year": 2010,
      "company_address": "San Francisco, CA",
      "specialties": ["SaaS", "Cloud Computing", ...],
      "linkedin_url": "https://linkedin.com/company/...",
      "locations": ["US"],
      "signals": [
        {
          "signal_type": "news",
          "signal": {
            "news_id": "...",
            "title": "Acme Corp Launches New AI Product",
            "summary": "...",
            "published_at": "2026-04-03T16:35:00.000Z",
            "source": "techcrunch.com",
            "category": "launches",
            "news_category_name": "Product Launch",
            ...
          }
        },
        {
          "signal_type": "jobs",
          "signal": {
            "job_search_id": "...",
            ...
          }
        },
        ...
      ],
      "people": [
        {
          "name": "Jane Smith",
          "title": "VP of Engineering",
          "email": "[email protected]",
          ...
        },
        ...
      ],
      "emails": ["[email protected]", ...],
      "phones": ["+14155551234", ...],
      "contacts": [...],
      ...
    },
    ...
  ],
  "pipeline": "my-webhook"
}

配列内の各企業には、完全なエンリッチメント済みプロファイル、すべてのマッチしたシグナル、エンリッチメント済みの人物連絡先が含まれます。

destination_config のカスタム body フィールドはルートレベルに表示されます（例：上記の例の "pipeline": "my-webhook"）。

拡大シグナル

jobs、news、advertisements に加えて、モニターは拡大シグナル — 企業が新しい市場へ参入・拡大していることを示す日付付きの証拠 — を監視できます。signal_types に expansions を追加するだけです。

{
  "name": "米国市場への参入",
  "detection_mode": "signal_first",
  "signal_types": ["expansions"],
  "signal_filters": [
    {
      "signal_type": "expansions",
      "filters": {
        "tos": ["US"],
        "stages": ["expanding", "scaling"],
        "signal_strengths": ["high", "very_high"],
        "window_days": 30
      }
    }
  ],
  "destination_type": "webhook",
  "destination_config": {
    "webhook_url": "https://usewebhook.com/YOUR_WEBHOOK_ID"
  }
}

拡大フィルターは求人／ニュース／広告のものではなく、Expansion Search の語彙を使用します。コリドーを表す froms と tos に加えて、stages、momentum、freshness、scopes、signal_types、signal_strengths、window_days があります。有効なスラッグは Expansion Reference から取得してください。

拡大シグナルはシグナル単位ではなく、企業と市場の組み合わせ単位でグループ化されます。1 社が 2 つの市場へ参入した場合はエントリが 2 件生成され、それぞれがその市場固有のシグナルタイムラインを保持します。

拡大シグナルのペイロード

{
  "monitor": {
    "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "米国市場への参入",
    "detection_mode": "signal_first",
    "signal_types": ["expansions"],
    "signal_filters": [...]
  },
  "metadata": {
    "total_signals": 2,
    "total_companies": 1,
    "total_people": 0
  },
  "triggered_at": "2026-08-14T09:12:04.551Z",
  "signals": [
    {
      "signal_type": "expansions",
      "signal": {
        "signal_type": "expansions",
        "expansion_signal_id": 90211,
        "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
        "country_code": "US",
        "signal_type_slug": "HIRE",
        "signal_type_name": "Hiring",
        "signal_subtype_slug": "country_manager",
        "signal_strength_slug": "high",
        "polarity": "expansion",
        "event_date": "2026-08-13T14:00:00.000Z",
        "event_date_precision": "day",
        "source_type": "linkedin",
        "display_label": "Hired Country Manager",
        "evidence_url": "https://linkedin.com/company/example-corp",
        "metadata": {...},
        "companies": [
          {
            "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
            "company_name": "Example Corp",
            "domain": "example.com",
            "stage_name": "Expanding",
            "stage_description": "...",
            "home_country": "GB",
            "home_country_name": "United Kingdom",
            "target_country": "US",
            "target_country_name": "United States",
            "estimated_employees": 420,
            "linkedin_url": "https://linkedin.com/company/example-corp"
          }
        ]
      },
      "companies": [...]
    }
  ]
}

各フィールドの意味は拡大フィールドリファレンスを参照してください。トリガーではなくオンデマンドで同じ行を取得するには、Expansion Signal Search を使用します。

メール配信先

メール配信を希望するチームは、destination_type を "email" に設定してください：

{
  "destination_type": "email",
  "destination_config": {
    "email": "[email protected]"
  }
}

Pubrioはエージェンシーやチーム向けのホワイトラベルメール配信をサポートしています。送信者ドメインとブランディングのカスタマイズについてはお問い合わせください。

トラブルシューティング

ウェブフックがペイロードを受信しない

エンドポイントがパブリックにアクセス可能であることを確認してください（ファイアウォールやVPNの背後にないこと）
200 ステータスコードを返すことを確認してください — 他のコードは失敗として扱われます
ウェブフック検証エンドポイントを使用して接続をテストしてください
統計ログでエラーメッセージとレスポンスコードを確認してください

障害後にモニターが一時停止

ウェブフックが一貫して非200コードを返す場合、max_failure_trigger の連続失敗回数に達するとモニターが一時停止します。問題を修正し、モニター更新で再アクティベートしてください。

重複ペイロード

配信に失敗しリトライが設定されている場合、同じペイロードを複数回受信する可能性があります。triggered_at またはログIDを使用して重複排除してください。

ペイロードが大きすぎる

max_records_per_trigger を減らして配信ごとのレコード数を制限してください。フィルターを絞り込んでマッチするシグナル量を減らすこともできます。

​前提条件

​ステップ1：ウェブフック配信先でモニターを作成

​ステップ2：ウェブフック接続を検証

​ステップ3：実データでテスト

​ステップ4：シグネチャの検証

​ウェブフックペイロード構造

​拡大シグナル

​拡大シグナルのペイロード

​メール配信先

​トラブルシューティング

前提条件

ステップ1：ウェブフック配信先でモニターを作成

ステップ2：ウェブフック接続を検証

ステップ3：実データでテスト

ステップ4：シグネチャの検証

ウェブフックペイロード構造

拡大シグナル

拡大シグナルのペイロード

メール配信先

トラブルシューティング