📝 docs(tsl): rebuild canonical syntax and routing manual
This commit is contained in:
@@ -1,6 +1,14 @@
|
||||
# 发送微信消息使用说明
|
||||
|
||||
## 摘要
|
||||
文档类型:模块摘要
|
||||
是否可直接用于生成代码:仅部分
|
||||
是否含已验证可执行示例:否
|
||||
是否含已验证反例:否
|
||||
遇到不确定时跳转到:调用侧账户体系文档、项目实际接口说明、[index.md](index.md)
|
||||
|
||||
本页用于确认接口名称、参数含义和风险边界,不替代项目级接入文档。
|
||||
|
||||
## 适用场景
|
||||
|
||||
- 通过“天软科技服务号”向微信客户端发送模板消息。
|
||||
- 支持同步/异步发送,异步可用消息 ID 查询状态。
|
||||
@@ -22,6 +30,7 @@
|
||||
## 参数说明(模板消息)
|
||||
|
||||
- `userid`:绑定账户后获取的用户标识(必需)。
|
||||
- `username`:查询异步发送状态时使用的用户名 / 账户标识;当前页只确认查询接口需要它,具体来源以项目实际账户体系或调用侧约定为准。如果调用侧拿不到该值,当前页不支持生成状态查询代码。
|
||||
- `url`:详情地址(必需,可为空字符串)。
|
||||
- `title`:模板消息标题(必需)。
|
||||
- `first`:副标题(一般需要)。
|
||||
@@ -35,8 +44,23 @@
|
||||
|
||||
- 同步:阻塞等待结果,适合紧急通知。
|
||||
- 异步:立即返回,适合非紧急通知;用 `get_wechat_message_status` 查询。
|
||||
- 如果你无法确认 `username` 的来源,不要自行猜测;先回调用侧或账户体系文档确认。
|
||||
|
||||
## 示例(TSL)
|
||||
## 当前只确认的范围
|
||||
|
||||
- 当前页已经确认的范围是:发送接口名、异步发送会返回消息 ID、状态查询接口需要 `userid` + `username` + `wechat_message_id`。
|
||||
- 当前页没有确认的范围是:`username` 的正式来源、不同模板关键字的完整映射、项目侧的统一封装方式。
|
||||
|
||||
## 不要猜的部分
|
||||
|
||||
- 不要把 `"username"` 当成可用实参,也不要凭空拼接账户名。
|
||||
- 如果调用侧没有提供 `username`,当前页只支持生成发送代码,不支持生成状态查询代码。
|
||||
- `k1..k6` 的含义随模板类型变化;需要和具体模板一起核对。
|
||||
|
||||
## 发送示例(配置片段,可参考参数组织)
|
||||
|
||||
代码块身份:配置片段 / 概念骨架
|
||||
代码块说明:可参考参数组织,不是已验证可执行示例。
|
||||
|
||||
```tsl
|
||||
// 定义参数
|
||||
@@ -55,6 +79,9 @@ echo send_wechat_message(user_id, url, title, first, remark, keyword_1, keyword_
|
||||
|
||||
// 异步发送
|
||||
wechat_message_id := send_wechat_message_async(user_id, url, title, first, remark, keyword_1, keyword_2);
|
||||
// 获取结果
|
||||
echo get_wechat_message_status(user_id, "username", wechat_message_id);
|
||||
```
|
||||
|
||||
## 状态查询示例
|
||||
|
||||
- 当前页不提供状态查询代码块。
|
||||
- 只有在调用侧已经明确提供 `username` 来源时,才继续生成 `get_wechat_message_status(...)` 调用。
|
||||
|
||||
Reference in New Issue
Block a user