telnyx-import-retell

用途：把 Retell AI 的智能体配置迁移为 Telnyx AI Assistants，支持单提示与多提示两种配置，可一次导入全部或指定智能体，也支持重复导入以同步最新配置。\n\n主要能力（导入内容）：指令（原样导入）、问候语、语音配置（提供商与语音 ID）、动态变量默认值、工具（挂断、转接、Webhook）、MCP 服务器集成及其工具映射、通话分析/洞察（映射到 insight_settings）、数据保留偏好（映射到 privacy_settings）。不导入：知识库需导入后手动添加；工具中引用的 API 密钥仅创建占位密钥，需在 Telnyx 门户重新填写。\n\n使用方式：先准备 Telnyx API 密钥（https://portal.telnyx.com/#/app/api-keys）与 Retell API 密钥；将 Retell 密钥存为 Telnyx 集成密钥（https://portal.telnyx.com/#/app/integration-secrets），记录引用名（如 retell_api_key）。导入不能跳过密钥创建步骤，端点需要密钥引用而非原始密钥。\n\n导入全部智能体（curl）：\ncurl -X POST -H "Authorization: Bearer $TELNYX_API_KEY" -H "Content-Type: application/json" -d '{\n "provider": "retell",\n "api_key_ref": "retell_api_key"\n}' "https://api.telnyx.com/v2/ai/assistants/import"\n\n仅导入指定智能体时，在请求体中加 import_ids 数组，例如 "import_ids": ["retell-agent-id-1", "retell-agent-id-2"]。官方文档同时提供 Python、JavaScript、Go、Java、Ruby 的 SDK 示例。\n\n验证导入：调用 GET https://api.telnyx.com/v2/ai/assistants 列出助手，在返回中查看名称、ID 与 import_metadata。\n\n导入后需手动完成：重新填写占位密钥；添加知识库（上传文件或 URL）；为助手分配 Telnyx 电话号码；使用测试 API 或测试通话验证行为。\n\nAPI 参考：provider 必填，固定为 "retell"；api_key_ref 必填，为存放 Retell 密钥的 Telnyx 集成密钥名；import_ids 选填，为空则导入全部。端点：POST https://api.telnyx.com/v2/ai/assistants/import。完整文档见 https://developers.telnyx.com/api-reference/assistants/import-assistants-from-external-provider。\n\n限制：知识库不迁移；工具内密钥仅部分迁移且为占位；其余细节（如计费、速率限制、支持的地域）暂未提供。