> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 消息通知模板

> 本文介绍了如何在宜搭工作台中配置消息通知模板，包括创建新模板、设置模板类型（如普通消息或钉钉待办）以及使用这些模板的方法。还提供了关于内置变量格式的信息，帮助用户更好地定制消息内容。

消息通知模板用于在表单流程执行到某个节点时，通过已经配置完成的通知模板，向指定人员发送钉钉消息提醒或待办任务。你可以参考本文操作了解如何配置消息通知模板。

| 能力     | 免费版 | 轻享版 | 专业版 | 专属版 |
| ------ | --- | --- | --- | --- |
| 消息通知模板 | 不支持 | 支持  | 支持  | 支持  |

## 配置消息模板

<Steps>
  <Step title="步骤 1">
    使用管理员身份，登录[宜搭工作台](https://www.yidaapps.com/workPlatform)。
  </Step>

  <Step title="步骤 2">
    单击右上角平台管理<img className="inline-icon" src="https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1700653499495-cafaf794-410f-4099-ac18-6e134fc14278.png" width="16" alt="" />按钮，进入平台管理页面。
  </Step>
</Steps>

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1701051152649-8921a803-b739-437e-bc85-261c9f4cb23c.png)
</Frame>

<Steps>
  <Step title="在左侧菜单栏单击 消息通知模板">
    <Frame>
      ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1701138308706-e77b4837-379e-475e-8c97-be0ff20a1ea5.png)
    </Frame>
  </Step>

  <Step title="单击 新建模板 ，单后参考以下内容配置模板，最后单击 确定 完成模板创建" />
</Steps>

<table>
  <tr>
    <td>属性</td>
    <td>说明</td>
  </tr>

  <tr>
    <td>模板名称</td>
    <td>请输入创建的消息模板名称。</td>
  </tr>

  <tr>
    <td>管理员</td>
    <td>此消息模板管理员，支持设置多个。</td>
  </tr>

  <tr>
    <td rowSpan={2}>模板类型</td>
    <td>**普通消息**：目前仅支持发送钉钉消息通知。<br /><ul><li>**消息标题**：消息通知的标题。此标题会同时透出到消息列表和会话列表。</li><li>**消息内容**：推送的消息内容主体。消息内容支持配置变量，变量为表单组件的ID，变量格式为`$!{字段ID}`。在发送消息时，宜搭会自动将该变量替换为表单组件的值。详情请参考[内置变量格式](/zh/yida/platform-admin/fkfhud)。</li></ul><br />![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1701226251728-70454fd0-7942-423c-91eb-244e659a5c3b.png)</td>
  </tr>

  <tr>
    <td>**钉钉待办**：目前钉钉待办类型的消息通知仅支持轻享版及以上版本。详情可参考[版本差异](https://www.yidaapps.com/pricing)。<br /><ul><li>**消息标题**：待办任务标题。</li><li>**消息内容**：待办任务详情。支持配置变量，变量为表单组件的ID，变量格式为`$!{字段ID}`。在发送消息时，宜搭会自动将该变量替换为表单组件的值。详情请参考[内置变量格式](/zh/yida/platform-admin/fkfhud)。</li></ul><br />![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1701226943520-c6da23aa-4165-4bd4-a11b-3ce4004652c2.png)<br />**说明**：每个企业最多创建 200 钉钉待办模板，超出后会报错。</td>
  </tr>
</table>

## 使用消息模板

你可以通过以下两种方式使用消息模板。

* 方式一：在流程表单流程设计的消息通知节点使用。详情请参考 消息通知节点 。
* 方式二：在表单页面设置中使用消息模板。详情请参考 表单消息通知 。

<Note>
  普通表单暂不支持使用钉钉待办类型的消息模板。
</Note>

## 内置变量格式

消息模板中的消息内容支持配置变量，变量为表单组件的ID，变量格式为`$!{组件ID}`。在发送消息时，宜搭会自动将该变量替换为表单组件的值。

| 变量                       | 字段       | 表单 | 流程 |
| ------------------------ | -------- | -- | -- |
| \$!\{formInstId}         | 实例ID     | ✓  | ✓  |
| \$!\{formUuid}           | 表单Code   | ✓  | ✓  |
| \$!\{formTitle}          | 表单名称     | ✓  | ✓  |
| \$!\{formTitleEn}        | 表单英文名称   | ✓  | ✓  |
| \$!\{title}              | 表单实例标题   | ✓  | ✓  |
| \$!\{titleEn}            | 表单英文实例标题 | ✓  | ✓  |
| \$!\{creator}            | 创建人工号    | ✓  | ✓  |
| \$!\{originator}         | 发起人工号    | ✓  | ✓  |
| \$!\{originatorName}     | 发起人姓名    | ✓  | ✓  |
| \$!\{originatorNameEn}   | 发起人英文姓名  | ✓  | ✓  |
| \$!\{serialNo}           | 流水号      | ✓  | ✓  |
| \$!\{createTime}         | 创建时间     | ✓  | ✓  |
| \$!\{modifiedTime}       | 修改时间     | ✓  | ✓  |
| \$!\{processInstStatus}  | 流程实例状态   | ✗  | ✓  |
| \$!\{approvedResult}     | 审批结果     | ✗  | ✓  |
| \$!\{approvedResultCode} | 审批结果Code | ✗  | ✓  |
