用途:把 Retell AI 的智能体配置迁移到 Telnyx,重建为 Telnyx AI Assistants,用于从 Retell 切换到 Telnyx 或分阶段迁移。
主要能力:支持单提示和多提示 Retell 智能体。可导入项目包括指令、问候/首条消息、语音配置(提供商与语音 ID)、动态变量默认值、工具(挂断、转接、Webhook)、MCP Server 集成、通话分析/洞察(映射到 insight_settings)、数据保留偏好(映射到 privacy_settings)。不导入知识库,需导入后手动添加;工具中引用的密钥仅创建占位符,需在 Telnyx 门户重新填写实际值。
使用方式:先准备 Telnyx API 密钥(https://portal.telnyx.com/#/app/api-keys)和 Retell API 密钥,并把 Retell 密钥存为 Telnyx 集成密钥(https://portal.telnyx.com/#/app/integration-secrets),记下引用名(如 retell_api_key);导入端点要求密钥引用而非原始密钥。调用 POST https://api.telnyx.com/v2/ai/assistants/import,传入 provider="retell" 与 api_key_ref。省略 import_ids 导入全部智能体;传入 import_ids 数组仅导入指定 Retell 智能体 ID。支持 curl 及 Python、JavaScript、Go、Java、Ruby SDK。导入后用 GET https://api.telnyx.com/v2/ai/assistants 列出助手验证。对同一批 Retell 智能体再次运行导入会覆盖 Telnyx 现有副本,可用于同步变更。
导入后需完成:重新填写工具引用的密钥;添加知识库文件或 URL;为助手分配 Telnyx 电话号码;用测试 API 或测试通话验证行为。
API 字段:provider(必填,须为 retell)、api_key_ref(必填,集成密钥名)、import_ids(可选,指定 Retell 智能体 ID,省略则全部)。完整文档见 https://developers.telnyx.com/api-reference/assistants/import-assistants-from-external-provider。
限制:知识库不导入;密钥仅占位;需手动分配号码与测试;其他未在资料中说明的限制暂未提供。