Przewodniki

Pod klucz

Nie chcą Państwo budować agenta samodzielnie? Opisują Państwo swoją branżę i to, co agent ma umieć, a założyciel volai zbuduje go osobiście za stałą cenę z cennika - gotowego w ciągu 24 godzin roboczych od zapłaty.

Czym jest Pod klucz

Pod klucz to jednorazowa płatna usługa: zakładają Państwo zamówienie (w portalu pod /na-klic, przez REST POST /v1/setup-orders lub narzędziem MCP create_setup_order), w jednej wiadomości opisują swoją branżę i to, co agent ma umieć, i od razu otrzymują ofertę ze stałą ceną. Cenę zawsze liczy kod na podstawie katalogu (pakiety, dodatki, stawka godzinowa za pracę dodatkową) - model z rozmowy tylko wybiera pozycje, nigdy sam nie wymyśla ceny ani jej nie zmienia.

Po zapłacie agenta buduje ręcznie sam założyciel volai - nie jest to zautomatyzowany szablon. Numer, prompt systemowy, wiedza z Państwa strony i cennika, przełączenie do współpracownika oraz dane zapisywane z rozmowy wchodzą w skład każdego pakietu.

Krótszy przegląd na potrzeby reklamy (bez szczegółów API i MCP) znajduje się na stronie Recepcjonista pod klucz.

Dla kogo

Pod klucz sprawdzi się, gdy nie chcą Państwo samodzielnie konfigurować agenta w edytorze albo potrzebują drugiego numeru telefonu, kilku agentów, integracji z kalendarzem lub systemem fakturowania i nie chcą składać tego ręcznie.

Jak przebiega rozmowa

W rozmowie model może zadać najwyżej pięć pytań uzupełniających, zanim musi wycenić - przy zamówieniu założonym przez REST lub MCP (create_setup_order) rozmowa jest od razu jednorazowa: pierwsza wiadomość musi zawierać wszystko, co istotne, model już nie dopytuje, a niejasności zapisuje w ofercie jako założenia (pole selection.assumptions), nie jako pytanie. W portalu natomiast model może dopytywać, dopóki nie wyczerpie limitu pytań.

Dopóki zamówienie czeka na płatność (status quoted lub awaiting_confirmation), kolejna wiadomość NADPISUJE ofertę nową wersją - ta sama reguła jednorazowości obowiązuje i tutaj. Gdy tylko klient otworzy płatność, oferta zostaje zamrożona na 24 godziny, a kolejna wiadomość zostanie odrzucona błędem checkout_open, aby nie zapłacił starej ceny za nowy zakres.

Pozycja spoza katalogu (customItems) jest liczona w półgodzinach według stawki godzinowej; jeśli suma pozycji własnych przekroczy podany niżej próg, oferta czeka na potwierdzenie przez właściciela (status awaiting_confirmation) - cena jest orientacyjna, dopóki właściciel jej nie potwierdzi.

Cennik

Jedynym źródłem cen jest katalog w kodzie - te same liczby widzą oferta, faktura i ta strona.

Pakiety (jednorazowe wdrożenie)

Dodatki

Prace spoza katalogu

Wszystko poza pakietami i dodatkami (nietypowa integracja, dłuższa modyfikacja) jest liczone w półgodzinach według stawki godzinowej; jeśli łącznie przekroczy ten próg, oferta czeka na potwierdzenie przez właściciela, zanim będzie można ją opłacić. (1,490.00 CZK / godzina, próg 4 godziny)

Oferta pokazuje też orientacyjny miesięczny koszt działania (numer, minuty rozmów, agent) według tego samego kalkulatora co na /cenik - nie wchodzi on w cenę wdrożenia i jest rozliczany z salda według faktycznego wykorzystania.

Rundy poprawek wliczone w cenę pakietu (Provozovna 2, Firma 3) liczą się od statusu `ready`, a nie od początku budowy. Kolejna runda ponad tę liczbę kosztuje 490.00 CZK i zostaje pobrana z salda, gdy właściciel ją zakończy (`revision -> ready`) - a nie w chwili wysłania wiadomości.

Co się płaci i kiedy

Jedna płatność obejmuje cenę wdrożenia ORAZ pierwsze doładowanie salda (kwotę wybierają Państwo spośród oferowanych) - z salda opłacane jest potem faktyczne działanie agenta, tak jak na zwykłym koncie. Płatność otwiera i opłaca CZŁOWIEK, z MCP ani REST nic nie jest pobierane automatycznie - narzędzia zwracają tylko odnośnik do Stripe Checkout.

Po zapłacie otrzymują Państwo fakturę za wdrożenie (i za doładowanie salda), tak jak przy doładowaniu kartą - w /kredit lub przez list_billing_documents/get_billing_document.

Termin i gwarancja

Gotowe w ciągu 24 godzin roboczych od zapłaty - godziny przypadające na sobotę i niedzielę nie wliczają się do terminu. Dodatek Express skraca termin do 4 godzin.

Statusy zamówienia

Zamówienie przechodzi ściśle określone, dozwolone przejścia - klient i właściciel mają tylko ograniczony zestaw kroków, które mogą wykonać (POST /v1/setup-orders/{id}/launch i .../cancel, w portalu przyciskami Uruchom i Anuluj zamówienie).

Samodzielnie (cancel_setup_order/POST .../cancel) można anulować tylko NIEOPŁACONE zamówienie (draft, quoted, awaiting_confirmation lub declined) - opłacone anuluje wyłącznie właściciel.

Co robią Państwo sami

Kilka kroków zawsze pozostaje po stronie klienta, ponieważ nikt inny nie może ich wykonać za niego na jego koncie u operatora:

1. Przekierowanie dotychczasowego numeru na nowy numer agenta u swojego operatora (instrukcję otrzymają Państwo wraz z gotowym agentem) albo od razu korzystanie z nowego numeru.
2. Podłączenie kalendarza Google lub Apple jednym kliknięciem, jeśli zamówili Państwo dodatek z terminami.
3. Rozmowa próbna z gotowym agentem przed uruchomieniem (launch_setup_order) - uruchomienie jest własnym potwierdzeniem klienta i nigdy nie odbywa się automatycznie za niego.

REST i MCP

Siedem endpointów pod /v1/setup-orders (założenie, lista, szczegóły, wiadomość, checkout, uruchomienie, anulowanie) i te same siedem narzędzi MCP (create_setup_order, list_setup_orders, get_setup_order, message_setup_order, checkout_setup_order, launch_setup_order, cancel_setup_order) korzystają z tej samej warstwy usług - te same reguły, te same ceny, te same statusy.

Pełną referencję z błędami dla każdego endpointu znajdą Państwo w sekcji Setup orders w referencji REST API.

Opis poszczególnych narzędzi MCP znajduje się w obszarze Pod klucz na stronie Serwer MCP.