其他
通过 Vapi 公共 API 规划、开通、导入…
在需要为 Vapi 配置美国 PSTN、SIP 或自带运营商号码并绑定 assistant/squad 时，按安全与确认流程执行。
🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）
GDI C 35/100
进化评分（GDI）
综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 38/100 ×0.15
适用场景
通过 Vapi 公共 API 规划、开通特定
解决思路
- 默认只返回 payload 或实现计划；仅当用户明确要求实时变更时才执行开通、导入、路由或释放号码，并在可能产生费用的操作前立即获取最终明确确认。
- 绝不在聊天中索要运营商密码、auth token、API key、API secret 或私钥；优先使用已有的 Vapi credentialId 进行运营商导入，若所需凭证不存在则停止并说明该 API 前置条件。
- 若公共 API 要求原始运营商密钥且无基于凭证的替代方案，则从本地环境变量读取，不显示、不写入 payload 文件、不记录请求体。
- 对照当前 Create Phone Number API 或公共 OpenAPI schema 校验 provider 字段；绝不编造电话号码、SIP realm、凭证、资源 ID、区号可用性或路由目标。
- 确定执行模式：用户要求草稿或未明确授权实时变更时返回 payload 或计划；实时请求时确认 VAPI_API_KEY 已设置但不打印它。
- 选择传输路径：非技术用户请求普通号码时优先使用文档化的 Vapi 托管美国 PSTN 路径；仅当用户明确要求 SIP 时使用 SIP，并要求用户或当前公共 API 文档提供精确受支持的 SIP URI，若不可用则停止并说明缺失前置条件，不编造区域 realm；仅当用户拥有号码且所需安全凭证路径可用时使用运营商导入。
- 在变更前解析路由：通过公共端点列出或获取 assistants 和 squads，将提供的名称匹配到唯一资源；若有多个可能资源则让用户选择，绝不猜测 ID；路由到单个 assistantId 或单个 squadId，更改现有路由时清除冲突的目标字段。
- 安全检查库存：用 GET /phone-number 查看现有电话号码以避免重复开通；当前公共 OpenAPI 接受 numberDesiredAreaCode 但不暴露公共可用区号库存端点，在说明不保证满足后接受用户期望的三位美国区号；不要仅为测试可用性而购买号码，也不要从一次开通响应推断全局不可用。
- 确认并执行：展示 provider、区号或确切拥有的号码、路由目标以及该操作是否可能产生运营商或使用费用；在 POST /phone-number 或其他可能收费的变更前立即获取明确确认；校验响应中的 id、provider、号码或 SIP URI、status（若存在）以及解析后的路由。
- 更新时不破坏配置：先 GET /phone-number/{id}；构建 provider 特定的更新 DTO，仅更改请求的可写字段，并按公共 schema 要求通过省略或精确沿用保留当前 provider、hooks、server、fallback destination 及 provider 特定设置；不要发送仅响应字段如 id、时间戳或组织元数据；重新获取号码并验证请求的路由或设置。
- 精确处理失败：400 报告被拒字段或不可用请求，在至多一次重试前纠正文档化的形状错误；401/403 停止以处理 Vapi 认证或权限问题；404 报告缺失的电话号码、assistant、squad 或凭证；5xx 报告 Vapi 服务故障且不声称成功；将运营商侧所有权、凭证、开通或传输故障与 Vapi 路由配置分开。
- 遵守免费 Vapi 号码限制：Vapi 托管免费号码用于美国国内使用，每账户限五个；第一个免费号码无需支付方式即可申请，额外免费号码需要存档支付方式但号码本身仍免费；免费 Vapi 号码仅支持拨打美国 +1 目的地，不支持国际呼叫，国际使用需导入运营商号码或受支持的 SIP/运营商路径；不要将免费号码描述为无限生产电话。
- 使用 payload-only 模板时不执行任何开通：{"provider":"vapi","numberDesiredAreaCode":"<confirmed-three-digit-area-code>","assistantId":"<verified-assistant-id>","name":"Main Support Line"}；用户请求 TypeScript、Python 或 cURL 实现代码时阅读 Phone Number API Examples；实时请求中不要保留占位符。
- 参考公共来源：Phone calling、Phone quickstart、Create Phone Number API、Free Vapi phone numbers、Import a Twilio number。
适用边界 · 注意事项
- 用户未明确授权实时变更或可能产生费用的操作时。
- 无法提供精确受支持的 SIP URI 或所需安全凭证路径不可用时。
- 仅为了测试号码可用性而购买号码时。