¶ 易信达消息自动化使用说明
易信达消息自动化用于在企业微信消息进入易抵达后，按预先配置的条件自动处理业务。它的操作方式与“触发器”相近，但处理对象是群聊或联系人单聊消息，不是运单字段变化。
该功能主要由熟悉业务规则的内部人员或客服配置。普通业务人员可以通过列表中的最近触发状态判断规则是否正常；需要排查某条消息为什么这样处理时，再打开该规则的“历史日志”查看逐次执行记录。
¶ 使用前提
使用前请确认：
- 当前账号是内部员工，并具有“基础数据”和“易信达消息自动化”的查看权限；维护规则还需要相应的维护权限。
- 当前机构已经开通易信达。
- 当前机构至少配置了一个可以接收消息的易信达机器人。
- 如果规则需要处理文件，请确认易信达 APP 中的“不收文件”开关处于关闭状态。
系统可以判断机构是否已开通易信达、是否存在可接收消息的机器人，但不能读取手机上“不收文件”开关的状态，因此页面只会给出操作提醒。
即使机构尚未开通易信达，具备查看权限的员工仍可看到功能入口并了解用途；保存或启用规则时，系统会明确提示尚未满足的条件。
¶ 进入规则列表
进入“基础数据”，选择“易信达消息自动化”。
图中标记说明：
- 每条规则只显示当前版本最近一次明确触发的结果、时间和简要说明。
- 规则较多时可翻页，并可选择每页显示 30、50 或 100 条。
- 列表支持新建、复制、编辑、删除、启用、禁用和刷新。单击选择规则，双击也可以编辑。
删除、启用和禁用支持多选。删除规则时，该规则的全部历史日志会一并删除且不可恢复；已经生成的业务数据不受影响。各条规则彼此独立，同一条消息可以同时命中多条规则；其中一条规则失败，不会阻止其他规则继续处理。
¶ 新建或编辑规则
点击“新建”，或者选择一条规则后点击“编辑”。
图中标记说明：
- 规则名称：使用容易识别的业务名称。
- 触发条件：消息满足条件时才执行脚本。可使用预设条件，也可通过高级编辑输入 JavaScript 布尔表达式。
- 执行脚本：条件命中后执行的业务处理逻辑。页面中的“查看可用变量和函数”会显示常用能力；台湾报关等小众业务的专用函数不在页面帮助中展示，以对应配置文档为准。
- 确定/取消：确定后保存；取消时如有未保存修改，系统会询问是放弃修改还是继续编辑。
编辑已有规则时，弹窗顶部还有“历史日志”页签，用法见下文“历史日志”。新建或复制规则时没有该页签。
勾选“启用”并点击“确定”时，系统会检查机构是否已开通易信达、规则内容是否合法、是否存在可接收消息的机器人。全部通过并确认后，规则立即生效。取消勾选后保存，规则会保留为禁用状态。
消息处理时按照当时最新的已启用规则执行。修改规则不会重新处理历史消息。
¶ 触发条件怎么写
触发条件支持 JavaScript，不支持 TypeScript，并且必须返回 true 或 false。
只处理文件消息：
是否文件消息()
只处理群聊中的 Excel 文件：
是否群聊消息() && 是否文件消息() && 是否为指定文件扩展名('xls', 'xlsx')
只处理群聊中的图片：
是否群聊消息() && 是否图片消息()
“预设条件”里提供了“文件消息”“群聊中的文件消息”“群聊中的图片消息”三种常用写法，点选后会直接填入。
常用只读变量：
| 变量 | 用途 |
|---|---|
$message |
当前群聊或单聊消息，包括会话类型、会话名称、发送人、消息类型、文本和消息落库时间等信息 |
$file |
当前可处理的文件或图片的名称和扩展名；文本等其他消息时为空 |
常用条件函数：
| 函数 | 用途 |
|---|---|
是否群聊消息() |
判断当前消息是否来自企业微信群聊 |
是否单聊消息() |
判断当前消息是否来自企业微信联系人单聊 |
是否文件消息() |
判断当前消息是否为系统可以处理的文件消息 |
是否图片消息() |
判断当前消息是否为图片消息 |
是否为指定文件扩展名(...) |
判断文件扩展名是否匹配给出的任一扩展名，不区分大小写 |
¶ 执行脚本可以做什么
执行脚本只能调用系统开放的受控业务函数，不能直接访问数据库、服务器文件或任意网络地址。
当前开放的通用能力包括：
- 查找当前群最新绑定的客户；
- 查找客户可用的收货渠道；
- 计算指定日切时间的业务时间窗；
- 按客户、业务类型和明确的时间条件查询当前执行人有权查看的运单；
- 创建预报运单；
- 将当前消息文件上传到指定运单档案；
- 识别群内水单图片并自动登记未审核收款单（会消耗 AI 点数，配置方法见微信群水单自动登记收款单配置说明）。
- 判断群内文件是否发票、按文件名中的客户单号自动归档到运单档案并发起 AI 识别（会消耗 AI 点数，配置方法见客户在微信群发的发票，自动传到运单上）。
规则以创建人的当前账号身份执行，等同于创建人本人在界面上做同一件事：创建人看不到的运单、选不了的银行账户，规则同样不能使用。创建人的账号失效或缺少所需权限时，规则会明确记录失败原因，不会绕过权限。
¶ 最近触发状态有什么用
列表中的最近触发状态用于快速回答“这条规则最近一次运行是否正常”。
- 未触发：当前版本还没有遇到符合条件的消息。
- 成功：最近一次命中规则并执行完成。规则判断后决定不做业务处理（例如图片不是水单）也算成功，结果说明会写明原因。
- 失败：最近一次命中规则，但业务处理失败；结果说明会显示可理解的原因。
条件不匹配的消息不会改变最近触发状态。修改触发条件或执行脚本后会形成新版本，新版本首次命中前显示“未触发”。
业务脚本失败后，系统会继续处理后续消息，不会堵住整个会话。框架或数据库等系统异常由运维通过系统日志进一步排查。
¶ 历史日志
每条规则都保存自己的历史日志，记录每一次命中触发条件后的执行结果。条件不匹配的消息不会产生日志，因此日志只包含这条规则真正处理过的消息。
双击规则（或选择后点击“编辑”），切换到“历史日志”页签。
图中标记说明：
- 历史日志页签。存在尚未重新执行的失败记录时，页签标题会带数量提示，例如“历史日志（1）”。
- 按“全部 / 成功 / 失败”筛选，按“近 7 天 / 30 天 / 90 天”限定时间范围，或输入群名后回车搜索；数量会随筛选条件同步变化。
- 操作列：“详情”打开该次执行的完整信息；失败记录还提供“重新执行”。
- 结果说明列：用一句话说明这次执行做了什么或为什么没做。
其余各列：
| 列 | 含义 |
|---|---|
| 执行结果 | 成功或失败；失败行左侧有红色标记 |
| 消息时间 | 客户发送这条消息的时间 |
| 执行时间 | 系统处理这条消息的时间；重新执行时显示重新执行的时刻 |
| 群名 / 客户 | 消息所在群和规则解析到的客户；没有“查看客户名称”权限的账号只显示客户代码 |
| 消息 | 发送人和消息内容摘要，图片和文件显示文件名 |
| AI 点数 | 本次执行消耗的 AI 点数；没有调用 AI 时显示“—” |
点击“详情”可以看到消息内容、执行结果、系统逐步记录的执行过程、触发方式（自动或手动重试及操作人）、AI 点数和耗时。
图中标记说明：
- 消息内容。图片消息显示缩略图，点击缩略图或“查看原图”在当前页放大查看，“下载”直接保存原图；文字消息显示全文并提供“复制”；文件消息显示文件名和大小，“下载文件”直接保存。
- 消息信息：群名、客户、发送人、消息时间和消息编号。
- 执行结果与执行过程：按顺序列出规则做了哪些事，排查问题时从这里入手。
放大查看原图时，点击右上角“×”、按 Esc 或点击图片外的区域即可关闭，回到执行详情。
历史日志的保留天数显示在筛选行右侧（默认 90 天），到期自动清理；需要调整保留期请联系客服。同一时间范围内记录超过 2000 条时，列表只显示最近的 2000 条，请缩小时间范围查看其余记录。
¶ 重新执行失败的记录
失败记录可以在修正原因（例如补充客户绑定、充值 AI 点数、调整权限）后点击“重新执行”。重新执行按规则当前版本重新处理这条原始消息，完整走一遍业务流程；需要“易信达消息自动化”的维护权限，且规则必须处于启用状态。
- 执行结果会新增一条日志，触发方式显示“手动重试”和操作人；原失败记录保留并标记为“已重试”，不能再次点击。
- 再次失败时，新记录仍然可以继续重新执行。
- 规则修改后，如果当前版本的触发条件已经不再匹配这条消息，系统会提示“未执行”，不产生新日志，原记录保持可重试。
- 原始消息已按保留期清理时无法重新执行。
- 已经生成业务单据的消息不会因重新执行而重复生成；具体以各业务能力的说明为准。
¶ 常见问题
¶ 为什么规则收不到文件？
先确认当前机构存在可接收消息的机器人，再检查易信达 APP 中的“不收文件”开关。需要处理文件时，该开关必须处于关闭状态。
¶ 为什么能看到模块却不能保存或启用？
入口不会因为机构尚未开通易信达而隐藏。保存或启用失败时，请根据页面提示分别检查易信达开通状态、可接收消息的机器人和当前账号权限。
¶ 运单存在，为什么脚本仍提示没有权限？
自动化以规则创建人的当前身份执行。请检查创建人是否仍为有效员工，以及是否具备相应业务类型的运单查看、建单和档案上传权限。
¶ 多条规则会互相覆盖吗？
不会。规则不互斥、不设置优先级，各自独立判断和执行。
¶ 群里发了消息，历史日志里为什么没有记录？
历史日志只记录命中触发条件的消息。先核对触发条件是否覆盖这类消息（例如图片消息需要 是否图片消息()），再确认机器人是否正常收到消息、规则当时是否处于启用状态。
¶ 历史日志能保留多久？
默认 90 天，到期自动清理。删除规则时，该规则的日志也会一并删除。