使用 Node-RED 向 Microsoft Teams 发送消息

本教程向您展示如何将来自 OV80i 摄像头的检查通知直接发送到 Microsoft Teams 通道。您将学习设置自动警报，其中包含检查结果和可点击的图片链接，使您的团队能够即时了解生产状态。

您将构建的内容： 一个自动化系统，将 OV80i 检查结果（包含图片和通过/不通过状态）直接发布到一个 Microsoft Teams 通道。

现实世界的应用： 在检查失败时获得即时通知，将检查图像与远程团队共享，或在您的团队协作空间中创建自动化质量报告。

先决条件

• OV80i 摄像头连接到工厂网络
• 具有添加连接器权限的 Microsoft Teams 访问权限
• 您想接收通知的 Teams 通道
• OV80i 与 Microsoft Teams 之间的网络连接
• 对 Node-RED flows 的基本了解

教程概览

我们将构建： 一个 Node-RED flow，能够自动将检查结果发送到 Microsoft Teams，并带有可点击的图片链接。

所需时间： 15-20 分钟

学习技能： Teams webhook 集成、Node-RED HTTP 请求、自动化通知系统

第 1 步：设置 Microsoft Teams Webhook

1.1 访问您的 Teams 通道

1. 打开 Microsoft Teams，并导航到检查通知的通道
2. 点击通道名称旁的 三点按钮 (•••)
3. 从下拉菜单中选择 “Manage channel”

1.2 添加 Incoming Webhook 连接器

1. 在通道管理菜单中点击 “Connectors”
2. 在连接器列表中 搜索 "Incoming Webhook"
3. 在 Incoming Webhook 选项旁点击 “Add”

1.3 配置 Webhook 设置

1. 名称：输入描述性名称（如 “OV80i Inspection Alerts”）
2. 图标：可选上传自定义通知图标
3. 点击 “Create” 以生成 webhook

1.4 保存 Webhook URL

1. 复制生成的 webhook URL - 这是 Node-RED 设置的关键
2. 将 URL 保存到安全位置（步骤 2 将需要它）
3. 点击 “Done” 完成 Teams 设置

检查点： 您现在应该拥有一个看起来像这样的 webhook URL：https://yourcompany.webhook.office.com/webhookb2/...

第 2 步：访问 OV80i Node-RED

2.1 进入 Node-RED

1. 打开您的 OV80i Web 界面
2. 转到 Recipe Editor，点击 Configure I/O 或从面包屑导航中选择 “IO Block”

2.2 准备您的工作区

1. 在 Node-RED 画布中清理一个区域，用于 Teams 集成流程
2. 识别左侧的调色板（包含可用节点）
3. 规划流程：Trigger → Process → Send to Teams

第 3 步：构建 Node-RED Flow

3.1 添加所需节点

从调色板拖动下列节点到画布：

1. Inject node（用于测试）
2. Function node（用于格式化消息）
3. HTTP request node（用于发送到 Teams）
4. Debug node（可选，用于故障排除）

3.2 连接节点

1. 将 Inject node 的输出连到 Function node 的输入
2. 将 Function node 的输出连到 HTTP request node 的输入
3. 将 HTTP request node 的输出连到 Debug node 的输入（可选）

流程结构：

Inject → Function → HTTP Request → Debug

步骤 4：配置函数节点

4.1 基本消息配置

1. 双击函数节点以打开配置
2. 将默认代码替换为以下基本消息格式：

// Basic Teams message
msg.headers = {
    "Content-Type": "application/json"
};

msg.payload = {
    text: "You got a new message from your OV80i"
};

return msg;

4.2 带图片链接的高级消息

对于具有可点击图片的动态检测结果：

// Dynamic message with inspection image
let imageUrl = msg.payload.image_url;

msg.headers = {
    "Content-Type": "application/json"
};

msg.payload = {
    text: `Inspection Complete - [View Image](${imageUrl})`
};

return msg;

4.3 完整检测通知

对于完整的检测详情：

// Complete inspection notification
const inspectionData = msg.payload;
const imageUrl = inspectionData.image_url;
const result = inspectionData.result ? "PASS" : "FAIL";
const timestamp = new Date().toLocaleString();

msg.headers = {
    "Content-Type": "application/json"
};

msg.payload = {
    text: `🔍 **Inspection ${result}** - ${timestamp}\n\n[View Image](${imageUrl})`
};

return msg;

4.4 保存函数节点配置

1. 单击 “完成” 以保存函数节点
2. 为节点提供一个描述性名称，如 "Format Teams Message"

步骤 5：配置 HTTP 请求节点

5.1 设置 HTTP 请求节点

1. 双击 HTTP 请求节点 进行配置
2. 设置方法（Set Method）：从下拉菜单中选择 "POST"
3. 设置 URL：粘贴来自步骤 1.4 的 Teams webhook URL
4. 设置返回值格式（Set Return）：选择 "UTF-8 string"

