Messenger API 和 Webhook 机器人集成教程（2026版）

Published

February 15, 2026

Read time

6 分钟阅读

作者

Morgan Huber

通过即时通讯机器人实现自动化通知可以简化开发工作流程，使您能够在构建完成、错误发生或部署结束时收到即时提醒。本指南提供了分步说明，介绍如何嵌入可以通过webhook在各种流行消息平台上发送自动化消息的机器人。无论您是需要通知团队关于CI/CD管道结果、服务器监控警报，还是任何自动化流程完成情况，这些集成都能实现。我们仅涵盖具有直接机器人集成能力的平台 - 一些安全的即时通讯工具优先考虑隐私而非自动化功能，因此被有意排除在外。

内容目录

了解基于Webhook的机器人自动化
即时通讯机器人集成指南
Discord Webhook机器人
Slack Webhook机器人
Microsoft Teams Webhook机器人
Telegram机器人
Mattermost Webhook机器人
Matrix/Element机器人
WhatsApp商业机器人
Facebook Messenger机器人
不支持简便机器人的即时通讯工具
实际实现示例
结论
常见问题

了解基于Webhook的机器人自动化

基于Webhook的机器人运行原理很简单：您的应用程序向特定URL发送HTTP POST请求，然后消息平台将该内容传递给频道或用户。这种架构非常适合自动化场景，例如：

构建通知 - 在编译成功或失败时发出警报并提供错误详情
部署更新 - 当代码部署到预发环境或生产环境时通知团队
监控警报 - 发送服务器健康警告或停机通知
定时报告 - 提供每日指标或状态摘要

核心工作流程包括：

在目标平台上创建机器人或webhook URL
配置您的自动化工具（CI/CD、监控系统、自定义脚本）以发送HTTP请求
根据平台规范格式化消息内容

了解不同即时通讯平台如何处理安全性和加密对于选择合适的通知平台至关重要。要深入了解特定平台的安全考虑因素，请参阅我们的2026年即时通讯工具终极指南。

即时通讯机器人集成指南

以下是每个支持简单webhook机器人集成用于发送自动化消息的平台的分步指南。

Discord Webhook机器人

Discord提供了最简单的webhook实现之一，基本的消息发送不需要机器人应用程序或认证令牌。

分步设置

打开服务器设置 - 右键点击服务器名称并选择"服务器设置"
导航到集成 - 在左侧边栏中点击"集成"
创建Webhook - 点击"Webhooks"然后"新建Webhook"
配置Webhook - 为您的webhook命名（例如"构建机器人"），选择目标频道，并可选择上传头像
复制Webhook URL - 点击"复制Webhook URL"并安全保存

通过Webhook发送消息

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 Webhook文档

Slack Webhook机器人

Slack提供了作为Slack应用程序系统一部分的传入Webhook，提供丰富的消息格式和频道灵活性。

分步设置

创建Slack应用 - 访问api.slack.com/apps并点击"创建新应用"
选择创建方法 - 选择"从头开始"并为您的应用命名（例如"CI/CD通知"）
启用传入Webhook - 在左侧边栏导航到"传入Webhook"并将其开启
将Webhook添加到工作区 - 点击"将新Webhook添加到工作区"
选择频道 - 选择通知应该出现的频道并点击"允许"
复制Webhook URL - 您的唯一webhook URL现已显示

通过Webhook发送消息

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传入Webhook指南

Microsoft Teams Webhook机器人

Microsoft Teams支持通过连接器系统集成的传入Webhook用于频道通知。

分步设置

打开频道设置 - 导航到目标频道，点击频道名称旁边的三个点(•••)
选择连接器 - 点击"连接器"（在较新版本中可能是"管理频道"然后"连接器"）
查找传入Webhook - 搜索"传入Webhook"并点击"配置"
命名您的Webhook - 提供名称（例如"构建警报"）并可选择上传图片
创建并复制URL - 点击"创建"并复制提供的webhook URL

通过Webhook发送消息

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传入Webhook

Telegram机器人

Telegram提供强大的机器人API，允许以编程方式发送消息。与webhook不同，您直接向Telegram的API发送请求。

分步设置

