SuperAPI AI 工具集

telnyx-import-vapi

智能体与模型

查看项目

更新于 10-16 03:38

技能介绍

用途:将 Vapi 语音助手迁移到 Telnyx,通过导入接口从 Vapi 拉取助手配置,在 Telnyx 中重建为 AI Assistant。支持全量导入或按 Vapi 助手 ID 选择性导入。

导入内容:instructions 原样导入;greeting/首条消息映射为助手问候语;语音配置(提供商与 voice ID)保留;动态变量默认值保留;工具(hangup、transfer、webhook)定义与配置导入;MCP Server 集成(服务器 URL 与工具映射)导入;通话分析/洞察映射为 insight_settings;数据保留偏好映射为 privacy_settings。知识库不导入,需导入后手动添加;工具中的密钥部分导入,仅创建占位密钥,需在 Telnyx 门户重新填写实际值。

前提条件:Telnyx API Key(https://portal.telnyx.com/#/app/api-keys)与 Vapi API Key(Vapi 仪表板)。必须先把 Vapi API Key 存为 Telnyx 集成密钥(https://portal.telnyx.com/#/app/integration-secrets),导入接口需要密钥引用名而非原始 key,不能跳过此步。

使用方式:创建集成密钥并记下引用名(如 vapi_api_key);调用 POST https://api.telnyx.com/v2/ai/assistants/import,参数 provider 固定为 "vapi",api_key_ref 为密钥引用名;传 import_ids 数组可只导入指定助手,省略则导入全部。示例: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 写法。导入后可调用 GET /v2/ai/assistants 或 SDK 的 list 方法,通过 import_metadata 验证结果。

导入后清单:重新填写工具引用的密钥;添加知识库内容(文件或 URL);为助手分配 Telnyx 电话号码以接听来电;用 Telnyx 助手测试 API 或测试通话验证行为。

限制与重复导入:知识库不迁移,密钥需手动补全,电话号码需手动分配。对同一批 Vapi 助手再次运行导入,会用 Vapi 最新配置覆盖 Telnyx 中已有副本,适用于渐进迁移期间的同步。完整 API 文档:https://developers.telnyx.com/api-reference/assistants/import-assistants-from-external-provider。