SuperAPI AI 工具集

salla-communication-app

通用与其它

查看项目

更新于 10-16 01:26

技能介绍

用途:构建 Salla 通信应用,接管 SMS、Email、WhatsApp 的消息投递。店铺事件(订单状态变更、OTP 请求、弃购等)触发时,Salla 把组装好的消息交给你的 App Function;路由和投递由你负责,触发由 Salla 负责。

主要能力:声明支持渠道后,商户把应用设为该渠道的活跃处理器,Salla 便停止使用默认投递层,把所有匹配消息路由到你的函数。支持渠道值:sms_local(沙特境内短信)、sms_international(境外短信)、email_all(全部邮件)、whatsapp(全部 WhatsApp),分别对应 communication.sms.send、communication.email.send、communication.whatsapp.send 事件。本地与国际短信共用同一 SMS 事件,可按 notifiable[0] 号码前缀路由。

使用方式:先用 salla-app-builder 以 type: "communication" 创建应用(无 sub_category_id,0 个默认 webhook,is_embedded 默认 true)。通过 salla_settings action=set_features 至少声明一个渠道,否则发布报 403。在 App Settings 表单中填写服务商凭据(如 Twilio 的 Account SID、Auth Token、发送号码),运行时从 context.settings 读取。事件实现为 App Function:读取 payload 与 settings,调用服务商,返回 Resp.success() 或 Resp.error()。测试分两阶段:函数编辑器预览面板,以及在演示店铺安装后于 Apps → Settings → Customize 设为活跃处理器并触发真实消息。发布走标准流程,已安装商户自动获得更新。

限制与合规:SMS 应用需在账户验证表单上传 CITC 认证,requires_citc 为 true 时提交被阻止。凭据必须由每个商户自行提供,不得硬编码或存到自身数据库。消息内容、收件人和凭据不得写入日志。仅当投递必须运行在自有基础设施时才回退到 webhook 订阅。具体字段与最新取值以官方文档与工具 schema 为准,部分细节暂未提供。