---
title: "Импорт агентов с другой платформы"
description: "Перенесите агентов, инструменты и базы знаний из Vapi, Retell, ElevenLabs Agents или Bland с помощью ключа API или экспорта JSON, проверьте сопоставление и выполните импорт."
ui: zeus
---

Если ваши агенты работают на Vapi, Retell, ElevenLabs Agents или Bland, импортёр получает их, сопоставляет каждое поле с ThunderPhone и показывает результат до создания каких-либо объектов.

<Note>
  Ваш ключ API используется только для импорта. Он шифруется во время получения списка и удаляется сразу после завершения получения, а также при любой ошибке или отмене. Для запуска или подтверждения импорта требуется роль администратора.
</Note>

## Запуск импорта

1. Откройте **Агенты** и выберите **Импортировать агентов** или попросите Zeus перенести ваших агентов.
2. Выберите платформу.
3. Выполните шаги, чтобы создать ключ на этой платформе (они откроют нужную страницу настроек), и вставьте его либо выберите **Вставить экспортированный JSON** и вставьте один или несколько объектов агентов из панели управления или API этой платформы.
4. Выберите **Получить моих агентов** (кнопка будет названа в соответствии с вашей платформой). Получение и сопоставление обычно занимают меньше минуты; вы можете покинуть страницу и вернуться позже. Текущий импорт и предыдущие импорты перечислены на странице **Импортировать агентов**.

В старом представлении **Импорт** находится в разделе **Голосовые агенты** и открывает те же шаги в диалоговом окне.

## Проверка плана

Каждый агент показывает имя, подобранный голос (с указанием уверенности в совпадении), добавленные инструменты и базы знаний, а также примечания о том, что изменилось при переводе. Разверните строку, чтобы прочитать промпт:

- **Очищено** (**Переработано** в старом представлении) — единый связный промпт в стиле
  [руководства по промптам](/ru/guides/prompting), в котором сохранены все номера телефонов, URL-адреса, названия инструментов
  и заполнители из исходного текста.
- **Как в Vapi** или название вашей платформы (**Структурировано** в старом представлении) — исходная конфигурация, расположенная под заголовками, в точности
  в том виде, в котором она была извлечена. Используется автоматически, если переработку нельзя проверить или если
  переработанный текст получился значительно короче исходного.

Агент, импортированный из потока, показывает **Общие инструкции** вместо
промпта, а также количество этапов, которые он сохраняет из потока. В обзоре старого представления
указаны название каждого этапа, инструкции для агента и следующий этап, а **Показать как один промпт** отображает того же агента как единый промпт,
который он запускает везде, где этапы недоступны.
Агенты с передачами перечисляют агентов, которым они передают звонящего; если снять выбор
с одного из них, в обзоре будет указано, что эта передача не будет настроена.

Все агенты изначально выбраны, кроме пустых и стандартных стартовых агентов,
созданных для вас платформой. Снимите выбор с ненужных агентов, измените имена,
голоса, настройки или выбор промпта, затем нажмите **Импортировать**. Агенты
сохраняются с подключениями к API и прикреплёнными базами знаний; откройте агента, чтобы проверить его
и протестировать звонок, прежде чем назначать его на номер.

## Потоки, Squads и передачи между агентами

Многоэтапные агенты сохраняют свою структуру. См. [Этапы агента](/ru/guides/agent-steps),
чтобы узнать, как этапы и передачи работают во время звонка.

- **Потоки становятся этапами.** Многошаговые состояния и потоки диалога Retell,
  маршруты Bland и рабочие процессы ElevenLabs импортируются как этапы агента.
  Глобальный промпт исходной платформы становится общими инструкциями.
  - Переносятся инструкции каждого узла, фиксированная реплика, собираемые
    значения и инструменты.
  - Условия на переходах, описанные словами, становятся переходами, решение о
    которых принимает агент. Одно сравнение собранного значения или ответа
    вебхука (`age >= 18`) становится переходом, который проверяется точно.
  - Узлы вебхуков и функций запускают свой инструмент при начале этапа.
    Глобальные узлы доступны с любого этапа; узел без собственных путей дальше
    возвращает звонок на этап, который он прервал.
  - Узлы передачи и завершения становятся последними этапами, которые
    передают или завершают звонок. Узел передачи Retell сохраняет свой выход
    на случай, если передача не состоится.
  - Узел ветвления, который только выбирает следующий этап, по возможности
    объединяется с предыдущим этапом. В противном случае он остаётся отдельным
    этапом с примечанием.
  - Поток, который слишком велик для этапов или который ThunderPhone не может
    представить в виде этапов, импортируется как один промпт со списком всех
    этапов и примечанием.
