doc: add in the dingtalk.md and lark.md stream config need add condition (#57)
* doc: add in the dingtalk.md and lark.md stream config need add condition * doc: add in the english dingtalk.md and lark.md stream config need add condition
|
After Width: | Height: | Size: 246 KiB |
|
After Width: | Height: | Size: 256 KiB |
|
After Width: | Height: | Size: 138 KiB |
|
After Width: | Height: | Size: 140 KiB |
|
After Width: | Height: | Size: 144 KiB |
|
After Width: | Height: | Size: 124 KiB |
|
After Width: | Height: | Size: 124 KiB |
|
After Width: | Height: | Size: 158 KiB |
|
After Width: | Height: | Size: 100 KiB |
|
After Width: | Height: | Size: 582 KiB |
|
After Width: | Height: | Size: 110 KiB |
|
After Width: | Height: | Size: 129 KiB |
|
After Width: | Height: | Size: 101 KiB |
@@ -24,6 +24,34 @@ If this is the first time creating a bot, the right side is empty, you need to c
|
||||
|
||||
Click `Event Subscription`, change the push method to `Stream Mode Push`.
|
||||
|
||||
If card streaming is needed, you must apply for card permissions in the permission management, as shown:
|
||||

|
||||
|
||||

|
||||
|
||||
Additionally, for card messages you mainly need to create a card template and record the template ID to fill in the configuration, the process is as follows:
|
||||
> The card content template ID can be obtained by logging into the developer backend > [Card Platform](https://open-dev.dingtalk.com/fe/card?spm=ding_open_doc.document.0.0.33cf2281L0fXsV)
|
||||
|
||||
Fill in information when creating a new template, as shown:
|
||||

|
||||
|
||||
Select a preset template (just choose the first one and modify the template content later), as shown:
|
||||

|
||||
Click Use
|
||||

|
||||
Create
|
||||

|
||||
|
||||
After clicking Create you'll be redirected to edit the template. As shown, you can freely edit your desired card message:
|
||||

|
||||
|
||||
For the main content, keep the default 'content' unchanged:
|
||||

|
||||
|
||||
After editing and confirming everything is correct, save it and copy the template ID to fill in the configuration file:
|
||||

|
||||

|
||||
|
||||
## Fill in Configuration Information
|
||||
|
||||
Click `Credentials and Basic Information`, record `Client ID` and `Client Secret`,
|
||||
@@ -31,8 +59,13 @@ Click `Application Capabilities`, `Robot`, record the RobotCode and Robot Name.
|
||||
`markdown_card` is whether to enable Markdown form replies.
|
||||
Record the above configuration items and fill them in the LangBot bot configuration form
|
||||
|
||||
Click [Card Platform](https://open-dev.dingtalk.com/fe/card?spm=ding_open_doc.document.0.0.33cf2281L0fXsV), copy the corresponding bound template ID from the template list, and fill it into the card template ID field.
|
||||
|
||||

|
||||
|
||||
Streaming related:
|
||||

|
||||
|
||||
**Start LangBot**.
|
||||
|
||||
## Add Bot
|
||||
|
||||
@@ -15,6 +15,10 @@ Add the permissions shown in the image in the permission management:
|
||||
|
||||

|
||||
|
||||
If card streaming permissions are required, additionally add the following card creation and update permissions as shown in the image:
|
||||
|
||||

|
||||
|
||||
## Connect to LangBot
|
||||
|
||||
Find `app_id` and `app_secret` on the `Credentials and Basic Information` page.
|
||||
@@ -29,6 +33,9 @@ Fill in the relevant information in the form
|
||||
|
||||

|
||||
|
||||
Streaming related:
|
||||

|
||||
|
||||
After filling in, start LangBot. If configured successfully, the log will show `[01-29 23:42:56.796] manager.py (68) - [INFO] : Initializing platform adapter 1: lark`, keep LangBot running.
|
||||
|
||||
:::warning
|
||||
|
||||
@@ -24,6 +24,35 @@
|
||||
|
||||
点击`事件订阅`,将其中的推送方式改为`Stream模式推送`。
|
||||
|
||||
如果需要卡片流式,则需要在权限管理中申请卡片权限,如图:
|
||||

|
||||
|
||||

|
||||
|
||||
另外卡片消息主要创建卡片模板,并记录模板id填入配置信息,流程如下:
|
||||
> 卡片内容模板ID,可通过登录开发者后台 > [卡片平台](https://open-dev.dingtalk.com/fe/card?spm=ding_open_doc.document.0.0.33cf2281L0fXsV)获取
|
||||
|
||||
新建模板填写信息,如图:
|
||||

|
||||
|
||||
选择预设模板(直接选第一个然后进去后更改模板内容),如图:
|
||||

|
||||
点击使用
|
||||

|
||||
创建
|
||||

|
||||
|
||||
点击创建后会跳转到编辑模板。如图,这样你就可以尽情的编辑你想要的卡片消息了:
|
||||

|
||||
|
||||
主内容这里默认content不要改动即可:
|
||||

|
||||
|
||||
编辑好没问题之后保存即可,并复制模板id用以填写配置文件:
|
||||

|
||||

|
||||
|
||||
|
||||
## 填写配置信息
|
||||
|
||||
点击`凭证与基础信息`,记录`Client ID` 和 `Client Secret`,
|
||||
@@ -31,8 +60,14 @@
|
||||
`markdown_card` 为是否启用 Markdown 形式的回复,当此配置项关闭时,`@发送者` 配置开关不会生效。
|
||||
将以上配置项 记录下来,填到 LangBot 机器人配置表单中。
|
||||
|
||||
点击[卡片平台](https://open-dev.dingtalk.com/fe/card?spm=ding_open_doc.document.0.0.33cf2281L0fXsV)模板列表复制绑定的对应的模板id填入卡片模板id
|
||||
|
||||
|
||||

|
||||
|
||||
流式相关:
|
||||

|
||||
|
||||
**启动 LangBot** 。
|
||||
|
||||
## 添加机器人
|
||||
|
||||
@@ -15,6 +15,10 @@
|
||||
|
||||

|
||||
|
||||
如需卡片流式权限则多添加如下图的创建与更新卡片:
|
||||
|
||||

|
||||
|
||||
## 对接 LangBot
|
||||
|
||||
在`凭证与基础信息`页找到`app_id`和`app_secret`。
|
||||
@@ -29,6 +33,9 @@
|
||||
|
||||

|
||||
|
||||
流式相关:
|
||||

|
||||
|
||||
填写完成后启动 LangBot,若成功配置,日志中会出现`[01-29 23:42:56.796] manager.py (68) - [INFO] : 初始化平台适配器 1: lark`的字样,保持 LangBot 运行。
|
||||
|
||||
:::warning
|
||||
|
||||