開発者向け

Webhooks

記事が準備できた瞬間とステータス変更のたびに、明文 JSON の HTTP コールバックを受け取れます。

イベント

2 つのイベントがあり、それぞれキャンペーンパイプラインの特定の段階で発生します。

article.ready執筆完了時

記事が執筆され、自動レビューに合格すると送信されます。公開の合図です。

article.status_changedステータス変更時

TrafficWins で記事のステータスが変わったとき(公開やアーカイブなど)に送信されます。

ペイロード

各イベントはこの JSON ボディを POST します。両方のイベントは同じ構造です。

{
  "event": "article.ready",
  "orgId": "org_8c2f1a…",
  "timestamp": "2026-06-15T12:34:56.000Z",
  "article": {
    "id": "art_3b9a7d…",
    "campaignId": "cmp_71d4e0…",
    "title": "How to Choose a Standing Desk",
    "slug": "how-to-choose-a-standing-desk",
    "status": "draft",
    "description": "A practical buyer's guide to height, stability, and budget.",
    "content": "<h1>How to Choose a Standing Desk</h1><p>…</p>",
    "keywords": ["standing desk", "ergonomics"],
    "wordCount": 1840,
    "reviewScore": 92,
    "reviewVerdict": "pass",
    "heroImageUrl": "https://cdn.trafficwins.com/articles/3b9a/hero.png",
    "heroImageAlt": "A height-adjustable standing desk in a bright office",
    "updatedAt": "2026-06-15T12:34:55.000Z"
  }
}

リクエストヘッダー

TrafficWins はこれらのヘッダーで HTTPS 経由の明文 JSON を送信します。

POST /your-endpoint  HTTP/1.1
Content-Type: application/json
User-Agent: TrafficWins-Webhooks/1.0

設定方法

TrafficWins のサイト公開設定でエンドポイント URL を追加してください。各イベントを明文 JSON として POST します。

TrafficWins を開く

ひとつのサイトから始める

あなたのサイトに向けるだけ。最初の下書きは明日読めます。

アカウントを作成し、サイトを接続し、TrafficWins に最初のキャンペーンの調査・計画・執筆・レビューを任せましょう——クレジットカード不要、API キー不要。

無料トライアルを始める

3 日間トライアル · 記事クレジット 5 件 · いつでも解約可能