Průvodci

Na klíč

Nechceš stavět agenta sám? Popíšeš svůj obor a co má agent umět, a majitel volai ho za pevnou cenu z ceníku postaví osobně - hotový do 24 pracovních hodin od zaplacení.

Co je Na klíč

Na klíč je jednorázová placená služba: založíš objednávku (v portálu na /na-klic, přes REST POST /v1/setup-orders, nebo MCP nástrojem create_setup_order), popíšeš v jedné zprávě svůj obor a co má agent umět, a hned dostaneš nabídku s pevnou cenou. Cenu vždy počítá kód podle katalogu (balíčky, doplňky, hodinová sazba za práci navíc) - model z rozhovoru jen vybere položky, nikdy si cenu nevymýšlí ani ji neupravuje.

Po zaplacení agenta postaví ručně přímo majitel volai - nejde o automatizovanou šablonu. Číslo, systémový prompt, znalosti z tvého webu a ceníku, přepojení na kolegu a zapisovaná data z hovoru jsou součástí každého balíčku.

Kratší přehled pro reklamu (bez API a MCP detailů) je na stránce Recepční na klíč.

Pro koho

Na klíč se hodí, když nechceš agenta konfigurovat sám v editoru, nebo chceš druhé telefonní číslo, více agentů, napojení na kalendář či fakturační systém a nechceš to skládat ručně.

Jak probíhá rozhovor

Rozhovor má nejvýš pět doplňujících otázek modelu, než musí nacenit - u objednávky založené přes REST nebo MCP (create_setup_order) je rovnou jednorázová: první zpráva musí obsahovat vše podstatné, model se už nedoptává a nejasnosti zapíše jako domněnky do nabídky (pole selection.assumptions), ne jako otázku. V portálu naopak model doptávat smí, dokud otázek nevyčerpá strop.

Dokud objednávka čeká na platbu (stav quoted nebo awaiting_confirmation), další zpráva nabídku PŘEPÍŠE novou verzí - to samé jednorázové pravidlo platí i pro ni. Jakmile zákazník otevře platbu, nabídka se na 24 hodin zmrazí a další zprávu odmítne chybou checkout_open, aby nezaplatil starou cenu za nový rozsah.

Položka mimo katalog (customItems) se počítá po půlhodinách za hodinovou sazbu; přesáhne-li součet vlastních položek práh uvedený níže, nabídka čeká na potvrzení majitelem (stav awaiting_confirmation) - cena je orientační, dokud ji majitel nepotvrdí.

Ceník

Jediný zdroj cen je katalog v kódu - stejná čísla vidí nabídka, faktura i tahle stránka.

Balíčky (jednorázové zřízení)

Doplňky

Práce mimo katalog

Cokoli mimo balíčky a doplňky (neobvyklá integrace, delší úprava) se počítá po půlhodinách za hodinovou sazbu; přesáhne-li tento práh celkem, nabídka čeká na potvrzení majitelem, než ji jde zaplatit. (1 490,00 Kč / hodina, práh 4 hodiny)

Nabídka k tomu ukáže i orientační měsíční provoz (číslo, minuty hovorů, agent) podle stejné kalkulačky jako na /cenik - to není součást ceny zřízení, platí se to podle skutečného provozu z kreditu.

Kola úprav v ceně balíčku (Provozovna 2, Firma 3) se počítají od stavu `ready`, ne od začátku stavby. Další kolo nad tenhle počet stojí 490,00 Kč a strhne se z kreditu, až ho majitel dokončí (`revision -> ready`) - ne při odeslání zprávy.

Co se platí a kdy

Jedna platba pokrývá cenu zřízení A první dobití kreditu (vybereš z částek 200, 500, 1000 nebo 2000 Kč) - kreditem se pak platí skutečný provoz agenta stejně jako u běžného účtu. Checkout otevírá a platí ČLOVĚK, z MCP ani REST se nic nestrhne automaticky - nástroje jen vrátí odkaz na Stripe Checkout.

Po zaplacení dostaneš daňový doklad za zřízení (a za dobití kreditu) stejně jako u kartového dobití - v /kredit nebo přes list_billing_documents/get_billing_document.

Termín a garance

Hotovo do 24 pracovních hodin od zaplacení - hodiny připadající na sobotu a neděli se do lhůty nepočítají. Doplněk Expres zkrátí termín na 4 hodiny.

Stavy objednávky

Objednávka prochází přesně danými povolenými přechody - zákazník i majitel mají jen omezenou množinu kroků, které smí udělat (POST /v1/setup-orders/{id}/launch a .../cancel, v portálu tlačítky Spustit a Zrušit objednávku).

Zrušit sám (cancel_setup_order/POST .../cancel) jde jen NEZAPLACENOU objednávku (draft, quoted, awaiting_confirmation nebo declined) - zaplacenou zruší jen majitel.

Co uděláš sám

Pár kroků zůstává vždy na zákazníkovi, protože je nemůže udělat nikdo jiný za jeho účet u operátora:

1. Přesměrování stávajícího čísla na nové číslo agenta u svého operátora (návod dostaneš s hotovým agentem), nebo rovnou používání nového čísla.
2. Připojení Google nebo Apple kalendáře jedním kliknutím, pokud sis objednal doplněk s termíny.
3. Zkušební hovor na hotového agenta před spuštěním (launch_setup_order) - spuštění je vlastní potvrzení zákazníka, nikdy se nedělá automaticky za něj.

REST a MCP

Sedm endpointů pod /v1/setup-orders (založení, výpis, detail, zpráva, checkout, spuštění, zrušení) a stejných sedm MCP nástrojů (create_setup_order, list_setup_orders, get_setup_order, message_setup_order, checkout_setup_order, launch_setup_order, cancel_setup_order) volají stejnou servisní vrstvu - stejná pravidla, stejné ceny, stejné stavy.

Úplnou referenci s chybami u každého endpointu najdeš v sekci Setup orders v REST API referenci.

Popis jednotlivých MCP nástrojů je v oblasti Na klíč na stránce MCP server.