From cd76d89274c68562387b7431cf9ca557011b3382 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=87=91=E5=96=9C=40DingTalk?= Date: Tue, 16 Jan 2024 14:37:59 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E4=BC=98=E5=8C=96=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E5=B1=95=E7=A4=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 51 +++++++++------------------------------------------ 1 file changed, 9 insertions(+), 42 deletions(-) diff --git a/README.md b/README.md index e44a102..7cbb5de 100644 --- a/README.md +++ b/README.md @@ -4,50 +4,17 @@ Go SDK for DingTalk Stream Mode API, Compared with the webhook mode, it is easie 钉钉支持 Stream 模式接入事件推送、机器人收消息以及卡片回调，该 SDK 实现了 Stream 模式。相比 Webhook 模式，Stream 模式可以更简单的接入各类事件和回调。 -## 快速开始 +## 开发教程 -### 准备工作 +在 [教程文档](https://opensource.dingtalk.com/developerpedia/docs/explore/tutorials/stream/overview) 中，你可以找到钉钉 Stream 模式的教程文档和示例代码。 -* Go语言开发环境，https://www.go.dev/ -* 钉钉开发者账号，具备创建企业内部应用的权限，详见[成为钉钉开发者](https://open.dingtalk.com/document/orgapp/become-a-dingtalk-developer) +## 特别说明 -### 快速开始指南 +因拼写错误，从旧版本升级到 v0.13.0 时候，需要将 register_callback_hanlder 修改为 register_callback_handler -1、创建企业内部应用 +### 参考资料 -进入[钉钉开发者后台](https://open-dev.dingtalk.com/)，创建企业内部应用，获取ClientID（即 AppKey）和ClientSecret（ 即AppSecret）。 - -发布应用：在开发者后台左侧导航中，点击“版本管理与发布”，点击“确认发布”，并在接下来的可见范围设置中，选择“全部员工”，或者按需选择部分员工。 - - -2、Stream 模式的机器人（可选） - -如果不需要使用机器人功能的话，可以不用创建。 - -在应用管理的左侧导航中，选择“消息推送”，打开机器人能力，设置机器人基本信息。 - -注意：消息接收模式中，选择 “Stream 模式” - -![Stream 模式](https://img.alicdn.com/imgextra/i3/O1CN01XL4piO1lkYX2F6sW6_!!6000000004857-0-tps-896-522.jpg) - -点击“点击调试”按钮，可以创建测试群进行测试。 - -3、启动应用 - -修改参数，启动应用 -```Shell -go run example/*.go -client_id "your-client-id" -client_secret "your-client-secret" -``` - -测试效果： -![calcbot](https://img.alicdn.com/imgextra/i1/O1CN0124eJfc29J7aK1Jtzu_!!6000000008046-0-tps-1740-762.jpg) - -### 事件订阅切换到 Stream 模式（可选） - -进入钉钉开发者后台，选择企业内部应用，在应用管理的左侧导航中，选择“事件与回调”。 -“订阅管理”中，“推送方式”选项中，选择 “Stream 模式”，并保存 - - -### 技术支持 - -[点击链接，加入Stream模式共创群交流](https://open-dingtalk.github.io/developerpedia/docs/explore/support/?via=moon-group) +* [Stream 模式说明](https://opensource.dingtalk.com/developerpedia/docs/learn/stream/overview) +* [教程文档](https://opensource.dingtalk.com/developerpedia/docs/explore/tutorials/stream/overview) +* [常见问题](https://opensource.dingtalk.com/developerpedia/docs/learn/stream/faq) +* [Stream 模式共创群](https://opensource.dingtalk.com/developerpedia/docs/explore/support/?via=moon-group)