用途：twilio-client 是基于 Twilio 上游 OpenAPI（Messaging V1 与 API v2010）合并生成的 Motoko 绑定，用于在 canister 中完成 Twilio 消息相关操作。
主要能力分两类：配置面（MessagingV1Api，messaging.twilio.com）涵盖 Messaging Service、A2P 10DLC 品牌与活动、号码分配、免费号验证、发送池、链接缩短、域名证书；投递面（Api20100401Api，api.twilio.com）涵盖 createMessage/fetchMessage/listMessage、MMS 媒体、号码查询与购买。两个主机在代码生成时按操作路由，调用方只需一个 Config 与一组凭证。
用法：通过 Config.auth 设置 HTTP Basic 凭证（开发用 Account SID + Auth Token，生产建议 API-Key SID + Secret），如 defaultConfig with auth = ?#basicAuth { user = accountSid; password = authToken }。Config.baseUrl 未使用，不要设置。发送短信调用 MessageApi.createMessage，传入 from 或 messagingServiceSid 之一；MMS 需设 mediaUrl 与 sendAsMms = true。美国 A2P 10DLC 需按顺序创建品牌注册、A2P 活动、号码到服务分配；2026-06-30 起活动注册缺少可用的 privacyPolicyUrl 与 termsAndConditionsUrl 会返回 400。
限制与错误：方法在 2xx 返回解码记录，4xx/5xx 抛出 Error.reject，可捕获检查 code、message 等。写操作非幂等，保持 is_replicated 默认值；读操作可设 ?false。分页 pageSize 上限 1000、默认 50。usecase 为文本而非变体，合法值为 notifications、marketing、verification、discussion、poll、undeclared。HTTP 方法变体小写；xTwilioApiVersion 除支持要求外传空字符串。每发送者吞吐：长码 1 MPS、短码 100 MPS、国际长码 10 MPS，不可提升，需通过发送池加号扩展。stickySender / areaCodeGeomatch 仅限美国和加拿大。