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

Ако агентите ви са във Vapi, Retell, ElevenLabs Agents или Bland, инструментът за импортиране ги извлича, съпоставя всяко поле с ThunderPhone и ви показва резултата, преди да бъде създадено каквото и да е.

<Note>
  Вашият API ключ се използва само за импортирането. Той се криптира, докато
  се извлича списъкът с агенти, и се изтрива веднага след завършване на
  извличането — както и при неуспех или отказ. За започване или потвърждаване
  на импортиране е необходима роля на администратор.
</Note>

## Започване на импортиране

1. Отворете **Агенти** и изберете **Импортиране** (или **Импортиране от Vapi, Retell,
   ElevenLabs или Bland** на празна страница с агенти).
2. Изберете платформата.
3. Следвайте номерираните стъпки в диалоговия прозорец, за да създадете ключ в тази платформа
   (те отварят правилната страница с настройки вместо вас), поставете го или превключете на
   **Поставяне на експортиран JSON** и поставете един или повече обекта на агенти от таблото
   или API на тази платформа.
4. Изберете **Извличане на моите агенти**. Извличането и съпоставянето обикновено отнемат
   под минута; можете да напуснете страницата и да се върнете чрез панела със задачи.

## Преглед на плана

Всеки агент показва името, съответстващия глас (и степента на увереност в съвпадението),
инструментите и базите знания, които включва, както и бележки за
всичко, което е променено при превода. Разгънете ред, за да прочетете подканата:

- **Пренаписан** — една цялостна подкана в стила на
  [ръководството за създаване на подкани](/bg/guides/prompting), като всеки телефонен номер, URL адрес, име на инструмент
  и заместител от източника са запазени.
- **Структуриран** — изходната конфигурация, подредена под заглавия, точно както е
  извлечена. Използва се автоматично, когато пренаписването не може да бъде проверено или когато
  пренаписването е станало значително по-кратко от източника.

Агент, импортиран от поток, показва **Споделени инструкции** вместо
подканата, следвани от стъпките му: името на всяка стъпка, какво указва на агента да
направи и накъде преминава след това. **Покажи като една подкана** показва същия агент като
една подкана, която се изпълнява навсякъде, където стъпките не са налични.
Агентите с прехвърляния изброяват агентите, към които прехвърлят обаждащия се; ако премахнете отметката
от някой от тях, прегледът посочва, че това прехвърляне няма да бъде настроено.

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

## Потоци, групи и прехвърляния между агенти

Многостъпковите агенти запазват структурата си. Вижте [Стъпки на агента](/bg/guides/agent-steps)
за това как стъпките и прехвърлянията протичат по време на разговор.

- **Потоците стават стъпки.** Многоетапните състояния с подкани и потоците на разговори в Retell,
  пътищата в Bland и работните процеси в ElevenLabs се импортират като стъпки на агента. Глобалната
  подкана от източника става споделените инструкции.
  - Инструкциите на всеки възел, фиксираната реплика, стойностите за събиране и инструментите се
    пренасят.
  - Условията на преходите, написани с думи, стават преходи, за които агентът взема решение.
    Едно сравнение на събрана стойност или отговор от уебкука
    (`age >= 18`) става преход, който се проверява точно.
  - Възлите за уебкуки и функции изпълняват инструмента си при започване на стъпката. До глобалните
    възли може да се стигне от всяка стъпка; възел без собствени следващи преходи връща разговора към
    стъпката, която е прекъснал.
  - Възлите за прехвърляне и прекратяване стават последни стъпки, които прехвърлят или прекратяват
    разговора. Възелът за прехвърляне в Retell запазва изхода си за случаите, когато прехвърлянето не
    се осъществи.
  - Възел за разклоняване, който само избира следващата стъпка, се обединява с предходната стъпка,
    когато е възможно. В противен случай остава като отделна стъпка с бележка.
  - Поток, който е твърде голям за стъпки или който ThunderPhone не може да представи като стъпки,
    се импортира като една подкана, изброяваща всяка стъпка, с бележка.
