Oppaat
Avaimet käteen
Jos agenttia ei halua rakentaa itse, kuvaile yritys ja se, mitä agentin pitää osata, niin volain perustaja rakentaa sen henkilökohtaisesti kiinteään hintaan hinnaston mukaan - valmis 24 työtunnin kuluessa maksusta.
Mitä Avaimet käteen on
Avaimet käteen on kertaluonteinen maksullinen palvelu: tilaus tehdään portaalissa osoitteessa /na-klic, REST-rajapinnalla POST /v1/setup-orders tai MCP-työkalulla create_setup_order, yritys ja agentin tehtävät kuvataan yhdessä viestissä, ja kiinteähintainen tarjousehdotus tulee heti. Hinta lasketaan aina koodilla katalogista (paketit, lisäpalvelut, lisätyön tuntihinta) - malli vain valitsee keskustelusta kohdat eikä koskaan keksi tai muuta hintaa.
Maksun jälkeen volain perustaja rakentaa agentin käsin - se ei ole automaattinen pohja. Numero, järjestelmäkehote, tieto verkkosivuilta ja hinnastosta, siirto kollegalle sekä puhelusta tallennettavat tiedot kuuluvat jokaiseen pakettiin.
Lyhyempi yleiskatsaus mainoksia varten (ilman API- ja MCP-yksityiskohtia) on sivulla Avaimet käteen -vastaanottovirkailija.
Kenelle
Avaimet käteen sopii, kun agenttia ei haluta määrittää itse editorissa tai kun tarvitaan toinen puhelinnumero, useita agentteja, yhteys kalenteriin tai laskutusjärjestelmään eikä kaikkea haluta kursia kokoon käsin.
Pienelle yksityisyrittäjälle, jolla on vain vähän puheluita päivässä, ei lisäpalveluita eikä siirtoa, tarjous suosittelee hinnan sijaan yksinkertaisempaa tuotetta Lorela (vastaus kentässä declineReason: "lorela" ja linkki osoitteeseen lorela.cz) - oma avaimet käteen -puheagentti olisi siihen tarpeettoman suuri ratkaisu.
Näin keskustelu etenee
Malli saa esittää enintään viisi lisäkysymystä, ennen kuin sen on annettava hinta - REST-rajapinnan tai MCP:n (create_setup_order) kautta tehty tilaus on sen sijaan kertaluonteinen: ensimmäisessä viestissä on oltava kaikki olennainen, malli ei kysy enempää ja kirjaa epäselvyydet tarjoukseen oletuksina (kenttä selection.assumptions) kysymysten sijaan. Portaalissa malli saa kysyä lisää, kunnes kysymysten enimmäismäärä täyttyy.
Niin kauan kuin tilaus odottaa maksua (tila quoted tai awaiting_confirmation), seuraava viesti KORVAA tarjouksen uudella versiolla - sama kertaluonteisuuden sääntö koskee myös tässä. Kun asiakas avaa maksun, tarjous jäädytetään 24 tunniksi ja lisäviestit hylätään virheellä checkout_open, jotta kukaan ei maksa vanhaa hintaa uudesta laajuudesta.
Katalogin ulkopuolinen kohta (customItems) hinnoitellaan puolen tunnin jaksoissa tuntihinnan mukaan; jos omien kohtien summa ylittää alla mainitun kynnyksen, tarjous odottaa perustajan vahvistusta (tila awaiting_confirmation) - hinta on alustava, kunnes perustaja on vahvistanut sen.
Hinnasto
Ainoa hintojen lähde on koodissa oleva katalogi - samat luvut näkyvät tarjouksessa, laskussa ja tällä sivulla.
Paketit (kertaluonteinen käyttöönottomaksu)
Lisäpalvelut
Katalogin ulkopuolinen työ
Kaikki pakettien ja lisäpalvelujen ulkopuolinen (epätavallinen integraatio, pidempi muutos) hinnoitellaan puolen tunnin jaksoissa tuntihinnan mukaan; jos summa ylittää tämän kynnyksen, tarjous odottaa perustajan vahvistusta, ennen kuin sen voi maksaa. (62,09 € / tunti, kynnys 4 tuntia)
Tarjouksessa näkyy myös suuntaa antava kuukausittainen käyttö (numero, puheluminuutit, agentti) samalla laskurilla kuin sivulla /cenik - se ei kuulu käyttöönoton hintaan, vaan maksetaan saldosta todellisen käytön mukaan.
Pakettiin kuuluvat muutoskierrokset (Toimipiste 2, Yritys 3) lasketaan tilasta `ready`, ei rakentamisen alusta. Tämän määrän ylittävä kierros maksaa 20,42 € ja veloitetaan saldosta, kun perustaja on saanut sen valmiiksi (`revision -> ready`) - ei viestin lähettämisen yhteydessä.
Mitä maksetaan ja milloin
Yksi maksu kattaa käyttöönoton hinnan JA saldon ensimmäisen latauksen (summa valitaan tarjotuista) - saldosta maksetaan sitten agentin todellinen käyttö aivan kuten tavallisella tilillä. Maksun avaa ja tekee IHMINEN, mitään ei veloiteta automaattisesti MCP:n tai REST-rajapinnan kautta - työkalut palauttavat vain linkin Stripe Checkoutiin.
Maksun jälkeen tulee verotosite käyttöönotosta (ja saldon latauksesta) samalla tavalla kuin korttilatauksessa - osoitteessa /kredit tai työkaluilla list_billing_documents/get_billing_document.
Aikataulu ja takuu
Valmis 24 työtunnin kuluessa maksusta - lauantaille ja sunnuntaille osuvia tunteja ei lasketa määräaikaan. Lisäpalvelu Express lyhentää ajan 4 tuntiin.
Jos perustaja ei ehdi määräajassa tai agentti ei testin jälkeen vastaa tehtävää, käyttöönoton hinta palautetaan - asiakas pyytää sitä painikkeella ”Haluan käyttöönottomaksun takaisin” tilauksen kohdalla portaalissa. Palautuksen kortille hoitaa perustaja käsin, mutta alkuperäistä laskua korjaavan verotositteen (hyvityslasku, numero OD...) antaa portaali itse - se löytyy osoitteesta /kredit tai työkalulla list_billing_documents (kenttä kind: "credit_note").
Tilauksen tilat
Tilaus kulkee täsmällisesti määriteltyjen sallittujen siirtymien läpi - sekä asiakkaalla että perustajalla on vain rajallinen joukko askelia, jotka he saavat ottaa (POST /v1/setup-orders/{id}/launch ja .../cancel, portaalissa painikkeilla Käynnistä ja Peruuta tilaus).
draftcreate_setup_order/ensimmäinen viesti portaalissa).quotedcheckout_setup_order).awaiting_confirmationdeclinedmessage_setup_order), jolloin syntyy tavallinen tarjous (quoted), tai peruuttaa tilauksen.paidbuildingreadylaunch_setup_order) tai pyydä muutosta viestillä (jolloin syntyy revision).revisionlaunchedcancelledItse voi peruuttaa (cancel_setup_order/POST .../cancel) vain MAKSAMATTOMAN tilauksen (draft, quoted, awaiting_confirmation tai declined) - maksetun tilauksen peruu vain perustaja.
Mitä tehdään itse
Muutama askel jää aina asiakkaalle, koska kukaan muu ei voi tehdä niitä asiakkaan tilillä operaattorin luona:
- Nykyisen numeron siirto agentin uuteen numeroon oman operaattorin luona (ohje tulee valmiin agentin mukana) tai uuden numeron käyttöönotto sellaisenaan.
- Google- tai Apple-kalenterin yhdistäminen yhdellä napsautuksella, jos ajanvarauksen lisäpalvelu on tilattu.
- Testipuhelu valmiille agentille ennen käynnistystä (
launch_setup_order) - käynnistys on asiakkaan oma vahvistus eikä sitä koskaan tehdä automaattisesti asiakkaan puolesta.
REST ja MCP
Seitsemän endpointia polun /v1/setup-orders alla (luo, luettelo, tiedot, viesti, checkout, käynnistys, peruutus) ja samat seitsemän MCP-työkalua (create_setup_order, list_setup_orders, get_setup_order, message_setup_order, checkout_setup_order, launch_setup_order, cancel_setup_order) kutsuvat samaa palvelukerrosta - samat säännöt, samat hinnat, samat tilat.
Täydellinen referenssi virheineen jokaiselle endpointille on osiossa Setup orders REST API -referenssissä.
Yksittäisten MCP-työkalujen kuvaus on alueen Avaimet käteen alla sivulla MCP-palvelin.
Liittyvää
MCP-palvelin
Yhdistä Claude Code, Codex CLI, Codex desktop, Cursor ja muut tekoälyeditorit.
REST API
Täydellinen kuvaus jokaisesta päätepisteestä: numerot, puhelut, tekstiviestit, tekstiviestien matkapuhelinnumerot, agentit ja niiden luonnokset, työkalut, tallenteet, webhookit, soittokieltolista, välitys, tili, tehtävät, saldo, asiakirjat, kalenterit ja integraatiot.
Saldo
Saldo, riittävyys, tapahtumahistoria, korttilataukset, automaattinen lataus ja verotositteet.