Vejledninger

Nøglefærdig

Vil du ikke bygge agenten selv? Beskriv din branche, og hvad agenten skal kunne, så bygger volais grundlægger den personligt til en fast pris fra prislisten - klar inden for 24 arbejdstimer efter betaling.

Hvad er nøglefærdig

Nøglefærdig er en engangsydelse mod betaling: du opretter en bestilling (i portalen på /na-klic, via REST POST /v1/setup-orders eller med MCP-værktøjet create_setup_order), beskriver i én besked din branche og hvad agenten skal kunne, og får straks et tilbud med fast pris. Prisen beregnes altid af koden ud fra kataloget (pakker, tilvalg, timepris for ekstra arbejde) - modellen i samtalen vælger kun poster og finder aldrig selv på eller ændrer en pris.

Efter betaling bygges agenten i hånden direkte af volais grundlægger - det er ikke en automatiseret skabelon. Nummer, systemprompt, viden fra din hjemmeside og prisliste, viderestilling til en kollega og de data, der skrives fra opkaldet, er en del af hver pakke.

En kortere oversigt til annoncering (uden API- og MCP-detaljer) findes på siden Nøglefærdig receptionist.

Hvem er det til

Nøglefærdig passer, når du ikke vil konfigurere agenten selv i editoren, eller når du vil have et ekstra telefonnummer, flere agenter, en forbindelse til kalender eller faktureringssystem og ikke vil sætte det sammen manuelt.

Sådan forløber samtalen

Samtalen har højst fem opfølgende spørgsmål fra modellen, før den skal levere en pris - ved en bestilling oprettet via REST eller MCP (create_setup_order) er den straks engangs: den første besked skal indeholde alt væsentligt, modellen spørger ikke videre og skriver uklarheder ind i tilbuddet som antagelser (feltet selection.assumptions), ikke som spørgsmål. I portalen må modellen derimod spørge videre, indtil spørgsmålsloftet er opbrugt.

Så længe bestillingen venter på betaling (status quoted eller awaiting_confirmation), OVERSKRIVER en ny besked tilbuddet med en ny version - den samme engangsregel gælder også her. Så snart kunden åbner betalingen, fryses tilbuddet i 24 timer og afviser en yderligere besked med fejlen checkout_open, så kunden ikke betaler den gamle pris for et nyt omfang.

En post uden for kataloget (customItems) beregnes i halve timer efter timeprisen; overstiger summen af egne poster tærsklen nedenfor, venter tilbuddet på ejerens bekræftelse (status awaiting_confirmation) - prisen er vejledende, indtil ejeren bekræfter den.

Prisliste

Den eneste kilde til priser er kataloget i koden - tilbuddet, fakturaen og denne side viser de samme tal.

Pakker (engangsopsætning)

Tilvalg

Arbejde uden for kataloget

Alt uden for pakker og tilvalg (en usædvanlig integration, en længere justering) beregnes i halve timer efter timeprisen; overstiger det samlet denne tærskel, venter tilbuddet på ejerens bekræftelse, før det kan betales. (1,490.00 CZK / time, tærskel 4 timer)

Tilbuddet viser desuden en vejledende månedlig drift (nummer, opkaldsminutter, agent) efter samme kalkulator som på /cenik - det er ikke en del af opsætningsprisen, men betales fra saldoen efter det faktiske forbrug.

Rettelsesrunderne i pakkeprisen (Provozovna 2, Firma 3) tælles fra status `ready`, ikke fra byggestart. En ekstra runde ud over dette antal koster 490.00 CZK og trækkes fra saldoen, når ejeren er færdig med den (`revision -> ready`) - ikke når beskeden sendes.

Hvad betales, og hvornår

Én betaling dækker opsætningsprisen OG en første opfyldning af saldoen (du vælger blandt de viste beløb) - saldoen betaler derefter agentens faktiske drift ligesom på en almindelig konto. Betalingen åbnes og gennemføres af et MENNESKE, fra MCP eller REST trækkes intet automatisk - værktøjerne returnerer kun et link til Stripe Checkout.

Efter betaling får du en skattemæssig faktura for opsætningen (og for opfyldningen af saldoen) ligesom ved en almindelig kortopfyldning - i /kredit eller via list_billing_documents/get_billing_document.

Frist og garanti

Klar inden for 24 arbejdstimer efter betaling - timer, der falder på lørdag og søndag, tæller ikke med i fristen. Tilvalget Express forkorter fristen til 4 timer.

Bestillingens statusser

Bestillingen gennemløber præcist fastlagte tilladte overgange - både kunde og ejer har kun et begrænset sæt trin, de må udføre (POST /v1/setup-orders/{id}/launch og .../cancel, i portalen med knapperne Start og Annuller bestilling).

Selv kan man kun annullere en IKKE-BETALT bestilling (cancel_setup_order/POST .../cancel; draft, quoted, awaiting_confirmation eller declined) - en betalt bestilling annullerer kun ejeren.

Hvad du selv gør

Nogle få trin forbliver altid kundens, fordi ingen andre kan udføre dem på kundens konto hos teleudbyderen:

1. Viderestilling af det eksisterende nummer til agentens nye nummer hos din teleudbyder (vejledningen følger med den færdige agent), eller blot at bruge det nye nummer direkte.
2. Tilslutning af Google- eller Apple-kalender med ét klik, hvis du har bestilt tilvalget med aftaler.
3. Et testopkald til den færdige agent før start (launch_setup_order) - start er kundens egen bekræftelse og sker aldrig automatisk på kundens vegne.

REST og MCP

Syv endpoints under /v1/setup-orders (oprettelse, liste, detalje, besked, checkout, start, annullering) og de samme syv MCP-værktøjer (create_setup_order, list_setup_orders, get_setup_order, message_setup_order, checkout_setup_order, launch_setup_order, cancel_setup_order) kalder det samme servicelag - samme regler, samme priser, samme statusser.

Den fulde reference med fejl for hvert endpoint findes i afsnittet Setup orders i REST API-referencen.

Beskrivelsen af de enkelte MCP-værktøjer findes i området Nøglefærdig på siden MCP-server.