Agent ElevenLabs na češki številki prek SIP

Že imate pripravljenega agenta ElevenLabs Conversational AI in mu želite dodati češko telefonsko številko? Povezava ni nobena črna magija - gre le za to, da številko volai priklopite na SIP trunk svoje agentske platforme. Dohodne klice uredite z enim zahtevkom PATCH za usmerjanje. Pri odhodnih je malo drugače, ker ElevenLabs (kot večina glasovnih platform z umetno inteligenco) telefonske linije ne zna trajno registrirati kot odjemalca SIP - odda le en overjen klic, zato se vodi prek kratkotrajne povezave relay. In glavna razlika v primerjavi z vgrajenim agentom volai: pri odhodnih klicih agentskega pribitka 2,50 kr/min (≈ 0,10 EUR) sploh ne plačujete - agenta upravljate (in plačujete) v lastnem delovnem prostoru ElevenLabs.

Kdaj je lasten agent smiselnejši od vgrajenega?

Oboje bo delovalo na isti številki volai in porablja isto dobroimetje - razlika je v tem, kdo govori namesto vas in kaj za to doplačate:

Z drugimi besedami: lasten agent se splača, kadar že imate delujočega agenta ElevenLabs z lastnim ukazom, orodji in glasom in mu želite le dodati češko številko. Kadar začenjate z nič in vam zadošča en sistemski ukaz brez lastne administracije ElevenLabs, je hitrejša pot vgrajeni agent volai - ustvarite ga z enim klicem API, prepis s povzetkom pa dobite samodejno.

Kaj boste potrebovali?

• Račun volai s kupljeno češko številko in ključem API (vk_...) - najdete ga v portalu v razdelku API in MCP.
• Pripravljenega agenta ElevenLabs Conversational AI v LASTNEM delovnem prostoru - ta vodnik ga ne ustvarja, le priklaplja na številko.
• Dobroimetje na računu volai - klici se od njega odštevajo enako kot pri vgrajenem agentu.

Korak 1: Priklopite dohodne klice

Usmerjanje številke nastavite na mode: "sip" in kot sipUri vnesite naslov SIP, na katerem naj ElevenLabs ob uvozu SIP trunka sprejema klice:

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

V računu ElevenLabs nato (Settings → Phone Numbers → Import → SIP trunk) številko registrirate z inbound_trunk_config:

{
  "provider": "sip_trunk",
  "phone_number": "+420601234567",
  "label": "Moj lastni agent",
  "inbound_trunk_config": {
    "allowed_addresses": ["81.31.45.0/24"],
    "media_encryption": "allowed"
  }
}

Zaračuna se le dohodna minuta (0,50 kr/min (≈ 0,02 EUR)), brez dodatnega agenta - enako pravilo kot pri vgrajenem agentu ali navadnem programskem telefonu.

Korak 2: Priklopite odhodne klice prek relaya

Ta smer je obratna - agent sam kliče navzven. Telefonsko omrežje pa klica s tujim naslovom SIP ne spusti neposredno na ciljno številko, zato se vodi prek kratkotrajne povezave relay: enkratne reže SIP, ki jo volai ustvari tik pred klicem in jo po koncu sam odpravi. Podroben mehanizem (zakaj je tako in kako izgleda pri drugih platformah kot ElevenLabs) najdete na strani Lastni agent - tu le trije koraki, ki jih morate narediti.

2.1 Nastavite ElevenLabs na svojo linijo

Zahtevajte podatke SIP za številko:

curl "https://volai.cz/v1/numbers/+420601234567/sip" \
  -H "Authorization: Bearer vk_VAS_KLJUC"

{
  "server": "sip.volai.cz",
  "username": "123456",
  "password": "a1b2c3d4e5f6",
  "outboundTrunkAddress": "sip.volai.cz",
  "port": 5060,
  "transport": "tcp",
  "inboundSignallingCidrs": ["81.31.45.0/24"]
}

