Siirry sisältöön

ElevenLabs-agentti tšekkiläisellä numerolla SIP:n kautta

2. syyskuuta 2026 · lukuaika 7 min

Onko valmis ElevenLabs Conversational AI -agentti, joka tarvitsee tšekkiläisen puhelinnumeron? Yhdistäminen ei ole mustaa magiaa - kyse on vain siitä, että volai-numero kytketään agenttialustan SIP-trunkkiin. Saapuvat puhelut hoituvat yhdellä PATCH-pyynnöllä reititykseen. Lähtevät puhelut toimivat hieman eri tavalla, koska ElevenLabs (kuten useimmat tekoälypuhealustat) ei voi rekisteröidä puhelinlinjaa pysyvästi SIP-asiakkaaksi - alusta lähettää vain yhden todennetun puhelun, ja siksi se ohjataan lyhytikäisen relay-yhteyden kautta. Ja suuri ero volain sisäänrakennettuun agenttiin: lähtevissä puheluissa ei makseta agenttilisää (0,105 €/min) lainkaan - agentti pyörii (ja maksetaan) omassa ElevenLabs-työtilassa.

Milloin oma agentti on parempi kuin sisäänrakennettu?

Molemmat toimivat samalla volai-numerolla ja veloittavat samaa saldoa - ero on siinä, kuka hoitaa puhelun ja mitä se maksaa lisää:

KriteeriSisäänrakennettu volai-agenttiOma agentti (ElevenLabs ym.)
Kuka ohjaa puheluaMe - systemPrompt, ääni, yksi ElevenLabs-työtila.Sinä itse - mikä tahansa alusta, oma prompt, oma ääni, omat työkalut.
Puhelun hinta0,0384 €/min lähtevä, 0,0209 €/min saapuvasama - 0,0384 €/min lähtevä, 0,0209 €/min saapuva
Agenttilisä+ 0,105 €/minei lisää - maksetaan vain puheluminuutit
Litterointi, yhteenveto, vastaajan tunnistusKyllä, automaattisesti jokaisesta puhelusta.Ei - hoitaa (tai ei hoida) oma alusta.

Agenttilisästä pääsee volaissa eroon, mutta ilmaista se ei ole - oma alusta (ElevenLabs Conversational AI ja vastaavat) maksetaan erikseen sen oman hinnaston mukaan. Me veloitamme vain puheluminuutit volai-linjalla, aivan kuten SIP-asiakkaista tai sisäänrakennetusta agentista. Hinnat ilmoitetaan ilman ALV:tä, kuten koko volain hinnasto.

Toisin sanoen: oma agentti kannattaa, kun ElevenLabs-agentti omalla kehotteella, omilla työkaluilla ja omalla äänellä on jo käynnissä ja tarvitsee vain tšekkiläisen numeron. Alusta aloittava, joka tyytyy yhteen järjestelmäkehotteeseen ilman omaa ElevenLabs-hallintaa, pääsee nopeammin perille sisäänrakennetulla volai-agentilla - se luodaan yhdellä API-kutsulla, ja litterointi yhteenvetoineen tulee automaattisesti.

Mitä tarvitaan?

  • volai-tili, jossa on ostettu tšekkiläinen numero ja API-avain (vk_...) - se löytyy portaalista kohdasta Käyttöoikeus ja API.
  • Valmis ElevenLabs Conversational AI -agentti OMASSA työtilassa - tämä opas ei luo agenttia, se vain kytkee agentin numeroon.
  • Saldoa volai-tilillä - puhelut veloitetaan siitä samalla tavalla kuin sisäänrakennetulla agentilla.

Vaihe 1: Kytke saapuvat puhelut

Aseta numeron reititykseksi mode: "sip" ja anna kentän sipUri arvoksi SIP-osoite, johon ElevenLabsin on määrä vastaanottaa puhelut SIP-trunkin tuonnin yhteydessä:

