Ръководства

Под ключ

Не искате да изграждате агента сами? Описвате своята дейност и какво да умее агентът, а основателят на volai го изгражда на ръка за фиксирана цена от ценовата листа - готов до 24 работни часа след плащането.

Какво е Под ключ

Под ключ е еднократна платена услуга: създавате поръчка (в портала на /na-klic, през REST POST /v1/setup-orders или с MCP инструмента create_setup_order), в едно съобщение описвате своята дейност и какво да умее агентът и веднага получавате оферта с фиксирана цена. Цената винаги се изчислява от кода по каталог (пакети, добавки, почасова ставка за допълнителна работа) - моделът от разговора само избира позиции, никога не измисля и не променя цена.

След плащането агентът се изгражда на ръка директно от основателя на volai - не става дума за автоматизиран шаблон. Номер, системен промпт, знания от Вашия уебсайт и ценова листа, прехвърляне към колега и записвани данни от обаждането са част от всеки пакет.

По-кратък преглед за реклама (без подробности за API и MCP) има на страницата Рецепционист под ключ.

За кого е

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

Как протича разговорът

Моделът задава най-много пет допълнителни въпроса, преди да трябва да изготви оферта - при поръчка, създадена през REST или MCP (create_setup_order), разговорът е изначално еднократен: първото съобщение трябва да съдържа всичко съществено, моделът не задава допълнителни въпроси, а неясното записва като допускания в офертата (поле selection.assumptions), а не като въпрос. В портала моделът, напротив, може да задава въпроси, докато не изчерпи тавана.

Докато поръчката чака плащане (състояние quoted или awaiting_confirmation), следващо съобщение ПРЕЗАПИСВА офертата с нова версия - и за нея важи същото правило за еднократност. Щом клиентът отвори плащането, офертата се заключва за 24 часа и следващо съобщение се отхвърля с грешка checkout_open, за да не плати старата цена за променен обхват.

Позиция извън каталога (customItems) се изчислява на половинчасови единици по почасовата ставка; ако сборът на собствените позиции надхвърли посочения по-долу праг, офертата чака потвърждение от основателя (състояние awaiting_confirmation) - цената е ориентировъчна, докато основателят не я потвърди.

Цени

Единственият източник на цени е каталогът в кода - едни и същи числа виждат офертата, фактурата и тази страница.

Пакети (еднократно изграждане)

Добавки

Работа извън каталога

Всичко извън пакетите и добавките (необичайна интеграция, по-дълга корекция) се изчислява на половинчасови единици по почасовата ставка; ако общата сума надхвърли този праг, офертата чака потвърждение от основателя, преди да може да бъде платена. (1490,00 kr / час, праг 4 часа)

Офертата показва и ориентировъчна месечна работа (номер, минути обаждания, агент) по същия калкулатор като на /cenik - тя не е част от цената на изграждането и се плаща според реалната употреба от баланса.

Кръговете корекции в цената на пакета (Обект 2, Фирма 3) се броят от състояние `ready`, а не от началото на изграждането. Следващ кръг над този брой струва 490,00 kr и се удържа от баланса, когато основателят го завърши (`revision -> ready`) - не при изпращането на съобщението.

Какво се плаща и кога

Едно плащане покрива цената на изграждането И първото зареждане на баланса (избирате от предложените суми) - от баланса след това се плаща реалната работа на агента, както при обикновен акаунт. Плащането отваря и извършва ЧОВЕК, от MCP или REST нищо не се удържа автоматично - инструментите само връщат връзка към Stripe Checkout.

След плащането получавате данъчен документ за изграждането (и за зареждането на баланса), както при зареждане с карта - в /kredit или чрез list_billing_documents/get_billing_document.

Срок и гаранция

Готово до 24 работни часа след плащането - часовете в събота и неделя не се броят в срока. Добавката Експрес скъсява срока на 4 часа.

Състояния на поръчката

Поръчката минава през точно определени позволени преходи - и клиентът, и основателят имат само ограничен набор от стъпки, които могат да предприемат (POST /v1/setup-orders/{id}/launch и .../cancel, в портала с бутоните Пусни и Откажи поръчката).

Сами можете да откажете (cancel_setup_order/POST .../cancel) само НЕПЛАТЕНА поръчка (draft, quoted, awaiting_confirmation или declined) - платена поръчка отказва само основателят.

Какво правите сами

Няколко стъпки винаги остават за клиента, защото никой друг не може да ги извърши вместо него в акаунта му при оператора:

1. Пренасочване на съществуващия номер към новия номер на агента при Вашия оператор (инструкция получавате с готовия агент) или направо използване на новия номер.
2. Свързване на Google или Apple календар с едно щракване, ако сте поръчали добавката със записване на часове.
3. Тестово обаждане към готовия агент преди пускането (launch_setup_order) - пускането е собствено потвърждение на клиента и никога не се извършва автоматично вместо него.

REST и MCP

Седем крайни точки под /v1/setup-orders (създаване, списък, детайл, съобщение, плащане, пускане, отказ) и същите седем MCP инструмента (create_setup_order, list_setup_orders, get_setup_order, message_setup_order, checkout_setup_order, launch_setup_order, cancel_setup_order) извикват един и същи сервизен слой - едни и същи правила, едни и същи цени, едни и същи състояния.

Пълната справка с грешките при всяка крайна точка ще намерите в раздела Setup orders в справочника за REST API.

Описанието на отделните MCP инструменти е в областта Под ключ на страницата MCP сървър.