Polje server uporabite za navaden programski telefon (glejte stran SIP), v ElevenLabs pa sodi polje outboundTrunkAddress (sip.volai.cz), ne server - zamenjava se konča z napako 1011 sip request timed out - naslov odhodnega trunka mora biti natanko ta vrednost, sicer se klic v omrežju ne usmeri.

Nastavite ga kot outbound_trunk_config te številke v ElevenLabs (Settings → Phone Numbers → vaša številka → Outbound calling), natanko takole:

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

2.2 Ustvarite povezavo relay

Tik pred klicem (povezava živi le kratko, omejitve so nižje) pokličite:

curl -X POST https://volai.cz/v1/relay \
  -H "Authorization: Bearer vk_VAS_KLJUC" \
  -H "Content-Type: application/json" \
  -d '{"to": "+420777123456", "from": "+420601234567"}'

{
  "id": "rl_4f2a91cd",
  "sipName": "volai_relay_2",
  "sipUri": "sip:volai_relay_2@sip.volai.cz",
  "expiresAt": 1756111760000,
  "callId": "c_9d4e2b7f"
}

2.3 Agentu povejte sipName, ne celotnega SIP URI

Pri ElevenLabs to pomeni klic prek /v1/convai/sip-trunk/outbound-call z to_number nastavljenim kar na sipName:

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

Kaj se zgodi po klicu

Telefonsko omrežje klic sprejme na imenu volai_relay_2, ga poveže na vaš to in vidno številko klicatelja nastavi na vaš from - poklicani na zaslonu vidi vašo linijo volai, ne internega imena reže relay (če ima številka lastna imena relay - sicer poklicani vidi predstavitveno številko volai, pišite podpori). Ko se klic konča, se lease sprosti in minute se zaračunajo kot navaden odhodni klic - 0,92 kr/min (≈ 0,04 EUR), brez agentskega pribitka.

Omejitve in varnost

• from mora biti vaša lastna številka volai - sicer from_number_not_owned. Brez tega preverjanja bi se bilo mogoče izdajati za tujo linijo.
• Enaka vrata kot pri navadnem klicu - seznam prepovedanih klicev (samo za klice, ne za SMS), samodejna 30-dnevna blokada po treh neuspelih poskusih na isto številko v 24 urah in splošna omejitev hitrosti klicev. Relay nič od tega ne zaobide.
• Lease je enkraten - drugi klic na isti lease se zavrne, za naslednjega ustvarite novega.
• Poln pool rež relay vrne 503 capacity_busy - to je skupna zgornja meja sočasnosti CELOTNE platforme volai, ne le vašega računa. Pri tem se nič ne zaračuna, zadošča, da čez čas poskusite znova.

Celotno referenco REST (kode napak, GET/DELETE nad leasi) najdete v referenci REST API, celoten postopek - vključno z dohodnimi in odhodnimi klici na katero koli platformo, ne le ElevenLabs - pa na strani Lastni agent.

Kdaj ostati pri vgrajenem agentu?

Iskreno: lasten agent pomeni več gibljivih delov - ločen račun ElevenLabs in obračunavanje, nobenega samodejnega prepisa ali povzetka neposredno v portalu volai in en korak več pred vsakim odhodnim klicem (ustvariti relay lease). Če vam zadošča en dober sistemski ukaz in želite biti gotovi v nekaj minutah brez drugega računa pri drugi platformi, vgrajeni agent volai zmore isto z enim klicem API - agentski pribitek 2,50 kr/min (≈ 0,10 EUR) pa dobite nazaj v obliki samodejnega prepisa, povzetka in zaznave odzivnika pri vsakem klicu.

Popolno primerjavo cen s Twiliom in drugimi ponudniki najdete v ceniku, integracijo ElevenLabs korak za korakom in s povezavami na njihovo dokumentacijo pa ima stran Integracije.

Kaj naprej