通过BotFather创建机器人 - 打开Telegram并搜索@BotFather
开始新机器人 - 发送/newbot命令
命名您的机器人 - 按照提示设置显示名称和用户名（必须以"bot"结尾）
保存API令牌 - BotFather会提供一个API令牌，如123456789:ABCdefGHIjklMNOpqrsTUVwxyz
获取聊天ID - 将机器人添加到您的群组/频道，发送一条消息，然后访问https://api.telegram.org/bot<TOKEN>/getUpdates查找聊天ID

通过机器人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机器人API

Mattermost Webhook机器人

Mattermost是一个开源的Slack替代品，具有出色的webhook支持，非常适合自托管的团队通信。

分步设置

访问集成 - 点击汉堡菜单，然后点击"集成"
创建传入Webhook - 选择"传入Webhook"然后"添加传入Webhook"
配置Webhook - 设置标题、描述并选择默认频道
保存并复制URL - 点击"保存"并复制提供的webhook URL

通过Webhook发送消息

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传入Webhook

Matrix/Element机器人

Matrix是一个开放的去中心化通信协议，Element是最流行的客户端。机器人集成需要使用Matrix客户端-服务器API。

分步设置

创建机器人账户 - 在您的homeserver或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客户端-服务器API规范

WhatsApp商业机器人

WhatsApp提供商业API用于自动化消息发送，但需要企业验证，设置比其他平台更复杂。

分步设置

创建Meta商业账户 - 访问business.facebook.com并创建商业账户
设置WhatsApp商业 - 导航到developers.facebook.com，创建应用，并添加WhatsApp产品
配置电话号码 - 为您的机器人添加电话号码（开发中可使用测试号码）
获取访问令牌 - 从应用仪表板生成永久访问令牌
验证企业 - 完成企业验证以用于生产环境

通过云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云API文档

Facebook Messenger机器人

Facebook Messenger机器人需要Facebook应用和页面，消息通过Send API发送。

分步设置

创建Facebook应用 - 访问developers.facebook.com并创建一个新应用（选择"商业"类型）
添加Messenger产品 - 在您的应用仪表板中，点击"添加产品"并选择Messenger
连接Facebook页面 - 将Facebook页面链接到您的应用（如需要可创建一个）
生成页面访问令牌 - 在Messenger设置中，为您的页面生成令牌
获取PSID - 用户必须先向您的页面发送消息；从webhook事件中捕获他们的页面范围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平台文档

不支持简便机器人的即时通讯工具

以下即时通讯工具优先考虑隐私和安全而非自动化功能，使基于webhook的机器人集成变得不可能或不切实际：

Signal - 没有官方机器人API。Signal优先考虑端到端加密和用户隐私，有意避免可能危及安全的自动化功能。
Session - 去中心化的即时通讯工具，没有机器人基础设施。洋葱路由架构使自动化消息发送变得不切实际。
Briar - 为活动家和记者设计的点对点即时通讯工具。没有服务器基础设施意味着没有webhook能力。
Wire - 虽然Wire有一些企业API功能，但没有简单的webhook系统用于自动化通知。
Wickr - 面向企业，没有公共机器人API。自动化需要Wickr企业版和自定义集成。
SimpleX - 隐私优先设计，没有用户标识符，使机器人集成在架构上不兼容。
Threema - 提供Threema Gateway供企业使用，但这是需要合同的付费服务，不是简单的webhook设置。
Viber - 有机器人API但需要商业账户批准，主要为客户服务设计，不适合开发者通知。
LINE - 提供消息API但需要商业账户验证，对于简单的通知用例过于复杂。
微信 - 官方账号API存在但需要中国企业注册和政府批准。

对于需要这些平台的安全通信需求，可以考虑将它们与支持自动化的平台一起使用，或探索我们关于保持私人消息真正安全的指南。

实际实现示例

以下是一个完整的Node.js示例，可同时向多个平台发送构建通知：

const axios = require('axios');

const notifiers = {
  discord: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { content: message });
  },

  slack: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { text: message });
  },

  telegram: async (message, token, chatId) => {
    await axios.post(`https://api.telegram.org/bot${token}/sendMessage`, {
      chat_id: chatId,
      text: message,
      parse_mode: 'HTML'
    });
  },

  teams: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { text: message });
  }
};

async function notifyBuildResult(success, project, branch, error = null) {
  const emoji = success ? '✅' : '❌';
  const status = success ? 'succeeded' : 'failed';
  let message = `${emoji} Build ${status}\n\nProject: ${project}\nBranch: ${branch}`;
  if