Botのための Messenger API & Webhook 連携 (2026年チュートリアル)

Published

February 15, 2026

Read time

6 分で読めます

著者

Morgan Huber

メッセンジャーボットを通じた通知の自動化は開発ワークフローを効率化し、ビルドの完了、エラーの発生、デプロイメントの終了時に即時アラートを送信できるようにします。このガイドでは、人気のあるメッセージングプラットフォーム全体でウェブフックを介して自動メッセージを送信できるボットを埋め込むための段階的な手順を提供します。CI/CDパイプラインの結果、サーバー監視アラート、または任意の自動プロセスの完了についてチームに通知する必要がある場合でも、これらの統合により可能になります。簡単なボット統合機能を持つプラットフォームのみを取り上げています - 一部の安全なメッセンジャーはプライバシーを自動化機能よりも優先し、意図的に除外されています。

ウェブフックベースのボット自動化の理解
メッセンジャーボット統合ガイド
Discord ウェブフックボット
Slack ウェブフックボット
Microsoft Teams ウェブフックボット
Telegram ボット
Mattermost ウェブフックボット
Matrix/Element ボット
WhatsApp Business ボット
Facebook Messenger ボット
簡単なボットサポートがないメッセンジャー
実用的な実装例
結論
よくある質問

ウェブフックベースのボット自動化の理解

ウェブフックベースのボットは単純な原則で動作します：アプリケーションが特定のURLにHTTP POSTリクエストを送信し、メッセージングプラットフォームがそのコンテンツをチャンネルまたはユーザーに配信します。このアーキテクチャは以下のような自動化シナリオに最適です：

ビルド通知 - コンパイルが成功したか、エラーの詳細と共に失敗したかを警告
デプロイメント更新 - コードがステージングまたは本番環境に到達した時にチームに通知
監視アラート - サーバーの健全性警告やダウンタイム通知を送信
スケジュールされたレポート - 日次メトリクスやステータスサマリーを配信

コアワークフローには以下が含まれます：

ターゲットプラットフォームでボットまたはウェブフックURLを作成する
自動化ツール（CI/CD、監視システム、カスタムスクリプト）がHTTPリクエストを送信するように構成する
プラットフォームの仕様に従ってメッセージペイロードをフォーマットする

異なるメッセンジャープラットフォームがセキュリティと暗号化をどのように扱うかを理解することは、通知に適したプラットフォームを選択する上で重要です。プラットフォーム固有のセキュリティ考慮事項についての詳細は、2026年のメッセンジャーに関する究極ガイドをご覧ください。

メッセンジャーボット統合ガイド

以下は、自動メッセージを送信するための簡単なウェブフックベースのボット統合をサポートする各プラットフォームの段階的なガイドです。

Discord ウェブフックボット

How to setup different webhook bots in 2026 simple and easy

Discordは最もシンプルなウェブフック実装の一つを提供し、基本的なメッセージ送信にはボットアプリケーションや認証トークンが不要です。

ステップバイステップのセットアップ

サーバー設定を開く - サーバー名を右クリックして「サーバー設定」を選択
統合に移動 - 左サイドバーの「統合」をクリック
ウェブフックを作成 - 「ウェブフック」をクリックし、次に「新しいウェブフック」をクリック
ウェブフックを構成 - ウェブフックに名前を付け（例：「ビルドボット」）、ターゲットチャンネルを選択し、必要に応じてアバターをアップロード
ウェブフックURLをコピー - 「ウェブフックURLをコピー」をクリックして安全に保存

ウェブフック経由でメッセージを送信

curl -X POST -H "Content-Type: application/json" \
  -d '{"content": "✅ ビルドが正常に完了しました！\n\nプロジェクト: MyApp\nブランチ: main\n所要時間: 3分42秒"}' \
  https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN

エラー通知用のリッチ埋め込み例

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "embeds": [{
      "title": "❌ ビルド失敗",
      "color": 15158332,
      "fields": [
        {"name": "プロジェクト", "value": "MyApp", "inline": true},
        {"name": "ブランチ", "value": "feature/login", "inline": true},
        {"name": "エラー", "value": "```TypeError: Cannot read property of undefined```"}
      ],
      "timestamp": "2026-01-15T10:30:00.000Z"
    }]
  }' \
  YOUR_WEBHOOK_URL

公式ドキュメント： Discord ウェブフックドキュメント

Slack ウェブフックボット

SlackはSlackアプリシステムの一部として受信ウェブフックを提供し、リッチなメッセージフォーマットとチャンネルの柔軟性を提供します。

ステップバイステップのセットアップ

Slackアプリを作成 - api.slack.com/appsにアクセスし、「Create New App」をクリック
作成方法を選択 - 「From scratch」を選択し、アプリに名前を付けます（例：「CI/CD通知」）
受信ウェブフックを有効化 - 左サイドバーの「Incoming Webhooks」に移動し、オンに切り替え
ワークスペースにウェブフックを追加 - 「Add New Webhook to Workspace」をクリック
チャンネルを選択 - 通知を表示するチャンネルを選択し、「Allow」をクリック
ウェブフックURLをコピー - 固有のウェブフックURLが表示されます