bash
curl -X PATCH "https://volai.cz/v1/numbers/+420601234567" \
  -H "Authorization: Bearer vk_AVAIMESI" \
  -H "Content-Type: application/json" \
  -d '{"routing": {"mode": "sip", "sipUri": "sip:+420601234567@sip.rtc.elevenlabs.io"}}'

Sen jälkeen numero rekisteröidään ElevenLabs-tilillä (Settings → Phone Numbers → Import → SIP trunk) asetuksella inbound_trunk_config:

json
{
  "provider": "sip_trunk",
  "phone_number": "+420601234567",
  "label": "Oma agenttini",
  "inbound_trunk_config": {
    "allowed_addresses": ["81.31.45.0/24"],
    "media_encryption": "allowed"
  }
}

Veloitetaan vain saapuva minuutti (0,0209 €/min), ilman ylimääräistä agenttilisää - sama sääntö kuin sisäänrakennetulla agentilla tai tavallisella softphonella.

Vaihe 2: Kytke lähtevät puhelut relayn kautta

Tämä suunta on päinvastainen - agentti soittaa itse ulos. Puhelinverkko ei kuitenkaan päästä vieraaseen SIP-osoitteeseen perustuvaa puhelua suoraan kohdenumeroon, joten puhelu ohjataan lyhytikäisen relay-yhteyden kautta: kertakäyttöinen SIP-paikka, jonka volai luo juuri ennen puhelua ja joka poistuu itsestään puhelun päätyttyä. Yksityiskohtainen mekanismi (miksi se on näin ja miltä se näyttää muilla alustoilla kuin ElevenLabsilla) löytyy sivulta Oma agentti - tässä vain kolme vaihetta, jotka on tehtävä.

2.1 Määritä ElevenLabs omaan linjaan

Pyydä numeron SIP-tunnukset:

bash
curl "https://volai.cz/v1/numbers/+420601234567/sip" \
  -H "Authorization: Bearer vk_AVAIMESI"
json
{
  "server": "sip.volai.cz",
  "username": "123456",
  "password": "a1b2c3d4e5f6",
  "outboundTrunkAddress": "sip.volai.cz",
  "port": 5060,
  "transport": "tcp",
  "inboundSignallingCidrs": ["81.31.45.0/24"]
}

Kenttää server käytetään tavallisessa softphonessa (ks. SIP-sivu), mutta ElevenLabsissa on käytettävä kenttää outboundTrunkAddress (sip.volai.cz), ei kenttää server - sekaannus aiheuttaa virheen 1011 sip request timed out - lähtevän trunkin osoitteen on oltava täsmälleen tämä arvo, muuten puhelua ei reititetä verkossa.

Anna se asetuksena outbound_trunk_config numerolle ElevenLabsissa (Settings → Phone Numbers → numero → Outbound calling), täsmälleen tässä muodossa:

json
{
  "outbound_trunk_config": {
    "address": "sip.volai.cz",
    "transport": "tcp",
    "media_encryption": "allowed",
    "credentials": {
      "username": "123456",
      "password": "a1b2c3d4e5f6"
    }
  }
}

2.2 Luo relay-yhteys

Juuri ennen puhelua (yhteys elää vain lyhyen hetken, rajat ovat alla) kutsutaan:

bash
curl -X POST https://volai.cz/v1/relay \
  -H "Authorization: Bearer vk_AVAIMESI" \
  -H "Content-Type: application/json" \
  -d '{"to": "+420777123456", "from": "+420601234567"}'
json
{
  "id": "rl_4f2a91cd",
  "sipName": "volai_relay_2",
  "sipUri": "sip:volai_relay_2@sip.volai.cz",
  "expiresAt": 1756111760000,
  "callId": "c_9d4e2b7f"
}

2.3 Anna agentille sipName, ei koko SIP-URI:a

Paljas nimi, ei koko SIP-URI:a

ElevenLabs hylkää koko SIP-URI:n viestillä ”SipCallTo should be a phone number or SIP user, not a full SIP URI” - siksi yllä oleva vastaus antaa kentät sipName (paljas volai_relay_2) ja sipUri (koko sip:volai_relay_2@sip.volai.cz) ERIKSEEN. Kenttään to_number kuuluu vain sipName.

