用途:把 Vapi 的语音助手迁移为 Telnyx AI Assistant,通过导入接口拉取助手配置并重建,可一次导入全部或指定助手。
主要能力:导入内容包括指令、问候/首条消息、语音配置(语音提供商与 voice ID)、动态变量默认值、工具(挂断、转接、webhook)、MCP 服务器集成、通话分析(映射为 insight_settings)和数据保留偏好(映射为 privacy_settings)。知识库不导入,需导入后手动添加;工具中引用的密钥仅创建占位符,需到 Telnyx 门户重新填入真实值。
使用方式:先准备 Telnyx API Key(https://portal.telnyx.com/#/app/api-keys)和 Vapi API Key,并把 Vapi Key 作为 Telnyx 集成密钥存储(https://portal.telnyx.com/#/app/integration-secrets),记下引用名如 vapi_api_key;导入接口需要密钥引用而非原始密钥。导入调用:curl -X POST -H "Authorization: Bearer $TELNYX_API_KEY" -H "Content-Type: application/json" -d '{"provider": "vapi", "api_key_ref": "vapi_api_key"}' "https://api.telnyx.com/v2/ai/assistants/import",也可用 Python、JavaScript、Go、Java、Ruby SDK。选择性导入时在请求中加 import_ids 数组指定 Vapi 助手 ID。导入后用 GET https://api.telnyx.com/v2/ai/assistants 列出 Telnyx 助手并查看 import_metadata 验证。
导入后需手动完成:重新填写密钥、添加知识库、为助手分配 Telnyx 电话号码、测试助手。对同一批 Vapi 助手重复导入会用 Vapi 最新配置覆盖 Telnyx 现有副本,可用于迁移期间同步变更。
限制:仅支持 provider 为 vapi;必填 api_key_ref,import_ids 可选(省略则导入全部);接口地址与完整文档见 https://developers.telnyx.com/api-reference/assistants/import-assistants-from-external-provider。费用、价格与配额信息暂未提供。