- **Групите, прехвърлянията между агенти и смяната на агенти стават прехвърляния.** Всеки член
  на 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`, keywords/keyterms | Езици и речник за разпознаване на реч |
    | `model.model` | Не е съпоставено: импортираните агенти започват с Pro интелигентност и Standard разпознаване |
    | `model.tools`, `toolIds`, `toolRefs` (function, apiRequest) | API връзки; обвивките на заявките на Vapi и резервните сървърни варианти на ниво асистент се запазват |
    | `transferCall` destinations | Прехвърляния на обаждания в подканата; SIP, асистентските и динамичните дестинации се отбелязват за преглед |
    | `handoff` tools | Прехвърляния към посочените асистенти, импортирани при същото изпълнение |
    | `endCall`, `dtmf` | Вградени инструменти |
    | Google Calendar, Google Sheets, `sms` | Отбелязва се необходимата интеграция с ThunderPhone или настройка на SMS |
    | Slack | Отбелязва се като неимпортирано: ThunderPhone все още не може да се свързва със Slack |
    | Инструменти `query` и `knowledgeBase`, както и наследеното `knowledgeBaseId` | База знания с достъпните качени файлове като документи |
    | `endCallMessage`, `endCallPhrases`, `voicemailMessage`, планове за съобщения при неактивност и куки за изчакване | Раздели на подканата; настройки за гласова поща и тишина |
    | `maxDurationSeconds`, откази от записване | Максимална продължителност на обаждането (стандартната стойност на Vapi от 600 секунди се запазва); отказът от записване се отбелязва на страницата за преглед |
    | Екипи | По един агент за всеки член със собствена подкана, замени, глас, инструменти и знания. `assistantDestinations` стават прехвърляния между тях; първият член запазва номерата на екипа |
    | Персонализирани сървъри за знания/модели, планове за съответствие, други куки, работни потоци и неподдържани хоствани инструменти | Отбелязват се с конкретно действие за преглед или повторно изграждане; първичните планове и данните за достъп не се съхраняват |
  </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 сървъри, процедури, webhook-и на работното пространство, замествания на модел/глас/език за всяка стъпка, инструменти на 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, method, schema, headers, body variables) | 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 не посочва дали те са притежание на Bland или на Вашия акаунт в Twilio |
  </Tab>
</Tabs>

## Какво изисква действие в ThunderPhone

Отчетът в долната част на страницата за преглед изброява номера, уебхукове и
инструменти, които не са прехвърлени; бележките за всеки агент обхващат
останалото. Заедно те показват всичко, което не е прехвърлено, и причината:

- **Телефонни номера.** След импортирането всеки изходен номер показва къде се
  намира и какво можете да правите с него:
  - **Във Ваш собствен акаунт в Twilio или Telnyx** (например номер от Twilio,
    който сте свързали с Vapi или ElevenLabs): администратор може да го
    премести към импортиран агент. Ако този акаунт все още не е свързан чрез
    [VoIP връзка](/bg/guides/bring-your-own-numbers), първо го свържете. Преди да
    се промени нещо, стъпка за потвърждение указва, че обажданията към номера
    ще спрат да се насочват към старата платформа. След това ThunderPhone
    насочва номера към себе си във Вашия акаунт при телекомуникационния
    доставчик (номер от Twilio се присъединява към SIP магистралата на
    ThunderPhone; номер от Telnyx се премества към SIP връзката на
    ThunderPhone) и извършва кратко тестово обаждане, за да го активира. За да
    отмените това, изтрийте номера в **Телефонни номера**, като го запазите във
    Вашия акаунт при телекомуникационния доставчик, след което го импортирайте
    отново в старата платформа.
  - **Във Вашата SIP магистрала**: свържете магистралата като
    [SIP връзка](/bg/guides/voip-providers) и
    импортирайте номера в **Телефонни номера**.
  - **Продаден от платформата** (номера от Vapi, Retell и Bland, закупени
    там): ThunderPhone не може да го премести. Прехвърлете го към
    телекомуникационен доставчик и го импортирайте или вземете номер от
    ThunderPhone и го свържете с импортирания агент.
  - Bland не указва дали номерът е негов собствен или е от Вашия акаунт в
    Twilio, затова за номерата на Bland се показват и двете опции.
- **Уебхукове за всеки агент.** ThunderPhone изпраща подписани уебхукове за
  всяка организация; конфигурирайте такъв в [Уебхукове](/bg/webhooks/overview).
- **Идентификационни данни, съхранявани от доставчика.** Видимите заглавки на
  инструментите се копират. Идентификационните данни, които старата платформа
  е съхранявала по идентификатор, се отбелязват; добавете ги към заглавките на
  API връзката.
- **Вградени интеграции.** Инструментите за календар, CRM и съобщения, които
  старата платформа е хоствала (например резервации чрез Cal.com), се посочват
  заедно с интеграцията на ThunderPhone, която трябва да свържете вместо тях;
  техните идентификационни данни не се прехвърлят. Прегледът също така
  отбелязва подкана, която все още указва на агента да използва инструмент,
  който не е импортиран.
- **Текстови съобщения.** Агентите на ThunderPhone изпращат текстови съобщения
  чрез Вашата собствена връзка с телекомуникационен доставчик; настройте SMS в
  настройките на агента.
- **Инструменти без еквивалент** (автоматизации, специфични за платформата) се
  изброяват, за да не бъде пропуснато нищо без уведомяване.
- **Променливи при обаждане.** Контейнерите `{{name}}` се запазват със
  стойностите по подразбиране от Вашата платформа. ThunderPhone ги попълва от
  [променливите, предадени при започване на обаждане](/bg/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}`) или списък с такива обекти. Инструментите, свързани само чрез id, и
  файловете със знания изискват ключ, за да бъдат разрешени. Vapi премахна Workflows, затова преобразувайте
  Workflow в Squad, преди да го поставите.
- **Retell** — обектът на агента (`GET /get-agent/{id}?version=...`) **заедно
  с** неговия Retell LLM от същата версия (`GET /get-retell-llm/{id}?version=...`)
  или обект на поток за разговор в същия списък. Импортерът свързва по id и
  версия, предпочита поставен публикуван агент, когато има статус на публикуване,
  и импортира самостоятелен LLM или поток с генерирано име.
- **ElevenLabs** — обектът на агента (`GET /v1/convai/agents/{id}`). Текущите
  експортирания обикновено препращат към инструменти за уебхукове и документи със знания само чрез id.
  Поставянето отчита тези елементи като неразрешени; използвайте API ключ за пълен импорт.
- **Bland** — уеб агент, отговорът от `/v1/agents` или обект на сценарий.
  Всеки поставен обект се импортира като собствен агент, дори когато два обекта споделят id;
  id на инструменти и знания, които изискват API достъп, се изброяват за ръчна настройка,
  вместо да бъдат премахнати.

Всичко, към което има препратка само по идентификатор и не присъства в поставеното съдържание, е изброено в
бележките.

## След импортирането

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

Импортерът е достъпен и чрез [REST API](/api-reference/agent-imports).

Импортирането не ви обвързва. Всеки агент може да бъде експортиран като отворени файлове безплатно по всяко
време: вижте [Напускане на ThunderPhone](/bg/guides/leaving-thunderphone).
