Juhendid
Võtmed kätte
Ei taha agenti ise ehitada? Kirjeldage oma ettevõtet ja seda, mida agent peaks tegema, ning volai asutaja ehitab selle käsitsi valmis kataloogi kindla hinnaga - valmis 24 töötunni jooksul pärast makset.
Mis on Võtmed kätte
Võtmed kätte on ühekordne tasuline teenus: alustage tellimust (portaalis aadressil /done-for-you, REST-i kaudu POST /v1/setup-orders või MCP tööriistaga create_setup_order), kirjeldage ühes sõnumis oma ettevõtet ja seda, mida agent peaks tegema, ning saate kohe kindla hinnaga pakkumise. Hind pärineb alati koodis olevast kataloogist (paketid, lisad, tunnihind lisatöö eest) - mudel valib vestlusest ainult kirjeid, hinda ta ei mõtle ise välja ega muuda.
Pärast makset ehitab volai asutaja agendi käsitsi - see ei ole automaatne mall. Iga paketi osa on telefoninumber, süsteemiprompt, teadmised teie veebilehelt ja hinnakirjast, suunamine kolleegile ning struktureeritud kõneandmed.
Lühem ülevaade reklaami jaoks (ilma API ja MCP üksikasjadeta) on lehel Vastuvõtja võtmed kätte.
Kellele see sobib
Võtmed kätte sobib siis, kui te ei taha agenti redaktoris ise seadistada või soovite teist telefoninumbrit, mitut agenti või kalendri- või arvelduseühendust ega taha seda käsitsi siduda.
Väikeettevõtte puhul, kus töötab üks inimene, kõnesid on päevas vähe ning lisasid ega suunamist pole, soovitab pakkumine hinna asemel lihtsamat toodet Lorela (vastuses declineReason: "lorela" koos lingiga aadressile lorela.cz) - käsitsi ehitatud häälagent oleks seal liialdus.
Kuidas vestlus toimib
Mudel võib enne pakkumise koostamist esitada kuni viis täpsustavat küsimust - REST-i või MCP kaudu (create_setup_order) alustatud tellimus on algusest peale ühekordne: esimene sõnum peab sisaldama kõike olulist, mudel ei esita kunagi täpsustavat küsimust ja kõik ebaselge muutub pakkumises eelduseks (selection.assumptions), mitte küsimuseks. Portaalis võib mudel täpsustavaid küsimusi esitada kuni selle piirini.
Kui tellimus ootab makset (olek quoted või awaiting_confirmation), ASENDAB iga järgmine sõnum pakkumise uuega - ka selle suhtes kehtib sama ühekordsuse reegel. Kui klient avab kassa, külmub pakkumine 24 tunniks ja lükkab järgmise sõnumi tagasi veaga checkout_open, et ta ei maksaks muutunud mahu eest vana hinda.
Kataloogiväline kirje (customItems) hinnatakse poole tunni sammuga tunnihinna järgi; kui kohandatud kirjed ületavad allpool toodud piiri, jääb pakkumine ootama asutaja kinnitust (awaiting_confirmation) - hind on kinnitamiseni esialgne.
Hinnad
Koodis olev kataloog on hindade ainus allikas - pakkumine, arve ja see leht näitavad samu numbreid.
Paketid (ühekordne seadistus)
Lisad
Kataloogiväline töö
Kõik, mis jääb pakettidest ja lisadest välja (ebatavaline integratsioon, pikem muudatus), hinnatakse poole tunni sammuga tunnihinna järgi; selle piiri ületava kogusumma korral jääb pakkumine ootama asutaja kinnitust, enne kui seda saab maksta. (1,490.00 CZK / tund, piir 4 tundi)
Pakkumine näitab ka hinnangulist igakuist tegevuskulu (number, kõneminutid, agent) samast kalkulaatorist nagu /pricing - see ei kuulu seadistuse hinna hulka, vaid arvestatakse saldost vastavalt agendi tegelikule kasutusele.
Paketi hinda kuuluvad parandusvoorud (Business 2, Company 3) loetakse olekust `ready`, mitte ehituse algusest. Sellest arvust üle läinud voor maksab 490.00 CZK ja arvatakse saldost maha, kui asutaja selle lõpetab (`revision -> ready`) - mitte sõnumi saatmisel.
Mida makstakse ja millal
Üks makse katab seadistuse hinna JA esimese saldo täienduse (valige summa 200, 500, 1000 või 2000 CZK) - saldost makstakse seejärel agendi tegelike tegevuskulude eest nagu igal kontol. Kassa avab ja tasub INIMENE; MCP-st ega REST-ist ei debiteerita midagi automaatselt - tööriistad tagastavad ainult Stripe Checkouti lingi.
Pärast makset saate maksedokumendi seadistustasu (ja saldo täienduse) kohta, nagu kaardiga täienduselgi - lehel /credit või kaudu list_billing_documents/get_billing_document.
Tähtaeg ja garantii
Valmis 24 töötunni jooksul pärast makset - laupäeva või pühapäeva langevaid tunde tähtaja hulka ei arvestata. Lisa Express lühendab selle 4 tunnini.
Kui asutaja jätab tähtaja täitmata või agent ei vasta pärast testimist ülesandele, on seadistustasu tagastatav - klient taotleb seda portaalis tellimusel nupuga „Soovin seadistustasu tagasi“. Kaardi tagasimakse teeb asutaja käsitsi, kuid algse arve parandusdokumendi (kreeditarve, number algab OD...) väljastab portaal ise - leiate selle lehelt /credit või kaudu list_billing_documents (kind: "credit_note").
Tellimuse olekud
Tellimus liigub kindlate lubatud üleminekute kaudu - nii klient kui ka asutaja saavad teha ainult piiratud hulga samme (POST /v1/setup-orders/{id}/launch ja .../cancel või portaali nupud Käivita ja Tühista tellimus).
draftcreate_setup_order või esimene sõnum portaalis).quotedcheckout_setup_order).awaiting_confirmationdeclinedmessage_setup_order) mahtu kitsendada ja saada tavalise pakkumise (quoted) või tellimuse tühistada.paidbuildingreadylaunch_setup_order) või paluge sõnumiga muudatust (see alustab revision).revisionlaunchedcancelledIse tühistada (cancel_setup_order/POST .../cancel) saab ainult MAKSMATA tellimuse (draft, quoted, awaiting_confirmation või declined) - makstud tellimuse saab tühistada ainult asutaja.
Mida teete ise
Mõned sammud jäävad alati kliendile, sest keegi teine ei saa neid teie nimel operaatori juures teha:
- Olemasoleva numbri edasisuunamine uue agendi numbrile oma operaatori juures (juhendi saate koos valmis agendiga) või lihtsalt uue numbri kasutamine sellisena, nagu see on.
- Google'i või Apple'i kalendri ühendamine ühe klõpsuga, kui tellisite kalendribroneerimise lisa.
- Proovikõne valmis agendile enne selle käivitamist (
launch_setup_order) - käivitamine on kliendi enda kinnitus, seda ei tehta kunagi tema nimel automaatselt.
REST ja MCP
Seitse lõpp-punkti aadressi /v1/setup-orders all (loomine, loend, üksikasjad, sõnum, kassa, käivitamine, tühistamine) ja samad seitse MCP tööriista (create_setup_order, list_setup_orders, get_setup_order, message_setup_order, checkout_setup_order, launch_setup_order, cancel_setup_order) kutsuvad sama teenusekihti - samad reeglid, samad hinnad, samad olekud.
Täielik viide koos iga lõpp-punkti vigadega on jaotises REST API viite jaotis Setup orders.
Iga MCP tööriista kirjeldus on alal Võtmed kätte lehel MCP server.
Seotud
MCP server
Ühendage Claude Code, Codex CLI, Codex desktop, Cursor ja teised AI-redaktorid.
REST API
Täielik viide kõigile lõpp-punktidele: numbrid, kõned, SMS, SMS-i mobiilinumbrid, agendid ja nende mustandid, tööriistad, salvestised, veebihaagid, mittehelistamise nimekiri, relee, konto, ülesanded, saldo, dokumendid, kalendrid ja integratsioonid.
Saldo
Saldo, kestvus, liikumiste ajalugu, kaarditäiendused, automaatne täiendamine ja maksudokumendid.