核心用法
Yuboto Omni API 技能为开发者提供完整的 Yuboto/Octapush 消息平台集成能力，覆盖 SMS、Viber 等多通道通信场景。
主要功能模块：
- 消息发送：SMS 单条/批量发送、Viber 富媒体消息
- 状态追踪：DLR（送达回执）查询、消息历史记录
- 账户管理：余额查询、发送成本估算
- 联系人管理：订阅者列表、黑名单、联系人 CRUD
- 回调处理：Webhook 接收与解析
工作流程：
1. 通过 references/api_quick_reference.md 或 find_endpoints.py 脚本定位端点
2. 以 references/swagger_v1.json 为权威契约验证请求/响应模式
3. 使用 yuboto_cli.py 提供的 CLI 命令快速验证
4. 生成生产代码时包含认证头、重试机制、错误映射
文档权威性层级： Swagger JSON > 速查表 > 旧版 PDF，端点冲突时以 Swagger 为准。
显著优点
- 多源文档交叉验证：明确区分 Swagger 活文档与 PDF 历史文档的优先级，避免集成陷阱
- OpenClaw 原生集成：支持集中化凭证管理，无需硬编码 API Key
- 实用 CLI 工具链：内置 balance、cost、send-sms、dlr、send-csv 等即开即用命令
- 安全最佳实践：强制环境变量存储、警示
.env文件风险、提供 shell history 防护建议
潜在局限
- 凭证配置门槛：需手动配置
OCTAPUSH_API_KEY，技能元数据未声明依赖，新手易遗漏 - 注册流程非自助：需联系 Yuboto 支持开通 API 权限，无法即时启用
- 希腊市场导向：默认示例、成本估算均以希腊（GR）为基准，国际用户需额外适配
- 无原生 SDK：仅提供 REST API 封装，复杂场景需自行实现重试、限流、批量队列
适合人群
- 需要集成 SMS/Viber 通知的企业后端开发者
- 已有 Octapush/Yuboto 账户的运维工程师
- 寻求替代 Twilio/MessageBird 的欧盟合规通信方案团队
常规风险
- 凭证泄露：
poll_pending.sh会意外加载.env文件，可能混入无关敏感变量 - 发送成本失控：未设置余额告警时，批量发送可能导致透支
- 发送者 ID 审核：使用未审批的 sender ID 会导致消息拦截
- 数据驻留合规：本地日志可能包含 PII（手机号、消息预览），需符合 GDPR 处理规范