用途:面向需要开通国际电话号码的场景,说明 Twilio 监管合规(Regulatory Compliance)相关资源的用法与限制。很多国家要求对最终用户做身份验证,若某国要求 bundle,缺失则开通会立即失败;因此应先查询 Regulations 资源确认要求。
主要概念:Regulation 为国家特定要求,定义所需 End-User 类型与文档类型;Bundle 是承载 End-User 与 Supporting Documents 的容器;End-User 为接听电话或接收消息的主体(个人或企业);Supporting Document 为身份/地址验证文件;Evaluation 是提交前对 bundle 与 regulation 的同步校验;Item Assignment 用于把 End-User 或文档链接到 Bundle。
使用方式(简要):1)按 IsoCountry、NumberType、EndUserType 查询 Regulations;2)创建 End-User;3)上传 Supporting Documents;4)创建 Bundle 并通过 ItemAssignments 关联 End-User 与文档;5)调用 Evaluations 做同步校验,若返回 noncompliant 则按字段级结果修复后重评,通过后把 Status 置为 pending-review 提交审核;6)审核通过后创建 incoming_phone_numbers 并传 bundle_sid。
更新已批准的 bundle:法规变更会收到邮件通知。可通过 Bundle Copies 把已批准 bundle 复制为可变状态,更新副本上的 End-User 或文档并重新评估,再用 Replace Items 替换原 bundle 中的条目;整个过程中号码保持已开通。也可选择新建 bundle、审批通过后再重映射号码。
ISV/多账号:每个客户需各自的 bundle,不得复用自家企业信息;用 Bundle Clones 跨子账号复制结构;End-User 必须反映真实最终用户。限制:无所需 bundle 无法开通号码;同一 bundle 不能跨号码类型;约 33 个国家要求地址与号码前缀所在地区匹配(如柏林号码用美国总部地址会失败);不能硬编码法规要求,应动态查询;评估失败应修复原 bundle 而非新建;部分市场仅限企业。
文档未提供的具体细节包括:各国完整要求清单、费用与价格、审核时长,暂未提供。