--- title: "Основни понятия" description: "Карта на всичко в платформата — какво прави всеки обект, къде се намира в таблото за управление и кой API го използва." --- ThunderPhone е цялостна платформа за създаване, изпълнение и подобряване на AI гласови агенти. Тази страница е картата: всяка концепция, с която ще се срещнете, е представена в кратък раздел, заедно с интерфейса в таблото за управление и API, което я поддържа. Прегледайте я веднъж, след което се връщайте към нея винаги когато някой термин се нуждае от пояснение. Страничната лента на таблото за управление отразява тази структура: [Агенти](#agents), [гласове](#voices), [телефонни номера](#phone-numbers), [уеб уиджети](#web-widgets), [обаждания](#calls), [клиентски портали](#client-portals), [бази знания](#knowledge-bases). [Мониторинг на живо](#live-monitoring) и изходящи [кампании](#campaigns). [Приложения, API, MCP сървъри и VoIP доставчици](#connections), които вашите агенти могат да използват. [Симулации](#simulations), [набори за валидиране](#validation-sets), [експерименти](#experiments), [проблеми](#issues), [отчети](#reports), [наблюдаемост](#observability). [Екип и роли](#team-and-roles), [API ключове](#organizations), [известия](#alerts), [таксуване](#billing). [Уебхукове](#webhooks) и [инструменти за функции](#function-tools) за вашия собствен код. --- ## Организации **Организацията** е единицата за изолация на данни. Всеки друг ресурс — агенти, телефонни номера, обаждания, ключове — принадлежи на точно една организация. Вашият акаунт може да принадлежи към много организации; всяка има собствен баланс, собствени ключове и собствен списък с членове. API ключът `sk_live_`, който създавате в **Организация → Ключове**, е обвързан с една организация. Тази обвързаност прави REST API толкова опростен: никога не поставяте идентификатор на организация в URL пътищата, защото вашият ключ вече я идентифицира. **В таблото за управление:** превключвателят за организация (в долната част на страничната лента) и настройките на **Организация** — раздели за Моят акаунт, Общи, Ключове, Известия, Настройки за таксуване и Хронология на таксуването. Вижте [справочника за настройките на организацията](/bg/guides/organization-settings). **В API:** [`/v1/orgs`](/api-reference/organizations), [`/v1/developer/api-keys`](/api-reference/developer-api-keys). --- ## Агенти **Агентът** е AI конфигурацията, която изпълнява обаждане. Той обединява: - **Подкана**, която определя какво казва агентът и как се държи — включително действия по време на обаждане, като прехвърляния, натискания на клавиши и прекратяване на разговора, които са обикновени редове в подканата, а не отделна конфигурация. - **Ниво на енджина** (`spark`, `bolt`, `storm-*`): Spark е оптимизиран за цена, Bolt — за скорост, а Storm — за интелигентност при сложни подкани. - **Глас**, както и **основен език** и незадължителни **допълнителни езици** — агентът превключва автоматично, когато обаждащият се смени езика. Вижте [Поддържани езици](/bg/guides/supported-languages). - Прикачени възможности: [свързани приложения](#connections), [API връзки](#connections), [бази знания](#knowledge-bases), [MCP сървъри](#connections) и вградени [инструменти за функции](#function-tools). - Настройки за поведение: ред на говорене, режим на потвърждение, фонов запис, време на изчакване при задържане. Промените в създателя **се запазват автоматично като чернова**; нищо не влиза в продукционна среда, докато не натиснете **Разгръщане**. Всяко разгръщане се заснема в раздела **Хронология** на създателя, така че можете да преглеждате и възстановявате всяка предишна версия. **В таблото за управление:** **Гласови агенти** → създателят на агенти (`/dashboard/agents`). Вижте [Създайте първия си гласов агент](/bg/guides/build-an-agent). **В API:** [`/v1/agents`](/api-reference/agents) — CRUD, дублиране, прехвърляне, хронология на версиите и помощни средства за подкани. --- ## Гласове **Библиотеката с гласове** съдържа гласовете, които агентът може да използва, техните проби за прослушване, съвместимите езици, групирания по пол и акцент, както и всяко доплащане за премиум глас/език. Платена функция за проби може да синтезира ваша собствена фраза от 1–500 знака, преди да изберете. Допустимите организации могат също да създават **персонализирани гласове** от кратка WAV или MP3 проба. Персонализираните гласове имат квота и асинхронен статус на създаване; когато са готови, се появяват в същия избор на агент като гласовете от библиотеката. **В таблото:** **Гласове** (`/dashboard/voices`). Вижте [Библиотека с гласове и персонализирани гласове](/bg/guides/voice-library). **В API:** [`/v1/voices`](/api-reference/voices), [гласови проби](/api-reference/voice-samples) и [персонализирани гласове](/api-reference/custom-voices). --- ## Телефонни номера **Телефонният номер** принадлежи на организация и насочва входящите обаждания към агент (и може да се използва за изходящи обаждания). Има два източника: - **Номера на ThunderPhone** — реални американски номера, предоставени от пула на ThunderPhone, активни за секунди, {/* rate:phone */}$1/месец плюс доплащане от 1¢/минута{/* /rate */}. Само за входящи обаждания; за изходящи е необходим ваш собствен оператор. Една организация може да притежава 25 по подразбиране. - **VoIP номера** — предоставени от ваш собствен доставчик чрез [VoIP връзка](#connections). Twilio и Telnyx се свързват директно (Telnyx има водена настройка); SignalWire и Vonage предстоят — днес можете да ги използвате чрез ръчна SIP конфигурация, която приема всеки SIP trunk. След импортиране и потвърждаване VoIP номерата поддържат входящи и изходящи обаждания. Всеки ред с номер ви позволява да зададете режим на маршрутизиране, да изберете агента за входящи обаждания и да добавите етикет към номера. **В таблото:** **Телефонни номера** (`/dashboard/phone-numbers`). Вижте [Получаване на телефонен номер](/bg/guides/get-a-phone-number). **В API:** [`/v1/phone-numbers`](/api-reference/phone-numbers), [`/v1/voip-connections`](/api-reference/voip-connections), [`/v1/phone-number-labels`](/api-reference/phone-number-labels). --- ## Обаждания Всяко входящо обаждане, изходящо обаждане, симулация и сесия на джаджа става **дневник на обаждане**. Обаждането съдържа пълния транскрипт с обозначени роли, структурираната история на ходовете (включително извиквания на инструменти), запис, общата сума за таксуване и незадължителни AI оценки и отчети за проблеми. Докато обаждането е **активно**, можете да го отворите и да **слушате** — включвате се безшумно и никой в обаждането не ви чува. След като слушате, можете да **подскажете**: въведете инструкция, която отива директно до вашия агент по време на обаждането; обаждащият се никога не я чува, а агентът я следва в реално време. **В таблото:** **История на обажданията** (`/dashboard/call-history`) за архива и подробностите за всяко обаждане; **Активни** за текущите обаждания. Вижте [Преглед, слушане и насочване на вашите обаждания](/bg/guides/review-calls). **В API:** [`/v1/calls`](/api-reference/calls) — списък, транскрипт, история, аудио, оценяване, експортиране; [`/v1/issue-reports`](/api-reference/issue-reports). --- ## Клиентски портали **Клиентският портал** е брандиран изглед само за четене на историята на обажданията за външен клиент. Администраторите на организацията избират агентите, чиито обаждания се показват, добавят одобрени имейл адреси на зрители, качват лого и акцентен цвят и по желание потвърждават персонализиран домейн. Зрителите на портала могат да преглеждат подробности за обажданията, транскрипти и налични записи, без да получават достъп до таблото. **В таблото:** **Клиентски портали** (`/dashboard/client-portals`). Вижте [Клиентски портали](/bg/guides/client-portals). **В API:** [`/v1/client-portals`](/api-reference/client-portals) за интерфейса за администраторско управление. --- ## Уеб уиджети **Уеб уиджетът** предоставя на посетителите на сайта ви разговор с агент чрез микрофон — не е необходим телефонен номер. Той се удостоверява с **публикуем ключ** (`pk_live_...`), който е ограничен до произхода на разрешените ви домейни, така че е безопасен за използване в клиентски код. Ключовете работят в един от два режима: `agent` (статично свързан с един агент) или `webhook` (вашият сървър избира конфигурацията за всеки посетител — вижте [Динамична конфигурация за всяко обаждане](/bg/guides/dynamic-call-config)). Сесиите на уиджета преминават през същата инфраструктура за обаждания като телефонните обаждания. **В таблото за управление:** **Уеб уиджети** (`/dashboard/web-widgets`) — създавайте уиджети, задавайте режима и агента, управлявайте разрешените домейни и копирайте кода за вграждане. Вижте [Създаване на уеб уиджет](/bg/guides/embed-a-web-widget-dashboard). **В API:** [`/v1/publishable-key`](/api-reference/publishable-keys), [`/v1/mic-session`](/api-reference/mic-sessions) и [документацията за SDK на уиджета](/bg/widget/overview). --- ## Бази знания **Базата знания** е набор от документи, в които агентът ви може да търси по време на разговор, за да обосновава отговорите си — качвайте файлове, поставяйте текст или импортирайте уеб страници чрез URL, след което прикачете базата знания към агент в конструктора. Агентът прави заявки към нея с вграден инструмент за търсене винаги когато разговорът го изисква. **В таблото за управление:** **Знания** (`/dashboard/knowledge`) за библиотеката с документи; разделът **Знания** в конструктора за прикачване на база към агент. Вижте [Дайте на агента си база знания](/bg/guides/knowledge-base). --- ## Връзки Връзките са начинът, по който агентите достигат до външния свят. Четири вида, една група в страничната лента: - **Приложения** (`/dashboard/app-connections`) — OAuth връзки към Slack, HubSpot, Salesforce, Google Calendar, Google Sheets и Cal.com. Свържете се веднъж, след което включвайте инструменти за отделни операции (изпращане на съобщение в Slack, добавяне или актуализиране на контакт в HubSpot, резервиране на час в Cal.com…) към всеки агент. Вижте [Свързване на приложения](/bg/guides/connect-apps). - **API** (`/dashboard/api-connections`) — превърнете всеки HTTP API в действие на агент. Поставете cURL команда и AI съветникът ще подготви чернова на дефиницията на инструмента, или я създайте ръчно; бутонът **Тестова заявка** изпраща sandbox заявка, преди да внедрите. Вижте [API връзки](/bg/guides/api-connections) — интерфейсът в таблото за управление на [`/v1/integrations`](/api-reference/integrations). - **MCP** (`/dashboard/mcp-connections`) — добавете сървър на Model Context Protocol чрез URL и позволете на агента да използва инструментите, които той предоставя. Вижте [Добавяне на MCP сървър](/bg/guides/mcp-servers). - **VoIP** (`/dashboard/voip-connections`) — идентификационни данни за доставчик за [използване на собствени телефонни номера](#phone-numbers). Вижте [Свързване на VoIP доставчик](/bg/guides/voip-providers). ThunderPhone също предоставя собствена MCP крайна точка, така че външен MCP клиент да може да изброява агенти, да преглежда обаждания и транскрипции и да извършва обаждания. Вижте [Използване на ThunderPhone като MCP сървър](/bg/guides/thunderphone-mcp-server). **В API:** [`/v1/integrations`](/api-reference/integrations), [`/v1/mcp-servers`](/api-reference/mcp-servers) и [`/v1/voip-connections`](/api-reference/voip-connections); вижте също [Създаване на интеграция с инструмент](/bg/guides/build-tool-integration). --- ## Кампании **Кампанията** извършва изходящи обаждания в голям мащаб: качете CSV файл с контакти, изберете агента и номера на подателя и задайте прозореца за обаждания (дни и часове, съобразени с часовата зона), едновременността и правилата за повторни опити (максимален брой опити и кои резултати — без отговор, гласова поща, неуспешно — да бъдат повторени). Кампанията преминава през списъка и записва всяко обаждане в История на обажданията. **В таблото за управление:** **Кампании** (`/dashboard/campaigns`). Вижте [Стартиране на кампания за изходящи обаждания](/bg/guides/outbound-campaigns). **За единични програмни обаждания:** [API за изходящи обаждания](/bg/guides/place-outbound-calls). ## Наблюдение на живо **На живо** показва всяко текущо обаждане в организацията и ви позволява да отворите което и да е от тях, за да [слушате и давате насоки](#calls) в реално време. Това е интерфейсът за наблюдение: следете как нова подкана получава първия си реален трафик или наблюдавайте текуща кампания. **В таблото за управление:** **На живо** (`/dashboard/live`). Вижте [Наблюдение и контрол на обаждания на живо](/bg/guides/monitor-live-calls). --- ## Симулации **Симулацията** е AI обаждащ се, който води реален разговор с вашия агент — по същия телекомуникационен път, с реален транскрипт и реално оценяване — така че да можете да тествате преди (и след) пускане в продукционна среда. Насочете я към агент или телефонен номер, напишете сами сценария на обаждащия се или **генерирайте сценарии с AI** от подканата на агента (включително гранични случаи, ако поискате), и наблюдавайте обаждането на живо. Сценариите се групират в **пакети**, които задават минимален процент на успешно преминаване и могат да блокират издания в CI; регресиите спрямо приетата базова линия се отчитат за всеки сценарий. **В таблото за управление:** **Симулации** (`/dashboard/simulations`), както и бутонът **Симулация** в конструктора на агента. Вижте [Симулиране на обаждане](/bg/guides/simulate-a-call). **В API:** [`/v1/test-calls`](/api-reference/test-calls) и изпълнителя на пакети — вижте [Тестване на агент от край до край](/bg/guides/test-agents). --- ## Набори за валидиране **Наборът за валидиране** превръща реални моменти от обажданията в повторяеми проверки за регресии с един ход. Всеки пример фиксира контекста на разговора, съответното аудио на обаждащия се, оригиналния отговор и очакваното поведение. Повторните изпълнения се стартират спрямо текущата чернова на агента, без да се извършва ново обаждане, а диалогът за внедряване може да покаже дали последното изпълнение все още съответства на тази чернова. **В таблото за управление:** **Набори за валидиране** (`/dashboard/validation`) за набора от данни на организацията и разделът **Валидиране** в конструктора на агента за изпълнения. Вижте [Набори за валидиране](/bg/guides/validation-sets). **В API:** [`/v1/validation-sets`](/api-reference/validation-sets) и крайните точки за повторно изпълнение на агент/пример на същата референтна страница. --- ## Експерименти **Експериментът** извършва A/B тестване на конфигурации на агенти върху реален трафик: дефинирайте варианти (различни подкани, механизми или настройки), разпределете трафика между тях и сравнете резултатите за всеки вариант. Използвайте го вместо ръчно изграждане на логика за сегменти във webhook. **В таблото за управление:** **Експерименти** (`/dashboard/experiments`) и разделът **A/B** в конструктора на агента. Вижте [Експерименти (A/B тестване)](/bg/guides/experiments-ab-testing). --- ## Проблеми **Проблемът** е маркиран казус при конкретно обаждане — подаден от човешки проверяващ или открит чрез AI оценяване. Проблемите съдържат степен на сериозност, източник и статус, а страницата „Проблеми“ е опашката за триаж: филтрирайте, проверете проблемното обаждане и проследявайте корекциите. **В таблото за управление:** **Проблеми** (`/dashboard/issues`), както и маркиране за всяко обаждане в История на обажданията. Вижте [Триаж на проблеми](/bg/guides/issues). **В API:** [`/v1/issue-reports`](/api-reference/issue-reports). --- ## Отчети **Отчетът** отговаря на въпрос на естествен език за данните от вашите обаждания („Кои бяха трите най-чести причини обаждащите се да поискат човек миналата седмица?“) с анализ, написан от AI, ограничен до избраните от вас агенти и диапазон от дати. **В таблото за управление:** **Отчети** (`/dashboard/reports`). Вижте [Отчети](/bg/guides/reports). --- ## Наблюдаемост **Наблюдаемост** е интерфейсът за метрики: обем на обажданията, резултати и качество във времето, с възможност за филтриране по агент и времеви прозорец, както и експортиране за последващ анализ. **В таблото за управление:** **Наблюдаемост** (`/dashboard/observability`). Вижте [Наблюдаемост](/bg/guides/observability). --- ## Сигнали **Правилото за сигнал** следи метрика (процент на успех, процент на неуспех, среден резултат, обем на обажданията, регресии в пакети) през времеви прозорец и се задейства, когато тя премине зададения от вас праг. Известията се изпращат по имейл и Slack и задействат събитие `alert.triggered` към вашите [webhook крайни точки](/bg/webhooks/endpoints). **В таблото за управление:** **Организация → Сигнали**. Вижте [Сигнали](/bg/guides/alerts). --- ## Уебхукове ThunderPhone изпраща **HTTP POST уебхукове** към вашия сървър, когато се случват неща по време на и след разговор. Два модела за доставка: - **Крайни точки за уебхукове** (препоръчително): управлявайте много URL адреси на [`/v1/developer/webhook-endpoints`](/bg/webhooks/endpoints) с тайни за всяка крайна точка и абонаменти за събития за всяка крайна точка. - **Наследен уебхук с един URL адрес**: един URL адрес за организация. Управлява се чрез [`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook) или от **Организация → Общи**. Запазен е за обратна съвместимост. Събитията се разделят на два класа: - **Блокиращите събития** очакват вашият сървър да отговори с конфигурация, която оформя текущия разговор — това са [събитията за входящо обаждане](/bg/webhooks/call-incoming) (`telephony.incoming` / `web.incoming`). Имате до 10 секунди да отговорите; при изчакване статично зададеният агент обработва разговора. - **Неблокиращите събития** са известия от тип „изпрати и забрави“, които се повтарят с експоненциално увеличаващо се изчакване — вижте [семантика на доставката](/bg/webhooks/overview). Всяка заявка съдържа HMAC-SHA256 подпис в `X-ThunderPhone-Signature`. Вижте [Проверка на подписа](/bg/webhooks/overview). --- ## Инструменти за функции **Инструментът за функции** е HTTP крайна точка, която вашият агент може да извика по време на разговор. Предоставяте на ThunderPhone схема на функция в стил OpenAI заедно с URL адрес на крайна точка; агентът решава кога да я извика, а ThunderPhone изпраща подписаната HTTP заявка от своите сървъри и предава резултата обратно на агента. Агентите включват и **вградени възможности за разговори** — прехвърляне на разговора, изпращане на вход от клавиатурата (DTMF), приключване на разговора, изчакване на линия — които активирате с обикновени редове в подканата, вместо с дефиниции на инструменти. **В таблото:** секцията **API връзки** на инструмента за създаване (вижте [Връзки](#connections)). **В API:** [`/v1/integrations`](/api-reference/integrations) и [спецификацията за инструменти за функции](/bg/tools/overview). --- ## Екип и роли Всяка организация има списък с членове с две роли: **Членовете** създават и управляват агенти; **Администраторите** също управляват екипа и фактурирането. Канете по имейл — поканите изтичат след 7 дни и могат да бъдат отменени; менюто ⋯ в реда на член променя ролите или премахва даден човек. Единното влизане може да се конфигурира за цялата организация — вижте [SSO](/bg/guides/sso). **В таблото:** **Организация → Общи**. Вижте [Поканете вашия екип](/bg/guides/invite-your-team). **В API:** [`/v1/members`](/api-reference/members), [`/v1/invites`](/api-reference/invites). --- ## Фактуриране ThunderPhone е **предплатен**. Всяка организация разполага с баланс в USD; разговорите го дебитират според тарифата на агента за минута (ниво на енджина плюс допълнителни такси — инструментът за създаване показва крайната тарифа в реално време, когато променяте настройките, а [избрани допълнителни езици](/bg/guides/supported-languages) добавят {/* rate:language */}3¢/мин{/* /rate */}). Когато балансът достигне нула, входящите обаждания се отхвърлят, а изходящите обаждания връщат `402 Payment Required`. Зареждайте средства ръчно или активирайте **автоматично зареждане** с праг на баланса, сума за зареждане и незадължителен месечен лимит на разходите — така разговорът никога няма да прекъсне по средата на изречение. **В таблото:** **Организация → Настройки за фактуриране** и **История на фактурирането**. Вижте [Добавете средства и включете автоматично зареждане](/bg/guides/billing-and-topups), както и [пълната справка за цените](/bg/guides/pricing). **В API:** [`/v1/billing`](/api-reference/billing). --- ## Вграденият копилот Таблото включва вграден **копилот** — попитайте го „как да направя X“ и той ще отговори въз основа на тази документация, ще предложи инструкции стъпка по стъпка, които открояват реалните контроли, и може да възпроизведе всяка от Водените обиколки. Това е най-бързият начин да намерите контрола, споменат на тази страница. Вижте [Попитайте вградения копилот](/bg/guides/ask-the-copilot). --- ## Обобщение Петстъпковият съветник: агент → таксуване → номер → симулация → преглед. Същото първо обаждане с четири REST заявки. Създайте агент, заредете средства, вземете номер, симулирайте и преглеждайте обаждания. OAuth приложения, персонализирани API, MCP сървъри и VoIP доставчици. Отчети, наблюдаемост, експерименти, проблеми и известия. Покани и роли, API ключове, сигурност и SSO. API рецепти: входящи, изходящи, динамична конфигурация, инструменти, тестване. Направете HMAC проверката правилно веднъж и я използвайте повторно навсякъде.