Handleidingen

Sleutelklaar

Wilt u de agent niet zelf bouwen? U beschrijft uw branche en wat de agent moet kunnen, en de oprichter van volai bouwt hem met de hand voor een vaste prijs uit de prijslijst - klaar binnen 24 werkuren na betaling.

Wat sleutelklaar is

Sleutelklaar is een eenmalige betaalde dienst: u start een bestelling (in het portaal op /na-klic, via REST met POST /v1/setup-orders of met de MCP-tool create_setup_order), beschrijft in één bericht uw branche en wat de agent moet kunnen, en krijgt meteen een offerte met een vaste prijs. De prijs wordt altijd door code berekend op basis van de catalogus (pakketten, add-ons, een uurtarief voor extra werk) - het model kiest uit het gesprek alleen items en verzint of wijzigt nooit zelf een prijs.

Na betaling bouwt de oprichter van volai de agent met de hand - het is geen geautomatiseerd sjabloon. Een nummer, een systeemprompt, kennis van uw website en prijslijst, doorverbinden naar een collega en gestructureerde gespreksgegevens maken deel uit van elk pakket.

Een korter overzicht voor advertenties (zonder API- en MCP-details) staat op de pagina Receptionist sleutelklaar.

Voor wie

Sleutelklaar past bij u als u de agent niet zelf in de editor wilt instellen, of als u een tweede telefoonnummer, meerdere agents, een koppeling met een agenda of facturatiesysteem wilt en dat niet met de hand wilt samenstellen.

Hoe het gesprek verloopt

Het model mag hooguit vijf vervolgvragen stellen voordat het een prijs moet opgeven - een bestelling die via REST of MCP (create_setup_order) wordt gestart, is meteen eenmalig: het eerste bericht moet alles bevatten wat ertoe doet, het model stelt geen vervolgvragen en legt onduidelijkheden als aannames vast in de offerte (veld selection.assumptions) in plaats van als vraag. In het portaal mag het model wel doorvragen, tot de limiet is bereikt.

Zolang de bestelling op betaling wacht (status quoted of awaiting_confirmation), VERVANGT een volgend bericht de offerte door een nieuwe versie - ook daarvoor geldt dezelfde eenmalige regel. Zodra de klant de betaling opent, wordt de offerte voor 24 uur bevroren en wijst hij een volgend bericht af met de fout checkout_open, zodat niemand de oude prijs betaalt voor een gewijzigde omvang.

Een item buiten de catalogus (customItems) wordt per half uur tegen het uurtarief berekend; als de som van de eigen items de hieronder genoemde drempel overschrijdt, wacht de offerte op bevestiging door de oprichter (status awaiting_confirmation) - de prijs is indicatief totdat hij hem bevestigt.

Prijzen

De enige bron voor prijzen is de catalogus in de code - de offerte, de factuur en deze pagina tonen dezelfde bedragen.

Pakketten (eenmalige inrichting)

Add-ons

Werk buiten de catalogus

Alles buiten de pakketten en add-ons (een ongebruikelijke koppeling, een grotere aanpassing) wordt per half uur tegen het uurtarief berekend; boven deze drempel in totaal wacht de offerte op bevestiging door de oprichter voordat er betaald kan worden. (1.490,00 kr / uur, drempel 4 uur)

De offerte toont daarnaast een indicatie van de maandelijkse gebruikskosten (nummer, gespreksminuten, agent) volgens dezelfde calculator als op /cenik - die maken geen deel uit van de prijs van de inrichting, ze worden naar werkelijk gebruik van uw tegoed afgeschreven.

De aanpassingsrondes die in de prijs van het pakket zitten (Bedrijfslocatie 2, Onderneming 3) tellen vanaf de status `ready`, niet vanaf het begin van de bouw. Een extra ronde daarboven kost 490,00 kr en wordt van uw tegoed afgeschreven zodra de oprichter hem afrondt (`revision -> ready`) - niet bij het versturen van het bericht.

Wat u betaalt en wanneer

Eén betaling dekt de prijs van de inrichting EN een eerste opwaardering van het tegoed (u kiest uit de aangeboden bedragen) - van het tegoed worden daarna de werkelijke gebruikskosten van de agent betaald, net als bij een gewoon account. De betaling wordt door een MENS geopend en voldaan, vanuit MCP of REST wordt niets automatisch afgeschreven - de tools geven alleen een Stripe Checkout-link terug.

Na betaling ontvangt u een belastingdocument voor de inrichting (en voor de opwaardering van het tegoed), net als bij een opwaardering met een kaart - in /kredit of via list_billing_documents/get_billing_document.

Termijn en garantie

Klaar binnen 24 werkuren na betaling - uren die op zaterdag en zondag vallen, tellen niet mee voor de termijn. De add-on Express verkort de termijn tot 4 uur.

Statussen van de bestelling

Een bestelling doorloopt vaste, toegestane overgangen - zowel de klant als de oprichter kunnen maar een beperkt aantal stappen zetten (POST /v1/setup-orders/{id}/launch en .../cancel, in het portaal met de knoppen Starten en Bestelling annuleren).

Zelf annuleren (cancel_setup_order/POST .../cancel) kan alleen een ONBETAALDE bestelling (draft, quoted, awaiting_confirmation of declined) - een betaalde bestelling annuleert alleen de oprichter.

Wat u zelf doet

Een paar stappen blijven altijd bij de klant, omdat niemand anders ze namens uw account bij de provider kan uitvoeren:

1. Het bestaande nummer bij uw eigen provider doorschakelen naar het nieuwe nummer van de agent (de handleiding krijgt u bij de kant-en-klare agent), of meteen het nieuwe nummer gebruiken.
2. Met één klik een Google- of Apple-agenda koppelen, als u de add-on met afspraken hebt besteld.
3. Een proefgesprek met de kant-en-klare agent voordat u hem start (launch_setup_order) - starten is de eigen bevestiging van de klant en gebeurt nooit automatisch namens hem.

REST en MCP

Zeven endpoints onder /v1/setup-orders (aanmaken, lijst, detail, bericht, checkout, starten, annuleren) en dezelfde zeven MCP-tools (create_setup_order, list_setup_orders, get_setup_order, message_setup_order, checkout_setup_order, launch_setup_order, cancel_setup_order) roepen dezelfde servicelaag aan - dezelfde regels, dezelfde prijzen, dezelfde statussen.

De volledige referentie met de fouten van elk endpoint vindt u in het onderdeel Setup orders in de REST API-referentie.

De beschrijving van de afzonderlijke MCP-tools staat in het onderdeel Sleutelklaar op de pagina MCP-server.