用途:本技能提供通过 curl 使用 Telnyx 消息 REST API 的操作说明,用于设置托管 SMS 号码、提交 toll-free 验证,并启用 RCS 富消息功能,适用于号码迁移或开启富消息能力。
主要能力:RCS 方面可发送 RCS 消息(POST /messages/rcs)、生成 RCS 深链、列出/获取/修改 RCS 代理、批量或单个检查 RCS 能力、添加 RCS 测试号码。托管号码方面可列出、创建、获取、删除托管号码订单,检查托管资格,上传 LOA 与账单文件,创建与校验验证码,删除托管号码。toll-free 方面可列出、提交、获取与更新验证请求。
使用方式:curl 通常已预装;设置 export TELNYX_API_KEY="YOUR_API_KEY_HERE",请求时带 -H "Authorization: Bearer $TELNYX_API_KEY"。示例调用 https://api.telnyx.com/v2/messages 发送消息。列表接口分页使用 page[number] 与 page[size],可查看 meta.total_pages。
限制与注意:号码须为 E.164 格式(如 +13125550001),含加号与国家代码,不含空格、短横线或括号。生产代码应处理 401 密钥无效、403 权限不足、404 资源不存在、422 校验错误、429 限流(指数退避重试)。资费、平台可用性与完整字段约束暂未提供。