Vodiči

Ključ u ruke

Ne želite sami graditi agenta? Opišete svoju djelatnost i što agent treba znati, a vlasnik volai osobno ga izrađuje za fiksnu cijenu iz cjenika - gotovog u roku od 24 radna sata od plaćanja.

Što je Ključ u ruke

Ključ u ruke je jednokratna plaćena usluga: otvorite narudžbu (u portalu na /na-klic, preko REST-a POST /v1/setup-orders ili MCP alatom create_setup_order), u jednoj poruci opišete svoju djelatnost i što agent treba znati te odmah dobivate ponudu s fiksnom cijenom. Cijenu uvijek izračunava kod prema katalogu (paketi, dodaci, satnica za dodatni rad) - model iz razgovora samo odabire stavke, cijenu nikada ne izmišlja niti mijenja.

Nakon plaćanja agenta ručno izrađuje izravno vlasnik volai - ne radi se o automatiziranom predlošku. Broj, sistemski prompt, znanje s vaše web stranice i cjenika, preusmjeravanje na kolegu i podaci zapisani iz poziva sastavni su dio svakog paketa.

Kraći pregled za oglašavanje (bez detalja o API-ju i MCP-u) nalazi se na stranici Recepcionar ključ u ruke.

Za koga

Ključ u ruke prikladan je kad ne želite sami konfigurirati agenta u editoru ili želite drugi telefonski broj, više agenata, povezivanje s kalendarom ili sustavom za fakturiranje i ne želite to slagati ručno.

Kako teče razgovor

Razgovor ima najviše pet dodatnih pitanja modela prije nego što mora izračunati cijenu - kod narudžbe otvorene preko REST-a ili MCP-a (create_setup_order) odmah je jednokratan: prva poruka mora sadržavati sve bitno, model se više ne raspituje, a nejasnoće upisuje u ponudu kao pretpostavke (polje selection.assumptions), ne kao pitanje. U portalu se model, naprotiv, smije raspitivati dok ne iscrpi ograničenje broja pitanja.

Dok narudžba čeka plaćanje (stanje quoted ili awaiting_confirmation), sljedeća poruka PREPISUJE ponudu novom verzijom - isto jednokratno pravilo vrijedi i za nju. Čim kupac otvori plaćanje, ponuda se na 24 sata zamrzava i sljedeću poruku odbija pogreškom checkout_open, kako ne bi platio staru cijenu za novi opseg.

Stavka izvan kataloga (customItems) računa se po pola sata prema satnici; ako zbroj vlastitih stavki premaši prag naveden niže, ponuda čeka potvrdu vlasnika (stanje awaiting_confirmation) - cijena je okvirna dok je vlasnik ne potvrdi.

Cjenik

Jedini izvor cijena je katalog u kodu - iste brojeve vide ponuda, račun i ova stranica.

Paketi (jednokratna uspostava)

Dodaci

Rad izvan kataloga

Sve izvan paketa i dodataka (neuobičajena integracija, dulja prilagodba) računa se po pola sata prema satnici; ako ukupno premaši ovaj prag, ponuda čeka potvrdu vlasnika prije nego što se može platiti. (1.490,00 kr / sat, prag 4 sata)

Ponuda uz to prikazuje i okvirni mjesečni rad (broj, minute poziva, agent) prema istom kalkulatoru kao na /cenik - to nije dio cijene uspostave, plaća se prema stvarnom radu iz stanja.

Krugovi izmjena u cijeni paketa (Poslovnica 2, Tvrtka 3) računaju se od stanja `ready`, a ne od početka izrade. Svaki sljedeći krug povrh tog broja košta 490,00 kr i skida se iz stanja tek kad ga vlasnik dovrši (`revision -> ready`) - ne pri slanju poruke.

Što se plaća i kada

Jedna uplata pokriva cijenu uspostave I prvu dopunu stanja (birate među ponuđenim iznosima) - iz stanja se zatim plaća stvarni rad agenta kao i kod običnog računa. Checkout otvara i plaća ČOVJEK, iz MCP-a ni REST-a ništa se ne naplaćuje automatski - alati samo vraćaju poveznicu na Stripe Checkout.

Nakon plaćanja dobivate račun za uspostavu (i za dopunu stanja) kao i kod dopune karticom - u /kredit ili preko list_billing_documents/get_billing_document.

Rok i jamstvo

Gotovo u roku od 24 radna sata od plaćanja - sati koji padaju na subotu i nedjelju ne ulaze u rok. Dodatak Ekspres skraćuje rok na 4 sata.

Stanja narudžbe

Narudžba prolazi točno određene dopuštene prijelaze - kupac i vlasnik imaju samo ograničen skup koraka koje smiju napraviti (POST /v1/setup-orders/{id}/launch i .../cancel, u portalu gumbima Pokreni i Otkaži narudžbu).

Sami možete otkazati (cancel_setup_order/POST .../cancel) samo NEPLAĆENU narudžbu (draft, quoted, awaiting_confirmation ili declined) - plaćenu otkazuje samo vlasnik.

Što radite sami

Nekoliko koraka uvijek ostaje na kupcu jer ih nitko drugi ne može napraviti umjesto njega na njegovu računu kod operatera:

1. Preusmjeravanje postojećeg broja na novi broj agenta kod svog operatera (upute dobivate uz gotovog agenta) ili odmah korištenje novog broja.
2. Povezivanje Google ili Apple kalendara jednim klikom, ako ste naručili dodatak s terminima.
3. Probni poziv gotovom agentu prije pokretanja (launch_setup_order) - pokretanje je vlastita potvrda kupca i nikada se ne radi automatski umjesto njega.

REST i MCP

Sedam endpointa pod /v1/setup-orders (otvaranje, popis, detalj, poruka, checkout, pokretanje, otkazivanje) i istih sedam MCP alata (create_setup_order, list_setup_orders, get_setup_order, message_setup_order, checkout_setup_order, launch_setup_order, cancel_setup_order) pozivaju isti servisni sloj - ista pravila, iste cijene, ista stanja.

Potpunu referencu s pogreškama za svaki endpoint pronaći ćete u odjeljku Setup orders u referenci REST API-ja.

Opis pojedinih MCP alata nalazi se u području Ključ u ruke na stranici MCP poslužitelj.