5.2 附加设置

• 名称（Name）：输入 "Send to Teams" 以提高清晰度
• Headers：保持为空（由函数节点处理）
• Payload：保持为 "Ignore"（由函数节点处理）

5.3 保存 HTTP 配置

1. 单击 "完成" 以保存 HTTP 请求节点
2. 验证 webhook URL 是否正确 — 这对成功至关重要

步骤 6：测试您的集成

6.1 部署流程

1. 在右上角单击 "Deploy" 按钮
2. 等待出现 "Successfully deployed" 的确认
3. 检查节点上是否有错误指示（红色三角形）

6.2 使用 Inject 节点进行测试

1. 点击注入节点左侧的按钮
2. 检查调试面板（右侧边栏）是否有错误信息
3. 在 Teams 通道中验证消息是否出现

6.3 验证 Teams 通知

1. 切换到 Microsoft Teams 并检查目标通道
2. 查找来自 OV80i 的测试消息
3. 测试任意可点击的链接，以确保其正常工作

步骤 7：与检测流程的集成

7.1 连接检测结果

为每次检测发送自动通知：

1. 找到您的主检测流程（通常以 "All Block Outputs" 开始）
2. 将您的 Teams 通知添加为主流程的一个分支
3. 在检测处理之后但在最终结果之前进行连接

7.2 示例集成流程

All Block Outputs → [Inspection Logic] → Final Pass/Fail
                                      ↓
                               Format Teams Message → Send to Teams

7.3 过滤通知（可选）

仅在检查失败时发送通知：

// Only send notifications for failures
const inspectionResult = msg.payload.result;

if (!inspectionResult) {  // Only if inspection failed
    const imageUrl = msg.payload.image_url;

    msg.headers = {
        "Content-Type": "application/json"
    };

    msg.payload = {
        text: `⚠️ **INSPECTION FAILED** - Immediate attention required\n\n[View Failed Image](${imageUrl})`
    };

    return msg;
} else {
    return null;  // Don't send message for passing inspections
}

Step 8: Troubleshooting

8.1 常见问题

问题	症状	解决方法
Teams 中无消息	调试显示成功但没有 Teams 通知	检查 webhook URL，验证网络连接
HTTP 错误 400	调试中的错误请求	检查消息格式，确保 Content-Type 头
图像链接无法打开	消息显示但图像无法打开	验证图像 URL 是否对 Teams 用户的网络可访问
流程未触发	预期时无调试输出	检查流连接，验证触发条件

8.2 调试 Flow

1. 在每步之后添加调试节点以跟踪数据流
2. 检查调试面板中的错误消息和数据结构
3. 使用 inject 节点进行测试以隔离配置问题
4. 通过外部工具测试以验证 webhook URL（如有需要）

8.3 网络连接

1. 确保 OV80i 能访问互联网（从摄像头执行 ping 测试）
2. 检查可能阻止出站 HTTPS 的防火墙设置
3. 验证 Teams webhook URL 的 DNS 解析
4. 在与摄像头同一网络的浏览器中测试

成功！Teams 集成已完成

现在您的 OV80i 摄像头可以：

✅ 向 Microsoft Teams 通道发送自动通知

✅ 包含可点击的图像链接，以便即时检查回顾

✅ 基于检查结果过滤通知

✅ 提供包含检查详情和时间戳的富文本格式

✅ 支持多通道用于不同通知类型

最佳实践

信息管理

• 为不同类型的通知使用描述性通道名称
• 在消息中包含时间戳和工位标识
• 筛选消息以避免通知过载
• 在生产部署前进行彻底测试

安全注意事项

• 保护 webhook URL——将其视为敏感凭据
• 对所有通信使用 HTTPS（Teams 的默认设置）
• 仅对必要服务限制网络访问
• 如 webhook URL 遭到暴露，定期轮换

性能优化

• 在大量发送消息时进行批量通知
• 对网络故障使用合适的重试逻辑
• 监控消息投递成功率
• 实现速率限制以避免 Teams API 限制

后续步骤

设置完 Teams 集成后：

1. 为不同检查类型创建不同的通知通道
2. 为关键故障设置升级工作流
3. 与其他团队工具集成（电子邮件、短信等）
4. 构建仪表板，将 Teams 与其他监控工具结合
5. 培训你的团队，以应对自动通知

跳过手动设置

The Integration Builder 可以从简单的英文描述生成完整的 Teams 通知流程。描述你想要的内容（例如“当部件发生故障时，将检查结果和图片发送到一个 Teams 通道”），即可在几秒钟内获得可投入生产的 Node-RED flow。

🔗 相关链接

• 使用 Node-RED 发送邮件
• Node-RED 基础
• Node-RED 自定义 Blocks 概览
• 元数据设置
• 设置数字输出逻辑

• MQTT 通信设置