用途:该技能面向使用 Telnyx 通信 API 构建通信功能的开发场景,包括短信/彩信收发、语音呼叫(Call Control API)、电话号码搜索与购买、消息配置文件配置、Webhook 实时事件处理、双向短信会话、批量短信、消息定时发送、生产部署以及美国 A2P 短信的 10DLC 品牌与活动注册。
主要能力:提供发送短信、E.164 号码校验与格式化、接收消息 Webhook、Ed25519 签名验证、带重试的错误处理、限速批量发送、基于数据库唯一约束的幂等 Webhook 处理、双向会话状态机、10DLC 活动状态查询与常见错误分类处理等示例。
使用方式:所有请求使用 Bearer Token 认证,例如 Authorization: Bearer YOUR_API_KEY,API 密钥应放在环境变量中。发送短信调用 POST https://api.telnyx.com/v2/messages,传入 from、to、text。Webhook 需校验 telnyx-signature-ed25519 与 telnyx-timestamp 头,并检查时间戳新鲜度以防重放。10DLC 状态可用 curl 查询 https://api.telnyx.com/v2/10dlc/campaign/${CAMPAIGN_ID}。
适用场景:短信通知系统、语音 IVR、双向短信交互、批量通知、美国 A2P 合规注册等。
限制:资料未提供具体收费与价格信息;10DLC 号码关联仅能在门户完成,不能通过 API;活动审批需经历 TCR_ACCEPTED、MNO_PENDING、MNO_PROVISIONED 阶段;长消息按 GSM-7 或 UCS-2 分段,MMS 格式有限制。部分细节暂未提供。