Appearance
企微（代开发）消息通知插件
当您需要向企微代开发应用发送通知时，可以参考以下文档进行配置和使用。
1. 插件介绍
1.1 功能介绍
通过此接口，您可以向指定的成员或部门发送文本消息、Markdown格式信息、
文本卡片等多种类型的消息。
1.2 效果展示
注意：这里只展示了markdown类型的消息效果。
2. 使用前配置
将本平台以代开发的形式集成到企业微信中。(详情可浏览教程文档 集成企业微信教程)
在组织管理中将企业中的成员导入系统中，确保能够进行消息通知。
3. 接口使用说明(文本类型)
3.1 效果展示
3.2 参数介绍
接口调用时，需要传入以下 参数：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 通知成员列表 | 子表类型 | ✔️ | 在成员单选、成员多选、部门单选、部门多选中选择想要通知的成员或部门。可以同时选择不同的成员或部门 |
| 通知内容 | 文本类型 | ✔️ | 要通知的具体内容(文本类型) |
| 超链接列表 | 子表类型 | 填写关键字和相应的跳转链接后,使通知内容中的某些关键字显示跳转链接 |
提示
小提示：确保传入的通知成员列表至少包含一个成员。
3.3 使用示例
- 选择名为 “消息通知(文本类型)” 功能表单。
- 点击右上方的 “+记录” 按钮。
- 按照
引导填写相关数据，最后点击 “提交” 按钮。 - 选中新增记录，点击 企微通知 按钮，完成消息的推送。
提示
快速操作：如果您没有填写完所有表单字段，可以点击 “存为草稿”，然后下次编辑。
4. 接口使用说明(markdown类型)
4.1 效果展示
4.2 参数介绍
接口调用时，需要传入以下 参数：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 通知成员列表 | 子表类型 | ✔️ | 在成员单选、成员多选、部门单选、部门多选中选择想要通知的成员或部门。可以同时选择不同的成员或部门 |
| 通知内容 | 文本类型 | ✔️ | 要通知的具体内容(支持部分markdown语法) |
提示
小提示：确保传入的通知成员列表至少包含一个成员。
4.3 使用示例
- 选择名为 “消息通知(markdown类型)” 功能表单。
- 点击右上方的 “+记录” 按钮。
- 按照
引导填写相关数据，最后点击 “提交” 按钮。 - 选中新增记录，点击 企微通知 按钮，完成消息的推送。
提示
注意：如果您不熟悉markdown的语法,可以参考表单引导中的示例,或者参考Markdown语法参考
5. 接口使用说明(文本卡片类型)
5.1 效果展示
5.2 参数介绍
接口调用时，需要传入以下 参数：
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| 通知标题 | 文本类型 | ✔️ | 标题，不超过128个字符 |
| 通知内容 | 文本类型 | ✔️ | 要通知的具体内容(支持部分html标签) |
| 跳转链接 | 文本类型 | ✔️ | 点击后跳转的链接,请确保包含了协议头(http/https) |
| 通知成员列表 | 子表类型 | ✔️ | 在成员单选、成员多选、部门单选、部门多选中选择想要通知的成员或部门。可以同时选择不同的成员或部门 |
提示
小提示：这里的跳转链接为必填选项。
5.3 使用示例
- 选择名为 “消息通知(消息卡片类型)” 功能表单。
- 点击右上方的 “+记录” 按钮。
- 按照
引导填写相关数据，最后点击 “提交” 按钮。 - 选中新增记录，点击 企微通知 按钮，完成消息的推送。
6. 常见问题
Q1: 如何检查接口是否成功调用？
- 答：您可以在工作流中查看调用业务流程的日志，看HTTP请求的状态,如果返回 200 OK，则表示推送成功。如果返回其他状态码，说明接口调用失败。
Q2: 不清楚通知内容的格式怎么办？
- 答：在消息通知的表单中有新增数据的引导,可以参考和使用里面的示例。