Skip to the content.

Teams的Incoming Webhook

我在去年的一篇文章里介绍过Teams的outgoing webhook,这个可以用来实现一个简单的用户和service对话机制。

Teams除了outgoing webhook以外,还有一个incoming webhook,从名字上我们也可以立刻知道,这个webhook是用来处理进入Teams的消息。比如,企业里有一个企业内部通知平台,你希望一旦这个平台有一条新的通知发布,在Teams的某个channel里就会有一条对应的消息,来通知大家。incoming webhook就是为此需求而生的。

我们来看看如果创建一个incoming webhook,实际上很简单:

  1. 选中一个Team,进入这个Team的管理界面,选择App,在Teams的app store里选择”Incoming webhook”这个app

Select-Incoming-Webhook-App

  1. 确认一下要消息推送到的channel。

Confirm-Channel

  1. 输入你的incoming webhook的名字,如果需要的话,可以上传一个头像

Configure-name

  1. 点击“Create”按钮

  2. 稍等几秒中后,就可以看到如下界面。

注意:记得拷贝下面这个生成的URL。千万不要忘记

Configure-name

  1. 点击“Done”按钮后,incoming webhook就创建完成了,你在你的channel里已经可以看到一条消息。

complete

  1. 配置好了incoming webhook后,如何推送消息到这个channel里呢?实际上很简单,从测试的角度,我们使用curl或者powershell
curl -H "Content-Type: application/json" -d "{\"text\": \"Hello from Tony\"}" <YOUR WEBHOOK URL>
Invoke-RestMethod -Method post -ContentType 'Application/Json' -Body '{"text":"Hello from Tony"}' -Uri <YOUR WEBHOOK URL>

调用完成后,在你之前指定的channel里已经可以看到你刚才推送的消息了。

result

是不是很简单?赶快行动起来让你的企业应用和Microsoft Teams互动起来!

Written on October 5, 2019