- **Squads, передачи между агентами и смены агентов становятся передачами.**
  Каждый участник Vapi Squad импортируется как отдельный агент с именем по
  участнику и Squad. Первый участник отвечает на звонки Squad, а остальные
  доступны через передачу. Передачи ElevenLabs другому агенту и смены агентов
  Retell также становятся передачами. Звонящий остаётся на линии, а диалог до
  этого момента сохраняется.
  - Звонок, поступивший через передачу, сохраняет настройки звонка агента,
    который на него ответил: голосовую почту, лимиты звонков, языки и запись.
    Агент, которому передаётся звонок, использует собственные промпт, этапы,
    инструменты и голос.
  - Передача может указывать только на агента, импортированного в том же
    запуске. Если другого агента нет в импорте или вы снимете с него флажок,
    это будет указано в примечании, и вы сможете добавить передачу позже в
    настройках агента.

## Что импортируется

<Tabs>
  <Tab title="Vapi">
    **Получение ключа**

    1. Откройте [dashboard.vapi.ai/org/api-keys](https://dashboard.vapi.ai/org/api-keys)
       (Настройки организации → Ключи API).
    2. Создайте ключ и выберите **Приватный** — публичные ключи не могут получать список
       ассистентов.
    3. Скопируйте его в диалоговое окно. Ключи Vapi не имеют ограничений области действия; удалите ключ в
       Vapi после импорта, если создали его только для этого.

    | Поле Vapi | ThunderPhone |
    |---|---|
    | `model.messages[system]` | Промпт |
    | `firstMessage`, `firstMessageMode` | Приветственная фраза в промпте; кто говорит первым |
    | `voice.provider` + `voiceId` | Ближайший голос из каталога с максимально точным поиском в библиотеке Vapi (отображается степень совпадения) |
    | `transcriber.language`, `languages`, ключевые слова/термины | Языки и словарь распознавания речи |
    | `model.model` | Не сопоставляется: импортированные агенты запускаются с интеллектом Pro и распознаванием Standard |
    | `model.tools`, `toolIds`, `toolRefs` (function, apiRequest) | API-подключения; сохраняются оболочки запросов Vapi и резервные серверные варианты на уровне ассистента |
    | Назначения `transferCall` | Переводы звонков в промпте; SIP, ассистенты и динамические назначения отмечаются для проверки |
    | Инструменты `handoff` | Передачи указанным ассистентам, импортированным в том же запуске |
    | `endCall`, `dtmf` | Встроенные инструменты |
    | Google Calendar, Google Sheets, `sms` | Отмечаются с указанием необходимой интеграции ThunderPhone или настройки SMS |
    | Slack | Отмечается как не импортируемый: ThunderPhone пока не может подключаться к Slack |
    | Инструменты `query` и `knowledgeBase`, а также устаревший `knowledgeBaseId` | База знаний с доступными загруженными файлами в качестве документов |
    | `endCallMessage`, `endCallPhrases`, `voicemailMessage`, планы сообщений при бездействии и хуки тайм-аутов | Разделы промпта; настройки голосовой почты и тишины |
    | `maxDurationSeconds`, отказы от записи | Максимальная длительность звонка (сохраняется значение Vapi по умолчанию — 600 секунд); отказ от записи отмечается на странице проверки |
    | Squads | По одному агенту на участника, с собственными промптом, переопределениями, голосом, инструментами и знаниями. `assistantDestinations` становятся передачами между ними; первый участник сохраняет номера Squad |
    | Пользовательские серверы знаний/моделей, планы соответствия требованиям, другие хуки, рабочие процессы и неподдерживаемые размещённые инструменты | Отмечаются с конкретным действием по проверке или пересборке; исходные планы и учётные данные не сохраняются |
  </Tab>
  <Tab title="Retell">
    **Получение ключа**

    1. Откройте [dashboard.retellai.com/apiKeys](https://dashboard.retellai.com/apiKeys)
       (Системные настройки → Ключи API) и выберите **Создать ключ**.
    2. Включите **Ограничить разрешения** и установите для **Агент**, **База знаний**
       и **Телефон** значение **Чтение**. Не выбирайте другие группы;
       импортёр никогда не записывает данные в Retell.
    3. Скопируйте ключ в диалоговое окно.

    | Поле Retell | ThunderPhone |
    |---|---|
    | Последний опубликованный агент и его точная версия Retell LLM / потока | Опубликованные промпт и поведение; более новые черновики отмечаются для проверки |
    | Retell LLM `general_prompt`, `begin_message`, `start_speaker`, состояния | Общие инструкции; поведение в начале разговора; один этап для каждого состояния с его инструментами, переходами и значениями, собранными каждым переходом |
    | Поток разговора `global_prompt`, узлы, компоненты, глобальные узлы и связи | Общие инструкции и этапы; условия равенства для собранных значений проверяются в точности; точный начальный текст и этапы перевода звонка |
    | Инструменты и узлы `agent_swap` | Передачи агентам Retell, импортированным в том же запуске |
    | Пользовательские инструменты | API-подключения с параметрами запроса, тайм-аутом и формой запроса только Retell/args; отмечаются изменение подписи и любые нестандартные настройки речи, повторных попыток, переменных ответа или кодирования формы |
    | `transfer_call`, `end_call`, `press_digit` | Условные переводы звонка, включая добавочные номера, и встроенные функции; отмечаются различия в предполагаемых и тёплых переводах |
    | `check_availability_cal`, `book_appointment_cal` | Отмечаются как инструменты Cal.com, которые нужно повторно подключить в разделе «Интеграции»; учётные данные Retell никогда не переносятся |
    | `send_sms`, MCP | Отмечаются с инструкциями по настройке SMS или MCP |
    | `voice_id` (`11labs-`, `openai-`, `cartesia-`, …) | Ближайший голос из каталога |
    | `language` (одна локаль, многоязычный режим или список локалей) | Основной и дополнительные языки |
    | `model` / `s2s_model` | Не сопоставляется: импортированные агенты начинают с интеллекта Pro и распознавания Standard |
    | `knowledge_base_ids` (url, источники документов и текста) | База знаний с документами |
    | `default_dynamic_variables`, поддерживаемые системные переменные | Значения по умолчанию для переменных ThunderPhone и простые инструкции по контексту звонка |
    | `voicemail_option`, `end_call_after_silence_ms`, `max_call_duration_ms`, `ring_duration_ms`, отключённая запись, `boosted_keywords` | Поведение голосовой почты; ограничения звонка; настройка записи; термины промпта |
    | `webhook_url`, пользовательские движки LLM, неподдерживаемые узлы потока и настройки, доступные только у поставщика | Отмечаются для ручной проверки, а не молча отбрасываются |
  </Tab>
  <Tab title="Агенты ElevenLabs">
    **Получение ключа**

    1. Откройте [elevenlabs.io/app/settings/api-keys](https://elevenlabs.io/app/settings/api-keys)
       и выберите **Создать ключ API**.
    2. В разделе разрешений предоставьте ему **Платформа агентов: Чтение**
       (и **База знаний: Чтение**, если отображается); импортёру больше ничего
       не требуется.
    3. Скопируйте ключ в диалоговое окно.

    | Поле ElevenLabs | ThunderPhone |
    |---|---|
    | `conversation_config.agent.prompt.prompt`, узлы Agent Workflow и упорядоченные условия ветвления | Общие инструкции и один этап для каждого узла рабочего процесса; узлы инструментов запускают свой инструмент в начале этапа; ветви с выражениями помечаются для проверки |
    | `first_message`, `language`, `language_presets` | Начальная реплика; основной и дополнительные языки; переведённые приветствия |
    | `prompt.llm` | Не сопоставляется: импортированные агенты начинают с интеллекта Pro и распознавания Standard |
    | `tts.voice_id` | Ближайший голос из каталога |
    | webhook `tool_ids`, включая инструменты, прикреплённые к этапам рабочего процесса | API-подключения с переносимыми параметрами тела и запроса; фиксированные параметры поставщика и учётные данные удаляются и отмечаются |
    | `built_in_tools` для завершения звонка, перевода звонка, клавиатуры и голосовой почты | Встроенные функции, правила перевода и поведение голосовой почты; SIP и динамические назначения отмечаются для повторной настройки |
    | Переводы другому агенту (`transfer_to_agent`, узлы рабочего процесса агента) | Передачи агентам ElevenLabs, импортированным в том же запуске |
    | Записи `knowledge_base` с url/текстом/файлом/папкой, включая базу знаний на этапах рабочего процесса | Документы базы знаний; папки разворачиваются, а содержимое текста и файлов получается по идентификатору |
    | `turn.silence_end_call_timeout`, `conversation.max_duration_seconds`, `asr.keywords`, `privacy.record_voice` | Ограничения тишины и максимальной длительности; термины произношения; отключение записи отмечается на странице проверки |
    | пользовательские LLM, серверы MCP, процедуры, вебхуки рабочего пространства, переопределения модели/голоса/языка для каждого этапа, инструменты бронирования ElevenLabs | Отмечаются с действием, необходимым после импорта |
  </Tab>
  <Tab title="Bland">
    **Получение ключа**

    1. Откройте [app.bland.ai/dashboard/settings](https://app.bland.ai/dashboard/settings).
    2. Скопируйте указанный там **ключ API** (в Bland один ключ на аккаунт; он
       не имеет ограничений области действия, поэтому при необходимости замените его после импорта).
    3. Вставьте его в диалоговое окно.

    Отображаемые метки Bland не считаются идентификатором агента. Импортёр определяет, кем представляется агент, по приветствию и промпту; для сценария он использует глобальный промпт и начальный узел. Если эта проверка недоступна или не находит имени, импортированный промпт остаётся нейтральным.

    | Поле Bland | ThunderPhone |
    |---|---|
    | Веб-агент: `prompt`, `first_sentence`, `language`, `model`, `voice`, `pathway_id` | Промпт; начальная реплика; язык; уровень; наиболее близкий голос; прикреплённый опубликованный сценарий pathway |
    | Продакшен-версия персоны | Промпты личности и оркестрации; голос; язык; настройка, при которой первым говорит звонящий; запись; максимальная длительность; инструменты и база знаний по умолчанию. Включается один прикреплённый сценарий pathway; маршрутизация по нескольким pathway отмечается для ручной настройки |
    | Пользовательские инструменты и инструменты pathway (url, метод, схема, заголовки, переменные тела запроса) | API-подключения. Ссылки на Bland Secret отмечаются, их нужно добавить повторно |
    | Инструменты Cal.com, HubSpot, Salesforce, Google Calendar и Google Sheets | Указывается соответствующая интеграция ThunderPhone, которую нужно подключить и включить |
    | Инструменты Slack | Отмечаются как не импортированные: ThunderPhone пока не может подключаться к Slack |
    | Сведения о входящем номере (`prompt`, `pathway_id` / версия, инструменты, переводы, ключевые слова, данные запроса) | Один агент для каждого входящего номера, со значениями переменных звонка по умолчанию и правилами перевода |
    | Каждый pathway, прикреплённый к номеру или нет | Опубликованная версия, если доступна; неопубликованный черновик явно помечается |
    | Глобальный промпт; узлы Default, Knowledge Base, Transfer Call, End Call, Webhook и Wait for Response; связи, условия циклов, глобальные узлы, извлечённые переменные, статическая речь | Общие инструкции и один этап на каждый узел, включая этапы, доступные в любое время, собираемые значения, точные реплики, этапы webhook, переводы и завершения звонка. Сценарии ответов webhook на поле ответа или извлечённую переменную проверяются точно |
    | Встроенный текст базы знаний и разрешимые идентификаторы базы знаний | Документы базы знаний. Элементы, текст или файл которых невозможно прочитать, отмечаются для ручной загрузки |
    | `max_duration`, `wait_for_greeting`, настройка записи | Лимит звонка, порядок речи, настройка записи |
    | `webhook`, поиск динамических данных, маршрутизация персон по нескольким путям, неподдерживаемые настройки узлов, агенты v2 | Отмечаются с указанием необходимых дальнейших действий вручную |
    | Входящие номера | Перечисляются с обоими вариантами, поскольку Bland не указывает, принадлежат ли они ему или вашей учётной записи Twilio |
  </Tab>
</Tabs>

## Что требует действий в ThunderPhone

Отчёт в нижней части страницы проверки содержит номера, вебхуки и
инструменты, которые не были перенесены; в заметках каждого агента указано остальное. Вместе они
показывают всё, что не было перенесено, и объясняют почему:

- **Номера телефонов.** После импорта для каждого исходного номера указано, где
  он находится и что с ним можно сделать:
  - **В вашей собственной учётной записи Twilio или Telnyx** (например, номер Twilio,
    который вы подключили к Vapi или ElevenLabs): администратор может перенести его
    к импортированному агенту. Если эта учётная запись ещё не используется в
    [VoIP-подключении](/ru/guides/bring-your-own-numbers), сначала подключите её. Перед
    любыми изменениями на этапе подтверждения будет указано, что звонки на этот номер
    перестанут поступать на старую платформу. Затем ThunderPhone направит номер на себя
    в вашей учётной записи оператора связи (номер Twilio будет подключён к SIP-транку
    ThunderPhone; номер Telnyx будет перенесён в SIP-подключение ThunderPhone) и
    совершит короткий тестовый звонок, чтобы активировать его. Чтобы отменить это,
    удалите номер в разделе **Телефон и интернет**, сохранив его в учётной записи
    оператора связи, затем повторно импортируйте его на старой платформе.
  - **В вашем SIP-транке**: подключите транк как
    [SIP-подключение](/ru/guides/voip-providers) и
    импортируйте номер в разделе **Телефон и интернет**.
  - **Проданные платформой** (номера Vapi, Retell и Bland, приобретённые там):
    ThunderPhone не может перенести такой номер. Перенесите его к оператору связи и
    импортируйте либо получите номер ThunderPhone и привяжите его к импортированному
    агенту.
  - Bland не указывает, принадлежит ли номер ему или получен из вашей учётной записи
    Twilio, поэтому для номеров Bland отображаются оба варианта.
- **Вебхуки для каждого агента.** ThunderPhone отправляет подписанные вебхуки для
  каждой организации; настройте вебхук в разделе [Вебхуки](/ru/webhooks/overview).
- **Учётные данные, сохранённые поставщиком.** Заголовки инструментов, которые были
  видимы, копируются. Учётные данные, которые старая платформа хранила по идентификатору,
  помечаются; добавьте их в заголовки API-подключения.
- **Встроенные интеграции.** Инструменты календаря, CRM и обмена сообщениями, которые
  размещала старая платформа (например, бронирование через Cal.com), указываются вместе
  с интеграцией ThunderPhone, которую нужно подключить вместо них; их учётные данные не
  переносятся. В проверке также отмечается промпт, который всё ещё предлагает агенту
  использовать неимпортированный инструмент.
- **Текстовые сообщения.** Агенты ThunderPhone отправляют сообщения через ваш номер
  Twilio или Telnyx; настройте SMS в параметрах агента.
- **Инструменты без эквивалента** (автоматизации, специфичные для платформы) перечислены,
  чтобы ничего не было пропущено без уведомления.
- **Переменные звонка.** Заполнители `{{name}}` сохраняются со значениями по умолчанию,
  которые использовала ваша платформа. ThunderPhone заполняет их из
  [переменных, передаваемых при начале звонка](/ru/guides/call-variables), а в остальных
  случаях оставляет пустыми; в проверке перечислены переменные, которые необходимо передать.
- **Ограничения звонков и запись.** Импортируется максимальная длительность звонка. Если
  исходный агент никогда её не изменял, устанавливается собственное значение по умолчанию
  платформы: 10 минут для Vapi и ElevenLabs, 1 час для Retell, 30 минут для Bland.
  Исходное значение, не являющееся положительным числом, импортируется без максимума, и
  это указывается в проверке. Ограничения по тишине и максимальной длительности, выходящие
  за пределы диапазонов ThunderPhone, корректируются, а в примечании проверки указываются
  исходное и импортированное значения. Если в исходном агенте запись звонков была отключена,
  в примечании проверки агента указано, импортируется ли он с отключённой записью или,
  если отключение записи пока недоступно, с включённой записью.

## Что меняется при импорте

Несколько настроек, которые на старой платформе остались со значениями по умолчанию, вместо этого получают значения ThunderPhone по умолчанию. Проверка перечисляет их в одном примечании для каждого агента, в его сведениях, только там, где две платформы различаются. Приведённые ниже значения ThunderPhone — это значения по умолчанию, которые можно изменить для каждого агента:

| Настройка | По умолчанию на старой платформе | По умолчанию в ThunderPhone |
|---|---|---|
| Время звонка при исходящих вызовах | Retell: 30 секунд | 60 секунд |
| Завершение беззвучного вызова | Retell: завершение вызова через 10 минут; ElevenLabs: никогда | Проверка каждые 15 секунд (примерно через 6 секунд, если никто ещё не говорил, и не ранее чем через минуту, если звонящий попросил агента подождать), завершение вызова после 1 минуты тишины |
| Запись звонков | Входящие номера и персоны Bland: выключено | Включено. Обратитесь в поддержку или измените настройку в параметрах агента, если она доступна |
| При голосовой почте | Персоны Bland: завершение вызова | Агент принимает решение на основе своего промпта |

Настройка, которую вы изменили на прежней платформе, импортируется с заданным
вами значением и здесь не отображается. Единственное исключение — настройка
беззвучного звонка «никогда не завершать»: она отображается как значение по
умолчанию, а агент сохраняет периодические проверки ThunderPhone. Измените
любую из этих настроек в настройках агента после импорта.

## Импорт без ключа

Выберите **Вставить экспортированный JSON** и вставьте объекты, экспортированные API
или панелью управления вашей платформы, как один объект или список JSON:

- **Vapi** — объект ассистента (`GET /assistant/{id}`), объект Squad
  (`GET /squad/{id}`) или список таких объектов. Для разрешения инструментов,
  привязанных только по идентификатору, и файлов базы знаний требуется ключ. Vapi
  больше не поддерживает Workflows, поэтому перед вставкой преобразуйте Workflow в Squad.
- **Retell** — объект агента (`GET /get-agent/{id}?version=...`) **вместе
  с** Retell LLM той же версии (`GET /get-retell-llm/{id}?version=...`)
  или объектом потока разговора в том же списке. Импортёр связывает объекты по идентификатору
  и версии, при наличии статуса публикации предпочитает вставленного опубликованного агента
  и импортирует отдельную LLM или поток под сгенерированным именем.
- **ElevenLabs** — объект агента (`GET /v1/convai/agents/{id}`). Текущие
  экспорты обычно ссылаются на инструменты вебхуков и документы базы знаний только по идентификатору.
  При вставке такие элементы помечаются как неразрешённые; для полного импорта используйте ключ API.
- **Bland** — веб-агент, ответ `/v1/agents` или объект pathway.
  Каждый вставленный объект импортируется как отдельный агент, даже если два объекта имеют один идентификатор;
  идентификаторы инструментов и базы знаний, для которых нужен доступ к API, перечисляются для ручной настройки
  вместо исключения.

Всё, на что есть ссылка только по идентификатору и чего нет во вставленных данных, перечисляется в
примечаниях.

## После импорта

1. Откройте каждого агента и прочитайте его заметки.
2. Нажмите **Тестовый звонок** на странице агента или попросите Zeus протестировать его.
3. Перенесите свои номера или подключите новый (см. **Номера телефонов** выше).
4. Проверьте каждое API-подключение с помощью тестировщика запросов.
5. Убедитесь, что документы базы знаний завершили индексацию.
6. Настройте вебхук организации, если старые агенты использовали его.

Импортёр также доступен через [REST API](/api-reference/agent-imports).

Импорт не привязывает вас к платформе. Любого агента можно бесплатно экспортировать в виде открытых файлов в любое время: см. [Уход с ThunderPhone](/ru/guides/leaving-thunderphone).
