Anleitungen
Schlüsselfertig
Sie möchten den Agenten nicht selbst bauen? Beschreiben Sie Ihre Branche und was der Agent können soll, und der Inhaber von volai baut ihn persönlich zu einem Festpreis aus der Preisliste - fertig innerhalb von 24 Arbeitsstunden nach Zahlungseingang.
Was „Schlüsselfertig“ ist
Schlüsselfertig ist eine einmalige, kostenpflichtige Leistung: Sie legen eine Bestellung an (im Portal unter /na-klic, über REST POST /v1/setup-orders oder mit dem MCP-Tool create_setup_order), beschreiben in einer Nachricht Ihre Branche und was der Agent können soll, und erhalten sofort ein Angebot zum Festpreis. Den Preis berechnet immer der Code anhand des Katalogs (Pakete, Zusatzoptionen, Stundensatz für Mehraufwand) - das Modell wählt aus dem Gespräch lediglich Positionen aus, es erfindet oder ändert nie einen Preis.
Nach der Zahlung baut der Inhaber von volai den Agenten von Hand - es handelt sich nicht um eine automatisierte Vorlage. Eine Nummer, ein System-Prompt, Wissen aus Ihrer Website und Preisliste, die Weiterleitung an einen Kollegen und die erfassten Gesprächsdaten sind in jedem Paket enthalten.
Eine kürzere Übersicht für Werbung (ohne API- und MCP-Details) finden Sie auf der Seite Rezeption schlüsselfertig.
Für wen
Schlüsselfertig eignet sich, wenn Sie den Agenten nicht selbst im Editor konfigurieren möchten oder eine zweite Telefonnummer, mehrere Agenten, die Anbindung an einen Kalender oder ein Rechnungssystem wünschen und das nicht von Hand zusammenstellen wollen.
Einem kleinen Selbstständigen mit wenigen Anrufen pro Tag, ohne Zusatzoptionen und ohne Weiterleitung empfiehlt das Angebot statt eines Preises das einfachere Produkt Lorela (Antwort im Feld declineReason: "lorela" und Link auf lorela.cz) - ein eigens gebauter Sprachagent wäre dort eine unnötig große Lösung.
Wie das Gespräch abläuft
Das Modell darf höchstens fünf Rückfragen stellen, bevor es einen Preis nennen muss - bei einer über REST oder MCP (create_setup_order) angelegten Bestellung ist das Gespräch von vornherein einmalig: Die erste Nachricht muss alles Wesentliche enthalten, das Modell fragt nicht nach und hält Unklarheiten als Annahmen im Angebot fest (Feld selection.assumptions), statt eine Frage zu stellen. Im Portal darf das Modell dagegen nachfragen, bis die Obergrenze für Fragen erreicht ist.
Solange die Bestellung auf die Zahlung wartet (Status quoted oder awaiting_confirmation), ERSETZT jede weitere Nachricht das Angebot durch eine neue Fassung - auch dafür gilt die Einmal-Regel. Sobald der Kunde die Zahlung öffnet, wird das Angebot für 24 Stunden eingefroren und lehnt eine weitere Nachricht mit dem Fehler checkout_open ab, damit niemand den alten Preis für einen geänderten Umfang bezahlt.
Eine Position außerhalb des Katalogs (customItems) wird in halbstündigen Einheiten zum Stundensatz berechnet; übersteigt die Summe der individuellen Positionen die unten genannte Schwelle, wartet das Angebot auf die Bestätigung durch den Inhaber (Status awaiting_confirmation) - der Preis ist bis dahin nur ein Richtwert.
Preise
Einzige Preisquelle ist der Katalog im Code - dieselben Zahlen sehen Angebot, Rechnung und diese Seite.
Pakete (einmalige Einrichtung)
Zusatzoptionen
Arbeit außerhalb des Katalogs
Alles außerhalb der Pakete und Zusatzoptionen (eine ungewöhnliche Integration, eine umfangreichere Anpassung) wird in halbstündigen Einheiten zum Stundensatz berechnet; übersteigt die Summe diese Schwelle, wartet das Angebot auf die Bestätigung durch den Inhaber, bevor es bezahlt werden kann. (1,490.00 CZK / Stunde, Schwelle 4 Stunden)
Das Angebot zeigt zusätzlich einen Richtwert für den monatlichen Betrieb (Nummer, Gesprächsminuten, Agent) nach demselben Rechner wie unter /cenik - er ist nicht Teil des Einrichtungspreises, sondern wird nach tatsächlicher Nutzung aus dem Guthaben abgerechnet.
Die im Paketpreis enthaltenen Überarbeitungsrunden (Betrieb 2, Firma 3) zählen ab dem Status `ready`, nicht ab Baubeginn. Jede weitere Runde darüber hinaus kostet 490.00 CZK und wird vom Guthaben abgebucht, sobald der Inhaber sie abgeschlossen hat (`revision -> ready`) - nicht beim Absenden der Nachricht.
Was wann bezahlt wird
Eine Zahlung deckt den Einrichtungspreis UND die erste Guthabenaufladung ab (Sie wählen einen der angebotenen Beträge) - vom Guthaben wird anschließend der tatsächliche Betrieb des Agenten bezahlt, genau wie bei einem normalen Konto. Die Zahlung öffnet und bezahlt ein MENSCH; über MCP oder REST wird nichts automatisch abgebucht - die Tools liefern nur einen Link zu Stripe Checkout.
Nach der Zahlung erhalten Sie einen Steuerbeleg für die Einrichtung (und für die Guthabenaufladung), genauso wie bei einer Aufladung per Karte - unter /kredit oder über list_billing_documents/get_billing_document.
Frist und Garantie
Fertig innerhalb von 24 Arbeitsstunden nach Zahlungseingang - Stunden, die auf Samstag und Sonntag fallen, zählen nicht zur Frist. Die Zusatzoption Express verkürzt die Frist auf 4 Stunden.
Hält der Inhaber die Frist nicht ein oder entspricht der Agent nach dem Test nicht der Vorgabe, steht Ihnen die Erstattung des Einrichtungspreises zu - der Kunde fordert sie mit der Schaltfläche „Einrichtung zurückerstatten“ bei der Bestellung im Portal an. Die Rückzahlung auf die Karte veranlasst der Inhaber von Hand, den Korrekturbeleg (Gutschrift mit der Nummer OD...) zur ursprünglichen Rechnung stellt jedoch das Portal selbst aus - Sie finden ihn unter /kredit oder über list_billing_documents (Feld kind: "credit_note").
Bestellstatus
Eine Bestellung durchläuft genau festgelegte zulässige Übergänge - Kunde und Inhaber haben jeweils nur eine begrenzte Menge an Schritten zur Verfügung (POST /v1/setup-orders/{id}/launch und .../cancel, im Portal die Schaltflächen Starten und Bestellung stornieren).
draftcreate_setup_order bzw. die erste Nachricht im Portal).quotedcheckout_setup_order).awaiting_confirmationdeclinedmessage_setup_order), sodass ein reguläres Angebot (quoted) entsteht, oder storniert die Bestellung.paidbuildingreadylaunch_setup_order) oder fordern Sie per Nachricht eine Änderung an (es entsteht eine revision).revisionlaunchedcancelledSelbst stornieren (cancel_setup_order/POST .../cancel) lässt sich nur eine UNBEZAHLTE Bestellung (draft, quoted, awaiting_confirmation oder declined) - eine bezahlte storniert nur der Inhaber.
Was Sie selbst tun
Einige Schritte bleiben immer beim Kunden, weil niemand sonst sie für sein Konto beim Anbieter ausführen kann:
- Die Umleitung Ihrer bestehenden Nummer auf die neue Nummer des Agenten bei Ihrem Telefonanbieter (die Anleitung erhalten Sie mit dem fertigen Agenten) oder einfach die direkte Nutzung der neuen Nummer.
- Die Verbindung mit einem Google- oder Apple-Kalender mit einem Klick, falls Sie die Zusatzoption mit Terminen bestellt haben.
- Ein Testanruf beim fertigen Agenten vor dem Start (
launch_setup_order) - der Start ist die eigene Bestätigung des Kunden und erfolgt nie automatisch an seiner Stelle.
REST und MCP
Sieben Endpunkte unter /v1/setup-orders (Anlegen, Liste, Detail, Nachricht, Checkout, Start, Stornierung) und dieselben sieben MCP-Tools (create_setup_order, list_setup_orders, get_setup_order, message_setup_order, checkout_setup_order, launch_setup_order, cancel_setup_order) rufen dieselbe Serviceschicht auf - dieselben Regeln, dieselben Preise, dieselben Status.
Die vollständige Referenz mit den Fehlern zu jedem Endpunkt finden Sie im Abschnitt Setup orders in der REST-API-Referenz.
Die Beschreibung der einzelnen MCP-Tools steht im Bereich „Schlüsselfertig“ auf der Seite MCP-Server.
Verwandte Themen
MCP-Server
Verbinden Sie Claude Code, Codex CLI, die Codex-Desktop-App, Cursor und andere KI-Editoren.
REST-API
Vollständige Referenz aller Endpunkte: Nummern, Anrufe, SMS, Mobilnummern für SMS, Agenten und ihre Entwürfe, Tools, Aufnahmen, Webhooks, Sperrliste, Relay, Konto, Aufgaben, Guthaben, Belege, Kalender und Integrationen.
Guthaben
Guthaben, Reichweite, Bewegungsverlauf, Kartenaufladungen, automatische Aufladung und Steuerdokumente.