ウェブフック経由でメッセージを送信

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ 本番環境へのデプロイメントが正常に完了しました！"}' \
  https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXX

詳細な通知のためのBlock Kitメッセージ

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "blocks": [
      {
        "type": "header",
        "text": {"type": "plain_text", "text": "🚨 ビルド失敗"}
      },
      {
        "type": "section",
        "fields": [
          {"type": "mrkdwn", "text": "*プロジェクト:*\nMyApp"},
          {"type": "mrkdwn", "text": "*ブランチ:*\nmain"},
          {"type": "mrkdwn", "text": "*エラー:*\n`Module not found`"}
        ]
      }
    ]
  }' \
  YOUR_WEBHOOK_URL

公式ドキュメント： Slack 受信ウェブフックガイド

Microsoft Teams ウェブフックボット

Microsoft Teamsはコネクタシステムを通じて統合された、チャンネル通知用の受信ウェブフックをサポートしています。

ステップバイステップのセットアップ

チャンネル設定を開く - ターゲットチャンネルに移動し、チャンネル名の横にある三点（•••）をクリック
コネクタを選択 - 「コネクタ」をクリック（または新しいバージョンでは「チャンネルの管理」から「コネクタ」）
受信ウェブフックを検索 - 「受信ウェブフック」を検索し、「構成」をクリック
ウェブフックに名前を付ける - 名前（例：「ビルドアラート」）を入力し、必要に応じて画像をアップロード
作成してURLをコピー - 「作成」をクリックし、提供されたウェブフックURLをコピー

ウェブフック経由でメッセージを送信

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ ビルド #1234 がmainブランチで正常に完了しました"}' \
  YOUR_TEAMS_WEBHOOK_URL

リッチな通知のためのアダプティブカード

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "type": "message",
    "attachments": [{
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "version": "1.2",
        "body": [
          {"type": "TextBlock", "size": "Large", "weight": "Bolder", "text": "❌ ビルド失敗"},
          {"type": "FactSet", "facts": [
            {"title": "プロジェクト:", "value": "MyApp"},
            {"title": "エラー:", "value": "コンパイルに失敗しました"}
          ]}
        ]
      }
    }]
  }' \
  YOUR_TEAMS_WEBHOOK_URL

公式ドキュメント： Microsoft Teams 受信ウェブフック

Telegram ボット

Telegramはプログラムでメッセージを送信できる強力なBot APIを提供しています。ウェブフックとは異なり、TelegramのAPIに直接リクエストを送信します。

ステップバイステップのセットアップ

BotFather経由でボットを作成 - Telegramを開き、@BotFatherを検索
新しいボットを開始 - /newbotコマンドを送信
ボットに名前を付ける - 表示名とユーザー名（「bot」で終わる必要があります）を設定するプロンプトに従う
APIトークンを保存 - BotFatherは123456789:ABCdefGHIjklMNOpqrsTUVwxyzのようなAPIトークンを提供
チャットIDを取得 - ボットをグループ/チャンネルに追加し、メッセージを送信した後、https://api.telegram.org/bot<TOKEN>/getUpdatesにアクセスしてチャットIDを見つける

Bot API経由でメッセージを送信

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -d "chat_id=" \
  -d "text=✅ ビルドが正常に完了しました！%0A%0Aプロジェクト: MyApp%0Aブランチ: main" \
  -d "parse_mode=HTML"

HTMLでフォーマットされたメッセージ

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "",
    "text": "❌ ビルド失敗\n\nプロジェクト: MyApp\nブランチ: main\nエラー: Module not found",
    "parse_mode": "HTML"
  }'

公式ドキュメント： Telegram Bot API

Mattermost ウェブフックボット

MattermostはオープンソースのSlack代替品で、優れたウェブフックサポートを提供し、セルフホストチームコミュニケーションに最適です。

ステップバイステップのセットアップ

統合にアクセス - ハンバーガーメニューをクリックし、「統合」をクリック
受信ウェブフックを作成 - 「受信ウェブフック」を選択し、「受信ウェブフックを追加」をクリック
ウェブフックを構成 - タイトル、説明を設定し、デフォルトチャンネルを選択
保存してURLをコピー - 「保存」をクリックし、ウェブフックURLをコピー

ウェブフック経由でメッセージを送信

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ ビルドが正常に完了しました！"}' \
  https://your-mattermost-server.com/hooks/YOUR_WEBHOOK_ID

リッチな添付メッセージ

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "attachments": [{
      "fallback": "ビルド失敗",
      "color": "#FF0000",
      "title": "❌ ビルド失敗",
      "fields": [
        {"short": true, "title": "プロジェクト", "value": "MyApp"},
        {"short": true, "title": "ブランチ", "value": "main"},
        {"short": false, "title": "エラー", "value": "```Module not found```"}
      ]
    }]
  }' \
  YOUR_WEBHOOK_URL

公式ドキュメント： Mattermost 受信ウェブフック

Matrix/Element ボット