ElevenLabsin kannalta tämä tarkoittaa, että kutsu kulkee osoitteen /v1/convai/sip-trunk/outbound-call kautta ja kenttä to_number asetetaan suoraan arvoon sipName:

json
{
  "agent_id": "agent_...",
  "agent_phone_number_id": "phnum_...",
  "to_number": "volai_relay_2"
}

Mitä kutsun jälkeen tapahtuu

Puhelinverkko vastaanottaa puhelun nimellä volai_relay_2, yhdistää sen edelleen numeroon to ja asettaa näkyväksi soittajan numeroksi arvon from - soitettava näkee näytöllä volai-linjan, ei relay-paikan sisäistä nimeä (jos numerolla on omat relay-nimet - muuten soitettava näkee volain demonumeron, ota silloin yhteyttä tukeen). Kun puhelu päättyy, lease vapautuu ja minuutit veloitetaan tavallisena lähtevänä puheluna - 0,0384 €/min, ilman agenttilisää.

Rajat ja turvallisuus

MikäArvo
Ensimmäistä puhelua odottava lease (pending)oletuksena 120 s, 15-300 s
Puhelu käynnissä (active)enintään 15 minuuttia
Aktiivinen lease omaa numeroa kohdenenintään 1
Aktiivisia leaseja tiliä kohdenenintään 2
  • from on oltava oma volai-numero - muuten from_number_not_owned. Ilman tätä tarkistusta voisi esiintyä vieraana linjana.
  • Samat esteet kuin tavallisessa puhelussa - soittokieltolista (vain puheluille, ei tekstiviesteille), automaattinen 30 päivän esto kolmen epäonnistuneen yrityksen jälkeen samaan numeroon 24 tunnin sisällä ja puheluiden yleinen rate limit. Relay ei ohita mitään näistä.
  • Lease on kertakäyttöinen - toinen puhelu samalla leasella hylätään, luo uusi seuraavaa puhelua varten.
  • Täysi relay-paikkojen pooli antaa virheen 503 capacity_busy - se on jaettu samanaikaisuuden katto KOKO volai-alustalle, ei vain omalle tilille. Mitään ei veloiteta, riittää yrittää hetken kuluttua uudelleen.

Täydellinen REST-viite (virhekoodit, GET/DELETE leaseille) löytyy REST API -viitteestä, koko läpikäynti - sekä saapuvat että lähtevät puhelut mille tahansa alustalle, ei vain ElevenLabsille - on sivulla Oma agentti.

Milloin kannattaa pysyä sisäänrakennetussa agentissa?

Rehellisesti sanottuna: oma agentti tarkoittaa enemmän liikkuvia osia - erillinen ElevenLabs-tili ja erillinen lasku, ei automaattista litterointia tai yhteenvetoa suoraan volai-portaalissa ja yksi lisävaihe ennen jokaista lähtevää puhelua (relay-leasen luominen). Jos yksi hyvä järjestelmäkehote riittää ja tavoitteena on olla valmis muutamassa minuutissa ilman toista tiliä toisella alustalla, sisäänrakennettu volai-agentti hoitaa saman yhdellä API-kutsulla - ja agenttilisä (0,105 €/min) tuo vastineeksi automaattisen litteroinnin, yhteenvedon ja vastaajan tunnistuksen jokaiseen puheluun.

Täydellinen hintavertailu Twilioon ja muihin palveluntarjoajiin löytyy hinnastosta, ja ElevenLabs-integraatio vaihe vaiheelta, linkkeineen heidän omaan dokumentaatioonsa, on sivulla Integraatiot.

Kokeile volaita - ensimmäiset 2 € saat meiltä

Tili luodaan minuutissa, ja aloitussaldo puheluihin ja yhteen numeroon on heti käytettävissä - tekstiviestejä voi lähettää ensimmäisen latauksen jälkeen.

Kokeile ilmaiseksi