通知与投递
Anyy 可以通过常驻 Gateway 发布即时通知和用户可见消息。投递目标基于可信路由:助手可以联系当前用户,或回复当前 Channel 对话的来源,但不能把平台名或任意账号当作外部联系人地址。
两种发送动作
| 动作 | 适用场景 |
|---|---|
| Notification | 立即向用户展示标题和消息 |
| Message | 向当前用户或可信 Channel 来源发送文字和受支持附件 |
两种操作都会被审计。发送不是幂等操作:盲目重试可能产生重复消息。
投递目标
| Target | 含义 |
|---|---|
gateway | 发布到常驻 Gateway 事件流 |
origin | 回复当前 Channel 会话的可信来源 |
current_user_default | 解析当前用户的默认 Channel 绑定,可按平台选择 |
none | 不投递用户可见结果 |
只有已经配置并授权的 Channel Binding 才能成为真实路由。Anyy 不会根据平台名猜测收件人。
在对话中发送
检查结束后通知我,标题为“备份验证完成”,正文只写一行结果。
把这份摘要发回当前 Channel 对话。
把生成的报告发送到我默认的 Telegram 绑定。
没有可信来源或默认绑定时,Anyy 会返回路由不可用,而不是尝试一个不确定的目标。
回执与实际送达
发布成功表示 Anyy 已经接受事件并交给投递管线,不能单独证明 Telegram、邮件、短信或其他外部服务最终收到。
消息可以生成 Receipt,后续反映 Adapter 的投递进度。不同平台能力不同:有的能返回确认,有的只能确认已经分发。
状态不明时不要立即重发
先查看 Receipt 和 Channel 健康状态。第一条消息可能已经到达提供商,只是确认延迟;再次发送会造成重复。
附件
Channel 声明支持相应媒体类型时,消息可以携带 Anyy 的出站附件。不受支持的附件会明确报错,不会静默丢弃。
配置默认路由
先在 Dashboard → Channel 或 anyy setup channel 中完成连接,验证访问策略和收发能力。定时任务随后可以使用 current_user_default,并指定投递 Channel。
故障排查
| 现象 | 处理方法 |
|---|---|
| 没有默认路由 | 为当前用户配置并验证 Channel Binding |
| 无法投递到来源 | 请求必须来自可信 Channel 对话 |
| 发布成功但外部没有消息 | 检查 Receipt、Gateway 状态和 Channel doctor |
| 出现重复消息 | 停止自动重试,检查前一条 Receipt 或事件 |
| 附件被拒绝 | 使用目标 Channel 支持的媒体类型 |