用途：Telnyx 10DLC Python SDK 用于美国 A2P 短信合规场景，完成 10DLC 品牌（brand）注册、活动（campaign）提交，以及将电话号码/消息配置文件分配到活动，是发送合规短信前的基础设施配置流程。
主要能力：创建与查询品牌（client.messaging_10dlc.brand.create/retrieve/list/update/delete）；提交活动（campaign_builder.submit）、查询活动及操作状态、MNO 元数据、共享状态；将消息配置文件分配至活动（phone_number_assignment_by_profile.assign）；创建电话号码与活动关联（phone_number_campaigns.create）；按用例查询资格与费用（qualify_by_usecase）；品牌 SMS OTP、外部审核等辅助操作。
安装与初始化：pip install telnyx；通过 os.environ.get("TELNYX_API_KEY") 初始化 Telnyx 客户端。
使用方式与顺序：10DLC 流程具有顺序性——先创建品牌，再提交活动，最后附加消息配置文件等消息基础设施。仅完成注册调用并不足够，必须成功完成分配步骤后消息基础设施才能使用该活动。应将状态字段作为控制流的一部分，在返回状态确认发送就绪前不要假定活动可用。列表方法返回自动分页迭代器，可用 for item in page_result: 遍历。
错误处理：需捕获 APIConnectionError、RateLimitError（429，可用 Retry-After 头并结合退避）、APIStatusError（如 401 无效密钥、403 权限不足、404 未找到、422 校验错误）。
Webhook 验证：Telnyx 使用 Ed25519 签名，请求含 telnyx-signature-ed25519 与 telnyx-timestamp 头；应在处理程序中使用原始请求体（非解析后的 JSON），调用 client.webhooks.unwrap(payload, headers=headers) 验证。
限制与注意事项：不要臆造 Telnyx 参数、枚举、响应字段或 Webhook 字段；未内联展示的字段需查阅参考文档（如 references/api-details.md）后再编写代码；使用 Additional Operations 前应先阅读可选参数与响应模式章节。以上资料未提供收费、价格等具体信息。