如何使用 Python 发送 Microsoft Teams 消息

无论哪种方式，您最终都应该得到一个已完成业务逻辑编码的 DataLab 工作簿：

3. 发送消息到 Teams

因此，Teams webhook：已就绪。业务逻辑：已就绪。要将 Python 笔记本与 Microsoft Teams 集成，我们需要做两件事：在 DataLab 工作簿中存储 webhook URL，并编写一些 Python 代码向 Teams 频道发送消息。

存储 webhook URL

我们的 Python 笔记本需要 webhook URL 才能将消息发送到正确的 Teams 频道。您可以直接把这个 URL 复制粘贴到笔记本的代码单元中。不过，这种做法并不安全，也不推荐。webhook URL 算是某种机密。如果您与他人共享笔记本，他们就能看到这个 webhook URL，并可能向您的 Teams 频道发送垃圾信息！

这种做法还意味着您在每个想要发送 Teams 消息的工作簿中都要重复复制粘贴。如果因为某些原因需要更新 webhook URL，您就得逐个编辑每个工作簿。

更安全且可扩展的做法是将 webhook URL 令牌存储在所谓的环境变量中。当您连接此环境变量后，它将在您的 Python 会话中可用。在您的工作簿中：

• 点击左侧的“Environment（环境）”标签
• 点击“Environment Variables（环境变量）”旁的加号图标
• 在“Add Environment Variables（添加环境变量）”对话框中：
• 将“Name（名称）”设置为 MS_TEAMS_WEBHOOK_URL
• 在“Value（值）”字段中，粘贴之前保存的 Webhook URL。
• 将“Environment Variables Set Name（环境变量集名称）”设置为“Microsoft Teams”（实际上可以是任意名称）

填写完所有字段后，点击“Create（创建）”、“Next（下一步）”，最后点击“Connect（连接）”。您的工作簿会话将重启，MS_TEAMS_WEBHOOK_URL 现在将在您的工作簿中作为环境变量可用。您可以通过创建一个包含以下代码的 Python 单元并运行来验证：

import os
webhook_url = os.environ["MS_TEAMS_WEBHOOK_URL"]
print(webhook_url)技术支持

如果您想在另一个工作簿中复用相同的服务账户凭据，您无需再次设置环境变量：可以在其他工作簿中直接复用该环境变量。

用于发送 Microsoft Teams 消息的 Python 代码

在准备好 MS_TEAMS_WEBHOOK_URL 之后，我们现在可以编写 Python 代码向 Teams 发送消息了！为此，我们将使用开源的 pymsteams 包，它为相当复杂的 Teams 发送消息 API 提供了一个便捷的封装。让我们先安装并导入它，同时导入 os 包以读取环境变量：

!pip install pymsteams
import pymsteams
import os技术支持

接下来，我们可以创建一个所谓的“connector card”（连接器卡片）——也就是 Teams 中的富文本消息——，为其添加一些文本，并发送出去：

card = pymsteams.connectorcard(os.environ["MS_TEAMS_WEBHOOK_URL"])
card.text("Hello Teams!")
assert card.send()技术支持

运行这段代码！您应该会在频道里看到这条消息：

太棒了！这是一条没有实际意义的示例消息，但您也可以像我们在示例工作簿中那样，基于业务逻辑的运行结果来创建消息：

card = pymsteams.connectorcard(os.environ["MS_TEAMS_WEBHOOK_URL"])
card.title("Weather Forecast")
card.text("\n".join([
    f"Weather for {CITY} in the next three days:",
    f"- Min temperature: {weather_df['temperature_2m'].min()} {unit_temperature}",
    f"- Max temperature: {weather_df['temperature_2m'].max()} {unit_temperature}", 
    f"- Total precipitation: {weather_df['precipitation'].sum():.2f} {unit_prec}"
]))
assert card.send()技术支持

效果如下：

最后，您还可以利用 DL_WORKBOOK_ID 环境变量添加一个按钮，链接到您的工作簿，方便有需要的人从 Teams 一键跳转至生成该消息的 DataLab 工作簿：

card = pymsteams.connectorcard(os.environ["MS_TEAMS_WEBHOOK_URL"])
card.title("Weather Forecast")
card.text("\n".join([
    f"Weather for {CITY} in the next three days:",
    f"- Min temperature: {weather_df['temperature_2m'].min()} {unit_temperature}",
    f"- Max temperature: {weather_df['temperature_2m'].max()} {unit_temperature}", 
    f"- Total precipitation: {weather_df['precipitation'].sum():.2f} {unit_prec}"
]))
card.addLinkButton("View detailed forecast", f"https://www.datacamp.com/datalab/w/{os.environ.get('DL_WORKBOOK_ID', 'invalid')}/edit")
assert card.send()技术支持

效果如下：

很酷，对吧？！

4. 自动化！

您已经编写了一个 Python 脚本来完成有用的分析，并将分析摘要发送到 Teams，其中还包含跳转到完整笔记本的链接，方便有兴趣了解更多细节的人查看。太棒了！现在，想象一下，如果能让这个笔记本每日或每周自动执行，持续为您送上最新结果，会有多方便。好消息是，完全可以！DataLab 提供了计划运行功能来实现这一点。

• 在顶部菜单栏中，点击 Run > Schedule Run（计划运行）
• 根据需要配置计划：
• 设置笔记本每天或每周自动运行。对于每周计划，选择具体的日期和时间。
• 添加您希望在笔记本每次完成（无论成功或失败）时收到通知的 DataCamp 用户。对失败场景启用通知很有帮助，这样一旦出现问题，您就能立即介入修复。

如果像上方截图那样配置，笔记本现在将每天在本地时间上午 9:30 运行，这意味着指定的 Teams 频道会在每天早晨收到一条消息。

是否该自动化

并非每个任务都适合自动化。这取决于您执行它的频率、手动完成所需的时间，以及编写自动化 Python 脚本所需的时间。例如，考虑一份每年一次、手动整理需 20 分钟的报告。如果写脚本要花去您半天时间，那么在节省回这部分时间之前，恐怕得很多年！

下面是一个表格形式的总结：

来源：XKCD

因此，如果一个您每天都要做的任务之前需要 5 分钟，那么您最多可以花 6 天时间来尝试将其自动化。如果您花的时间少于这个阈值（以五年为期计算），就等于赚回了时间。

结语

首次设置 DataLab 以向 Microsoft Teams 发送消息需要在多个页面之间来回操作。但一旦在 DataLab 中配置好 webhook URL，发送消息只需添加几行 Python 代码——真的很简单！更棒的是，您几乎可以自动化任何 Python 脚本，并将通知直接发送给利益相关方，就在他们所在之处：Teams。

告别为重复而枯燥的任务设置提醒的时代。欢迎进入高效的自动化工作流时代，您无需在工具之间来回切换。所需的一切，就是拥抱 DataLab。

请记住，如果您需要复习如何编写 Python 代码，我们的Python 入门课程是不二之选。