用途：面向美国 A2P 短信合规的 10DLC（品牌与活动）注册流程，使用 curl 直接调用 Telnyx REST API。
准备：curl 在 macOS、Linux、Windows 10+ 预装。设置环境变量：export TELNYX_API_KEY="YOUR_API_KEY_HERE"，后续请求用 Bearer $TELNYX_API_KEY 认证。
核心流程（顺序执行）：1）创建品牌 POST /10dlc/brand，必填 entityType、displayName、country、email、vertical。2）提交活动 POST /10dlc/campaignBuilder，必填 brandId、description、usecase。3）将消息配置指派到活动 POST /10dlc/phoneNumberAssignmentByProfile，必填 messagingProfileId、campaignId。也可以用 POST /10dlc/phone_number_campaigns 把具体号码关联到活动。
响应与状态：创建品牌返回 .data.brandId 等；活动返回 .data.campaignId、campaignStatus、submissionStatus、failureReasons；指派返回 taskId，可用 GET /10dlc/phoneNumberAssignmentByProfile/{taskId} 查询任务状态。注册状态应作为控制流判断，未确认状态前不要假定可发送。
错误处理：可能遇到 401 密钥无效、403 权限不足、404 资源不存在、422 校验失败、429 限流（指数退避重试）。列表端点分页，使用 page[number]、page[size]，并查看 meta.total_pages。
Webhook：Telnyx 使用 Ed25519 签名，请求含 telnyx-signature-ed25519 与 telnyx-timestamp 头，时间戳超过 5 分钟应拒绝；请用官方 SDK 验证签名，端点须在 2 秒内返回 2xx，否则会重试（最多 3 次），可在门户配置失败转移 URL。
参考规则：不要臆造参数、枚举、响应或 webhook 字段；文档未内联的参数、枚举、响应字段需先阅读 references/api-details.md；使用附加操作前先读可选参数与响应模式；匹配内联示例之外的 webhook 字段前先读 webhook 负载参考。
限制：注册调用本身不足以保证可发送，必须成功完成指派步骤；10DLC 为顺序流程。资料未提供价格、平台覆盖与配额等更多细节。