Zion 通讯行为

本指南详细介绍如何在 Zion 平台中配置和使用通讯相关行为，包括微信提醒、短信通知、电话拨打、消息授权、获取手机号及唤起小程序客服。适用于需要在小程序内实现消息推送与用户互动的开发者和运营人员。

通讯行为类型

微信提醒
短信提醒
拨打电话
授权消息通知
获取用户手机号
唤起小程序客服

微信提醒

应用场景

移动应用除了通过交互界面与用户互动外，通知用户和唤回用户也是重要场景。例如：通知发货、外卖送达、新活动报名等。用户可通过点击通知卡片快速进入小程序。

小程序订阅消息分为“长期订阅消息”和“一次性订阅消息”。目前长期订阅仅开放给政务民生、医疗、交通、金融、教育等线下公共服务领域。普通小程序一般只能使用“一次性订阅消息”。

小程序订阅消息通知	服务号通知

区别说明

展示位置：
- 小程序订阅消息通知：集中展示在微信“服务通知”集合。
- 服务号通知：单独展示于服务号提醒，需用户关注服务号。
授权要求：
- 小程序订阅消息通知：需用户授权，每次授权仅可发送一次消息。
- 服务号通知：用户关注后可持续推送，取消关注则无法继续通知。

配置流程

创建消息模板与授权消息提醒（详见“授权消息提醒”章节）。
发送微信提醒：需用户已授权且有剩余授权次数，必须在“行为流”中配置【微信提醒】行为。
添加行为流：
- 在编辑器左上角点击【行为流】，进入行为流编辑界面。
- 新建行为流并命名，点击“入参”，根据短信提醒模板配置参数（如 thing1、date2、thing4、accountId）。
- 添加并编辑代码块，参数与模板一致。
- 代码示例：


const thing1 = context.getArg('thing1')
const thing4 = context.getArg('thing4')
const date2 = context.getArg('date2')
const accountId = context.getArg('accountId')
const data = { thing1, date2, thing4 } // 按消息模板调整
const gql = `mutation publishWechatMessage($data: Map_String_StringScalar,$accountId:Long!){
  publishWechatMessage(
    accountId: $accountId
    data: $data
    miniprogramState: FORMAL
    page: "pages/lil7gbne/lil7gbne"
    lang: CN
    templateId: "RQH7FafxS4_jQsRSN6ujLLKUoWuXpC3uLvYP1WL75Ys" // 替换为实际模板ID
  )
}`
context.runGql(
  'publishWechatMessage',
  gql,
  { data, accountId },
  { role: 'admin' }
)

参数说明：
- page：点击模板卡片后跳转的小程序页面（页面组件ID可在页面右上角复制）。
- accountId：接收消息的用户账户ID。
- thing1、thing4、date2 及 templateId 需与微信后台模板一致。

效果展示

时间格式示例	行为配置示例	效果展示

短信提醒

通过点击行为触发发送手机短信。需先配置短信模板，并在行为流中设置短信发送行为。

配置流程

配置短信模板
- 上传营业执照
- 发送短信设置：上传营业执照后可配置短信模板。短信签名为短信内容前缀（如【函子科技】），一个项目仅能设置一个签名，审核通过后不可更改。
委托书注意事项
1. 授权书需法定代表人/负责人签字。
2. 签署日期需完整填写。
3. 被授权方为“函子科技（上海）有限公司”。
4. 实际申请签名与授权书一致。
- 短信签名：在发送短信设置中配置。
- 签名来源：公众号或小程序。
- 描述：说明用途及小程序/公众号名称。
- 设置短信模板：填写模板名称、分类（建议选择“短信通知”）、描述及内容（支持变量如 $(username)）。

注意：审核中/通过的模板不可修改，模板内容变量需用字符隔开，内容不能包含【】，首尾不能为[]。

模板配置页面	模板详情页面

触发短信发送
- 在 Zion 行为流中新建行为流（如“购买成功短信通知”）。
- 定义入参：
  - phone_number：接收短信手机号（必填，文本类型）。
  - username：用户名（如模板中有该参数）。
  - variable：服务内容（如模板中有该参数）。
- 添加代码块操作，参数名称与入参一致。
- 编写代码（templateCode 需联系 Zion 工作人员获取）：


const phone_number = context.getArg('phone_number') // 获取手机号
const variable = context.getArg('variable') // 获取服务内容
const username = context.getArg('username') // 获取用户名
const gql = `mutation sendMessage($phone_number: String, $variable: String, $username:String ){
  sendSmsByTemplateId(
    phoneNumber: $phone_number,
    templateParams: {variable:$variable,username:$username},
    templateCode: "SMS_276195458"
  )
}
`
context.runGql(
  'sendMessage',
  gql,
  { phone_number, variable, username },
  { role: 'admin' }
)