Webhookは、プロジェクトで起きたすべての変更を、数秒で別のシステムに伝えます。追加できるのは管理者だけです。

Webhookを追加する

  1. サイドバーで 設定 › AIエージェント を開きます。WebhookとSlack カードを見つけます。
  2. イベントを受け取る アドレス を貼り付けます。https:// で始まり、インターネットから到達できる必要があります。
  3. 形式 を選びます。
    • JSON(署名付き):自分のコード、Zapier、Make、n8nなどのツール向け。
    • Slack Incoming Webhook:Slackのチャンネルに、イベントごとに読みやすい1行を送ります。
  4. Webhookを追加 を押します。

設定 › AIエージェントのWebhookとSlackカード。アドレスを追加するフォームと、最後の配信が表示された1つのWebhookです。設定 › AIエージェントのWebhookとSlackカード。アドレスを追加するフォームと、最後の配信が表示された1つのWebhookです。

JSONの場合は、今すぐ 署名シークレット をコピーしてください。再表示されません。

Slackに投稿する

  1. Slackで、使いたいチャンネル用のIncoming Webhookを作成します。Slackから https://hooks.slack.com/ で始まるアドレスが発行されます。
  2. Notiamoで、形式 Slack Incoming Webhook を選んで追加します。

各行には、誰が、どのプロジェクトで、何をしたかと、コメントへのリンクが書かれています。Slackの行は英語です。

送信される内容

新しいコメント、返信、ステータスの変更、担当者の割り当てのすべてに加え、編集と削除された返信が送られます。社内メモも含まれ、その旨が示されます。Webhookは、クライアントではなく代理店に送られるためです。

JSONの配信は、次の本文を持つ POST です。

{
  "delivery": "a-unique-id",
  "events": [
    {
      "id": 1234,
      "event": "comment_created",
      "at": "2026-10-14T09:30:00.000Z",
      "internal": false,
      "viaAgent": false,
      "actor": { "name": "Claire Martin" },
      "project": { "id": "…", "name": "Main website" },
      "comment": { "id": "…", "number": 12, "type": "highlight", "title": null, "text": "…", "page": "/pricing", "url": "https://example.com/pricing", "status": "open", "link": "https://my.notiamo.com/comments/…" }
    }
  ]
}

そのほかのイベント名は、reply_created、status_changed、assigned、comment_edited、reply_edited、reply_deleted です。イベントによっては、reply、status(from と to)、assignee、mentions も含まれます。テキストは500文字で切り詰められます。コメントの全文は link から確認してください。

ジョブレポート が進むと、job.state_changed が送られます。job には、from と to(draft、ready、article_waiting、changes_requested、approved、posts_delivered)、commentId、number が入ります。draft に戻したときも送られますが、Slackには送られません。

署名を確認する

JSONの配信には、すべて2つのヘッダーが付きます。

  • X-Notiamo-Delivery:本文の delivery と同じID。
  • X-Notiamo-Signature:sha256= に続けて、署名シークレットで作成した、生の本文のHMAC-SHA256。

自分の側で同じ値を計算して比較してください。異なる場合は、リクエストを拒否します。

サーバーが応答しないとき

カードには、最後の配信、サーバーが返したステータスコード、連続した失敗の回数が表示されます。Notiamoは再試行します。すぐに、その後15分、30分、45分後に、それ以降は1時間ごとです。待っている間も、何も失われません。配信を止めるには、削除 を押します。

APIキー

NotiamoのAPIキーは エージェントキー です。https://my.notiamo.com/api/mcp のMCPサーバーを開き、どのMCPクライアントからでも、コメントの一覧、読み取り、返信、割り当て、更新に使えます。設定 › AIエージェント › エージェントキー で作成します。読み取り専用またはフルアクセスで、すべてのプロジェクトまたは1つのプロジェクトを選べます。サインイン(OAuth)に対応するMCPクライアントには、キーは不要です。AIエージェントを接続する をご覧ください。

プロジェクトのすべてのコメントをファイルで取得するには、プロジェクトのページを開いて CSVをエクスポート または JSONをエクスポート を押します。