Aloita
Quickstart
Yhdistä ensin tekoälyavustaja tai sovellus ja vahvista yhteys soittamatta. Jatka sitten tehtävän työn mukaan: laskut, ajanvaraukset, tekstiviestit, saapuvat puhelut tai oma tehtävä.
1Luo tili
Rekisteröityminen vie minuutin ja on ilmaista, korttia ei tarvita. Kun sähköpostiosoite on vahvistettu, tilille tulee 2 € saldoa - se riittää numeron ostoon ja muutamaan kokeilupuheluun (tekstiviestit onnistuvat vasta ensimmäisen latauksen jälkeen). Unohtuneen salasanan voi palauttaa milloin tahansa kirjautumissivun linkistä tavallisella sähköpostiviestillä, jossa on linkki uuden salasanan antamiseen.
Luo tili ilmaiseksi2Avaa avustajan yhteys
Avaa portaalissa osio Tekoälyavustaja ja valitse yhteys OAuthilla. Claude Code, Codex CLI ja Codex desktop osaavat avata kirjautumisen; muille asiakkaille jää vaihtoehto olemassa olevalla API-avaimella.
Avaa avustajan yhteys3Yhdistä - MCP tai REST API
MCP kytkee volain työkalut suoraan avustajaan. REST API sopii omaan sovellukseen. Molemmat tiet käyttävät samaa tiliä ja avainta; tuetut toiminnot ja niiden rajoitukset ovat alempana toimintokartassa.
Tekoälyavustaja MCP:n kautta
Yksi komento Claude Codelle (asennus Cursorille, Windsurfille, VS Codelle ja Claude Desktopille on sivulla MCP-palvelin):
claude mcp add --transport http --scope user volai 'https://volai.cz/mcp'
claude mcp login volaiVahvista yhteys soittamatta
Liitä tämä tehtävä uuteen keskusteluun yhdistetyssä avustajassa. Yhteys on valmis vasta, kun on tehty todellinen vain luku -haku työkaluilla `get_balance` ja `list_agents`; vahvistamiseen ei tarvitse soittaa, lähettää tekstiviestejä eikä ostaa numeroita.
Yhdistä volai MCP-palvelimeksi osoitteessa https://volai.cz/mcp ohjeen https://volai.cz/SKILL.md mukaan. Jos se on jo yhdistetty, käytä olemassa olevaa yhteyttä. Jos voit hallita MCP:tä tässä ympäristössä, valmistele määritys; muuten opasta minua tarkoilla vaiheilla. Käytä volain kautta tapahtuvaa kirjautumista ja jätä kirjautuminen ja suostumus minulle. Älä pyydä API-avainta chatissa. Varmista sitten yhteys työkaluilla get_balance ja list_agents. Älä muuta mitään muuta, älä soita puheluita, älä lähetä viestejä äläkä osta mitään.Oma sovellus REST API:n kautta
Vahvista avain yhdellä saldoa koskevalla kysymyksellä:
curl https://volai.cz/v1/balance \
-H "Authorization: Bearer vk_YOUR_KEY"{
"balanceHal": 5000,
"balanceCzk": 50.00,
"currency": "CZK"
}4Valinnainen: valitse seuraava työ
Jatka vahvistuksen jälkeen tavoitteesi mukaan. Voit käyttää opasta, verkkoportaalia, REST API:a tai omaa MCP-tehtävää; alla olevat esimerkit ovat inspiraatioksi, eivät pakollinen ensimmäinen tehtävä.
Avaa yleiskatsausJatka verkossaKorvaa esimerkkinumerot ja tunnukset omillasi. Alla olevat vastaukset näyttävät olennaiset kentät; täydelliset muodot ovat REST-referenssissä. Maksullisessa toiminnossa käytetään samaa Idempotency-Key-otsaketta, kun toiminto toistetaan, ja uutta uudelle toiminnolle.
Valinnainen: kokeile ääntä oikealla puhelulla
Tämä on nopein tapa kuulla volai omin korvin: yksi pyyntö ja muutaman sekunnin kuluttua puhelin soi. Numeroa ei tarvitse ostaa eikä agenttia luoda - riittää kirjoittaa, mitä agentin pitää tehdä, kenttään systemPrompt kentän agentId sijaan. Puhelu tulee volain jaetusta demonumerosta.
curl -X POST https://volai.cz/v1/calls \
-H "Authorization: Bearer vk_YOUR_KEY" \
-H "Idempotency-Key: REPLACE_WITH_UNIQUE_CALL_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"to": "+420777123456",
"systemPrompt": "Olet kahvila Nulan vastaanottovirkailija. Tervehdi, kysy, mitä vieras haluaa, ja toista tilaus."
}'{
"id": "c_8f2ac1d4x7qz",
"status": "initiated",
"trial": true,
"from": "+420217217412"
}Tämä on oikea puhelu oikealla rahalla
Puhelu veloitetaan kuten tavallinen puhelu agentin kanssa. Käytä omaa numeroasi tai numeroa, jonka haltija on antanut suostumuksensa. Voimassa on kolmen kokeilupuhelun raja 24 tunnissa tiliä kohden sekä alustan yhteinen raja; oma agentti ohittaa vain kokeilulinjan rajan, muut rajat pätevät edelleen.
Valinnainen: lähetä tekstiviesti
Lähetä tekstiviesti mihin tahansa tšekkiläiseen tai slovakialaiseen matkapuhelinnumeroon tai johonkin Hinnasto-sivun muista maista. Tekstiviestit onnistuvat vasta saldon ensimmäisen latauksen jälkeen, tervetulosaldoa ei voi käyttää niihin. Vastausta ei kuitenkaan kannata odottaa - vastaanottaja ei voi vastata jaettuun lähettäjänimeen SMSinfo, eivätkä volain puhenumerot vastaanota tekstiviestejä (tekstiviestien vastaanoton ja lähetyksen omasta numerosta hoitavat lisäpalvelut matkapuhelinnumero ja numero puheluille ja tekstiviesteille, katso osio Matkapuhelinnumerot ja osio numero puheluille ja tekstiviesteille API-dokumentaatiossa):
curl -X POST https://volai.cz/v1/messages \
-H "Authorization: Bearer vk_YOUR_KEY" \
-H "Idempotency-Key: REPLACE_WITH_UNIQUE_SMS_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{"to": "+420777123456", "body": "Terveisiä volaista! - Sovellukseni"}'{
"id": "msg_7c1f9a2e",
"status": "sent",
"priceHal": 136,
"segments": 1
}Allekirjoita viestin tekstissä
Tekstiviesti tulee jaetulta lähettäjältä (SMSinfo), ei sovelluksesi nimestä - se on tšekkiläisten operaattorien rajoitus, ei volain. Kirjoita siksi identiteetti suoraan tekstiin, kuten esimerkissä (- Sovellukseni).
Valinnainen: hanki numero saapuville puheluille
Ensin numero vapaasta varastosta - tyhjä body {} antaa sinulle numeron oletustarjonnasta Praha. Tiettyä tarjontaa varten käytä region-kenttää tai valitse e164 kutsulla GET /v1/numbers/available. Osto veloittaa heti ensimmäisen jakson maksun:
curl -X POST https://volai.cz/v1/numbers \
-H "Authorization: Bearer vk_YOUR_KEY" \
-H "Idempotency-Key: REPLACE_WITH_UNIQUE_NUMBER_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{}'{
"number": {
"e164": "+420210123456",
"routing": { "mode": "none", "hasSipPassword": false },
"monthlyFeeHal": 2500,
"boughtAt": 1756111640000,
"region": "praha",
"regionLabel": "Prague",
"billingMonths": 1
}
}Kytke nyt numeroon agentti - riittää nimi, järjestelmäkehote ja edellisen vaiheen numero:
curl -X POST https://volai.cz/v1/agents \
-H "Authorization: Bearer vk_YOUR_KEY" \
-H "Idempotency-Key: REPLACE_WITH_UNIQUE_AGENT_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"name": "Vastaanottovirkailija",
"systemPrompt": "Olet kahvila Nulan vastaanottovirkailija. Otat vastaan noutotilauksia ja vastaat aukioloaikoja koskeviin kysymyksiin (8-18, ma-pe). Älä koskaan keksi hintoja, joita et tunne. Päätä puhelu tilauksen yhteenvetoon.",
"numberE164": "+420210123456"
}'{
"id": "ag_kx91fa2b"
}Siinä kaikki - soita uuteen numeroosi. Agentin pitäisi vastata muutaman sekunnin kuluessa ja puhua juuri niin kuin kirjoitit kohtaan systemPrompt.
Hyvä järjestelmäkehote ratkaisee, kuulostaako agentti ammattilaiselta vai haparoivalta robotilta. Kolme valmista kopioitavaa pohjaa on sivulla Puheagentti.
Toimintokartta
Yleiskatsaus alueisiin ja saatavilla oleviin toimintoihin. REST:lle ja MCP:lle ilmoitetaan niiden tukemien toimintojen määrä, jonka kukin rajapinta tarjoaa. Tarkoitukselliset poikkeukset, esimerkiksi käyttöoikeuden luominen vain portaalissa, selitetään referenssissä.
Täydellinen luettelo on REST API -referenssissä ja työkaluluettelossa sivulla MCP .
Mitä seuraavaksi
MCP-palvelin
Yhdistä Claude Code, Codex CLI, Codex desktop, Cursor ja muut tekoälyeditorit.
REST API
Täydellinen kuvaus jokaisesta päätepisteestä: numerot, puhelut, tekstiviestit, tekstiviestien matkapuhelinnumerot, agentit ja niiden luonnokset, työkalut, tallenteet, webhookit, soittokieltolista, välitys, tili, tehtävät, saldo, asiakirjat, kalenterit ja integraatiot.
Puheagentti
Järjestelmäkehote, työkalut, siirto ihmiselle, tallenteet ja jäsennelty puhelutieto.
Webhookit
Tapahtumat, rakenteinen data viestin rungossa, allekirjoituksen tarkistus, uudelleenyritykset virhetilanteessa.
SIP
Oma ohjelmistopuhelin, SIP-tunnukset ja lähtevät puhelut SIP-asiakasohjelmalla.
Tuo oma agenttisi
Yhdistä kolmannen osapuolen alusta (ElevenLabs, Asterisk...) ilman agenttilisää.
Yhteydet
Google- ja Apple-kalenteri: yhdistä tili, lue ja vahvista tapahtumapäivityksiä.
Laskut
Fakturoid ja ABRA Flexi: lähetettyjen laskujen lukeminen maksutodisteena ja muistutuspuhelut Tehtävien kautta.
Tehtävät
Lähtevät kampanjat: luonti, vastaanottajien CSV-tuonti, käynnistys, keskeytys ja täsmäytys, budjetti ja soittoikkuna.
Avaimet käteen
Avustettu käyttöönotto: volain perustaja rakentaa agenttisi käsin kiinteään luettelohintaan, valmiina 24 tunnissa.
Saldo
Saldo, riittävyys, tapahtumahistoria, korttilataukset, automaattinen lataus ja verotositteet.