Siirry sisältöön

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 ilmaiseksi

2Avaa 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 yhteys

3Yhdistä - 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):

bash
claude mcp add --transport http --scope user volai 'https://volai.cz/mcp'
claude mcp login volai

Vahvista 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.

text
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ä:

bash
curl https://volai.cz/v1/balance \
  -H "Authorization: Bearer vk_YOUR_KEY"
json
{
  "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 verkossa

Korvaa 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.

bash
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."
  }'
json
{
  "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):

bash
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"}'
json
{
  "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:

bash
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 '{}'
json
{
  "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:

bash
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"
  }'
json
{
  "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ä.

Tili
Toiminnot9
REST6/6
MCP5/5
Toiminnot3
REST3/3
MCP1/1
Toiminnot2
REST2/2
MCP2/2
Toiminnot7
REST7/7
MCP7/7
Saldo
Toiminnot1
REST1/1
MCP1/1
Numerot
Toiminnot25
REST25/25
MCP21/21
Tekstiviesti
Toiminnot6
REST6/6
MCP4/4
Puhelut
Toiminnot14
REST12/12
MCP9/9
Kampanjabudjetit
Toiminnot3
REST3/3
MCP3/3
Äänet
Toiminnot1
REST1/1
MCP1/1
Toiminnot9
REST8/8
MCP8/8
Toiminnot8
REST8/8
MCP7/7
Työkalut
Toiminnot6
REST6/6
MCP5/5
Toiminnot10
REST10/10
MCP5/5
Välitys
Toiminnot3
REST3/3
MCP3/3
Soittokieltolista
Toiminnot4
REST4/4
MCP4/4
Muutosloki
Toiminnot1
REST1/1
MCP1/1
Toiminnot15
REST15/15
MCP8/8
Toiminnot15
REST15/15
MCP11/11
Toiminnot7
REST7/7
MCP7/7
Toiminnot3
REST3/3
MCP2/2

Täydellinen luettelo on REST API -referenssissä ja työkaluluettelossa sivulla MCP .