Ghiduri
La cheie
Nu doriți să construiți agentul singur? Descrieți domeniul dumneavoastră și ce trebuie să știe agentul, iar proprietarul volai îl construiește personal, la un preț fix din lista de prețuri - gata în 24 de ore lucrătoare de la plată.
Ce este La cheie
La cheie este un serviciu plătit, unic: creați o comandă (în portal, la /na-klic, prin REST POST /v1/setup-orders sau cu instrumentul MCP create_setup_order), descrieți într-un singur mesaj domeniul dumneavoastră și ce trebuie să știe agentul și primiți imediat o ofertă cu preț fix. Prețul îl calculează întotdeauna codul pe baza catalogului (pachete, suplimente, tarif orar pentru munca suplimentară) - modelul din conversație doar alege elementele, nu inventează și nu modifică niciodată prețul.
După plată, agentul este construit manual direct de proprietarul volai - nu este vorba despre un șablon automatizat. Numărul, promptul de sistem, cunoștințele de pe site-ul și din lista dumneavoastră de prețuri, transferul către un coleg și datele înregistrate din apel fac parte din fiecare pachet.
O prezentare mai scurtă pentru reclamă (fără detalii despre API și MCP) se află pe pagina Recepționer la cheie.
Pentru cine
La cheie se potrivește când nu doriți să configurați singur agentul în editor sau când doriți un al doilea număr de telefon, mai mulți agenți, conectare la calendar ori la un sistem de facturare și nu vreți să le asamblați manual.
Unui liber-profesionist mic, cu puține apeluri pe zi, fără suplimente și fără transfer, oferta îi recomandă în locul prețului produsul mai simplu Lorela (răspuns în câmpul declineReason: "lorela" și link către lorela.cz) - un agent vocal propriu la cheie ar fi acolo o soluție inutil de mare.
Cum decurge conversația
Conversația are cel mult cinci întrebări suplimentare din partea modelului înainte ca acesta să trebuiască să stabilească prețul - la o comandă creată prin REST sau MCP (create_setup_order) este de la început unică: primul mesaj trebuie să conțină tot ce este esențial, modelul nu mai pune întrebări, iar neclaritățile le înscrie în ofertă ca presupuneri (câmpul selection.assumptions), nu ca întrebare. În portal, în schimb, modelul poate pune întrebări până epuizează limita.
Cât timp comanda așteaptă plata (starea quoted sau awaiting_confirmation), un mesaj următor SUPRASCRIE oferta cu o versiune nouă - se aplică aceeași regulă a mesajului unic. De îndată ce clientul deschide plata, oferta se blochează pentru 24 de ore, iar un mesaj următor este respins cu eroarea checkout_open, ca să nu plătească prețul vechi pentru un conținut nou.
Un element din afara catalogului (customItems) se calculează pe jumătăți de oră, la tariful orar; dacă suma elementelor proprii depășește pragul indicat mai jos, oferta așteaptă confirmarea proprietarului (starea awaiting_confirmation) - prețul este orientativ până când proprietarul îl confirmă.
Prețuri
Singura sursă a prețurilor este catalogul din cod - aceleași cifre le văd oferta, factura și această pagină.
Pachete (configurare unică)
Suplimente
Muncă din afara catalogului
Orice în afara pachetelor și suplimentelor (o integrare neobișnuită, o modificare mai lungă) se calculează pe jumătăți de oră, la tariful orar; dacă totalul depășește acest prag, oferta așteaptă confirmarea proprietarului înainte de a putea fi plătită. (1,490.00 CZK / oră, prag 4 ore)
Oferta arată și costul lunar orientativ de funcționare (număr, minute de apeluri, agent) după același calculator ca la /cenik - acesta nu face parte din prețul de configurare și se plătește din credit, în funcție de funcționarea reală.
Rundele de modificări incluse în prețul pachetului (Unitate 2, Firmă 3) se numără începând cu starea `ready`, nu de la începutul construcției. O rundă suplimentară peste acest număr costă 490.00 CZK și se scade din credit după ce proprietarul o finalizează (`revision -> ready`) - nu la trimiterea mesajului.
Ce se plătește și când
O singură plată acoperă prețul de configurare ȘI prima reîncărcare a creditului (alegeți dintre sumele propuse) - din credit se plătește apoi funcționarea reală a agentului, la fel ca la un cont obișnuit. Checkout-ul îl deschide și îl plătește O PERSOANĂ, din MCP sau REST nu se debitează nimic automat - instrumentele returnează doar un link către Stripe Checkout.
După plată primiți documentul fiscal pentru configurare (și pentru reîncărcarea creditului), la fel ca la reîncărcarea cu cardul - în /kredit sau prin list_billing_documents/get_billing_document.
Termen și garanție
Gata în 24 de ore lucrătoare de la plată - orele care cad sâmbăta și duminica nu se numără în termen. Suplimentul Express reduce termenul la 4 ore.
Dacă proprietarul nu respectă termenul sau dacă, după încercare, agentul nu corespunde cerințelor, vi se cuvine returnarea prețului de configurare - clientul o solicită cu butonul "Vreau returnarea configurării" de la comandă, în portal. Rambursarea pe card o gestionează manual proprietarul, dar documentul fiscal de corecție (notă de credit, număr OD...) la factura inițială îl emite portalul singur - îl găsiți în /kredit sau prin list_billing_documents (câmpul kind: "credit_note").
Stările comenzii
Comanda trece prin tranziții permise, exact definite - atât clientul, cât și proprietarul au doar un set limitat de pași pe care îi pot face (POST /v1/setup-orders/{id}/launch și .../cancel, în portal cu butoanele Pornire și Anulare comandă).
draftcreate_setup_order/primul mesaj în portal).quotedcheckout_setup_order).awaiting_confirmationdeclinedmessage_setup_order), ca să apară o ofertă obișnuită (quoted), sau anulează comanda.paidbuildingreadylaunch_setup_order), fie cereți o modificare printr-un mesaj (apare revision).revisionlaunchedcancelledSingur (cancel_setup_order/POST .../cancel) puteți anula doar o comandă NEPLĂTITĂ (draft, quoted, awaiting_confirmation sau declined) - una plătită o anulează doar proprietarul.
Ce faceți dumneavoastră
Câțiva pași rămân întotdeauna în sarcina clientului, pentru că nimeni altcineva nu îi poate face în locul lui, în contul său la operator:
- Redirecționarea numărului existent către noul număr al agentului, la operatorul dumneavoastră (instrucțiunile le primiți odată cu agentul gata), sau folosirea directă a noului număr.
- Conectarea calendarului Google sau Apple dintr-un singur clic, dacă ați comandat suplimentul cu programări.
- Un apel de probă către agentul gata, înainte de pornire (
launch_setup_order) - pornirea este confirmarea proprie a clientului și nu se face niciodată automat în locul lui.
REST și MCP
Șapte endpoint-uri sub /v1/setup-orders (creare, listare, detaliu, mesaj, checkout, pornire, anulare) și aceleași șapte instrumente MCP (create_setup_order, list_setup_orders, get_setup_order, message_setup_order, checkout_setup_order, launch_setup_order, cancel_setup_order) apelează același strat de servicii - aceleași reguli, aceleași prețuri, aceleași stări.
Referința completă, cu erorile fiecărui endpoint, o găsiți în secțiunea Setup orders din referința API REST.
Descrierea instrumentelor MCP este în zona La cheie de pe pagina Server MCP.
Conexe
Server MCP
Conectați Claude Code, Codex CLI, Codex desktop, Cursor și alte editoare AI.
API REST
Referință completă pentru toate endpointurile: numere, apeluri, SMS, numere de mobil pentru SMS, agenți și schițele lor, instrumente, înregistrări, webhookuri, lista „nu apelați”, relay, cont, sarcini, credit, documente, calendare și integrări.
Credit
Sold, autonomie, istoricul mișcărilor, reîncărcări cu cardul, reîncărcare automată și documente fiscale.