Matrixは分散型通信のためのオープンプロトコルで、Elementが最も人気のあるクライアントです。ボット統合にはMatrix Client-Server APIの使用が必要です。

ステップバイステップのセットアップ

ボットアカウントを作成 - あなたのホームサーバーまたはmatrix.orgで新しいMatrixアカウントを登録
アクセストークンを取得 - ログインし、Elementからアクセストークンを取得：設定 → ヘルプ＆情報 → 詳細 → アクセストークン
ルームIDを取得 - ボットでターゲットルームに参加し、ルーム設定 → 詳細でルームIDを見つける
ボットをルームに招待 - メッセージを送信したいルームにボットアカウントが参加していることを確認

Matrix API経由でメッセージを送信

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"msgtype": "m.text", "body": "✅ ビルドが正常に完了しました！"}' \
  "https://matrix.org/_matrix/client/r0/rooms/YOUR_ROOM_ID/send/m.room.message/$(date +%s)"

HTMLでフォーマットされたメッセージ

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "msgtype": "m.text",
    "body": "ビルド失敗\nプロジェクト: MyApp\nエラー: Module not found",
    "format": "org.matrix.custom.html",
    "formatted_body": "❌ ビルド失敗
プロジェクト: MyApp
エラー: Module not found"
  }' \
  "https://matrix.org/_matrix/client/r0/rooms/YOUR_ROOM_ID/send/m.room.message/$(date +%s)"

ヒント： より簡単なMatrixボット開発には、matrix-nio（Python）やmatrix-bot-sdk（JavaScript）などのライブラリの使用を検討してください。

公式ドキュメント： Matrix Client-Server API仕様

WhatsApp Business ボット

WhatsAppは自動メッセージング用のBusiness APIを提供していますが、ビジネス認証が必要で、他のプラットフォームよりも複雑なセットアップが必要です。

ステップバイステップのセットアップ

Metaビジネスアカウントを作成 - business.facebook.comにアクセスし、ビジネスアカウントを作成
WhatsApp Businessを設定 - developers.facebook.comに移動し、アプリを作成し、WhatsApp製品を追加
電話番号を構成 - ボット用の電話番号を追加（開発用のテスト番号が利用可能）
アクセストークンを取得 - アプリダッシュボードから永続的なアクセストークンを生成
ビジネスを認証 - 本番環境での使用にはビジネス認証を完了

Cloud API経由でメッセージを送信

curl -X POST \
  "https://graph.facebook.com/v17.0/YOUR_PHONE_NUMBER_ID/messages" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "RECIPIENT_PHONE_NUMBER",
    "type": "text",
    "text": {"body": "✅ ビルドが正常に完了しました！"}
  }'

重要： WhatsAppはユーザーとの会話を開始するためにメッセージテンプレートを必要とします。ユーザーとのやり取りから24時間以内のみ自由形式のメッセージを送信できます。自動通知には、まずメッセージテンプレートを作成し、承認を得る必要があります。

公式ドキュメント： WhatsApp Cloud APIドキュメント

Facebook Messenger ボット

Facebook MessengerボットはFacebookアプリとページが必要で、メッセージはSend APIを通じて送信されます。

ステップバイステップのセットアップ

Facebookアプリを作成 - developers.facebook.comにアクセスし、新しいアプリを作成（「ビジネス」タイプを選択）
Messenger製品を追加 - アプリダッシュボードで「製品を追加」をクリックし、Messengerを選択
Facebookページを接続 - アプリにFacebookページをリンク（必要に応じて作成）
ページアクセストークンを生成 - Messenger設定でページのトークンを生成
PSIDを取得 - ユーザーは最初にあなたのページにメッセージを送る必要があります；ウェブフックイベントからPage-Scoped ID（PSID）を取得

Send API経由でメッセージを送信

curl -X POST \
  "https://graph.facebook.com/v17.0/me/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {"id": "USER_PSID"},
    "message": {"text": "✅ ビルドが正常に完了しました！"},
    "access_token": "YOUR_PAGE_ACCESS_TOKEN"
  }'

注意： Facebook Messengerには自動メッセージングに関する厳格なポリシーがあります。ボットはユーザーとのやり取りから24時間以内にのみプロモーションメッセージを送信できます。この期間外の通知には、特定のメッセージタグを申請するか、ワンタイム通知機能を使用する必要があります。

公式ドキュメント： Facebook Messengerプラットフォームドキュメント

簡単なボットサポートがないメッセンジャー

以下のメッセンジャーはプライバシーとセキュリティを自動化機能よりも優先しており、ウェブフックベースのボット統合が不可能または非現実的です：

Signal - 公式ボットAPIなし。Signalはエンドツーエンドの暗号化とユーザープライバシーを優先し、セキュリティを損なう可能性のある自動化機能を意図的に避けています。
Session - ボットインフラストラクチャのない分散型メッセンジャー。オニオンルーティングアーキテクチャは自動メッセージングを非現実的にします。
Briar - 活動家やジャーナリスト向けに設計されたピアツーピアメッセンジャー。サーバーインフラストラクチャがないため、ウェブフック機能はありません。
Wire