ElevenLabs agent na českom čísle cez SIP

Už máte hotového ElevenLabs Conversational AI agenta a chcete mu pridať české telefónne číslo? Prepojenie nie je žiadna čierna mágia - ide len o to, napojiť číslo volai na SIP trunk vašej agentskej platformy. Prichádzajúce hovory zvládnete jednou PATCH požiadavkou na smerovanie. Odchádzajúce je to trochu inak, pretože ElevenLabs (rovnako ako väčšina hlasových AI platforiem) nevie telefónnu linku trvalo zaregistrovať ako SIP klienta - len odošle jeden autentizovaný hovor, a preto sa vedie cez krátko trvajúce relay spojenie. A hlavný rozdiel oproti zabudovanému agentovi volai: pri odchádzajúcich hovoroch agentskú prirážku 2,50 kr/min (≈ 0,10 EUR) vôbec neplatíte - agenta prevádzkujete (a platíte) vo vlastnom ElevenLabs workspace.

Kedy dáva zmysel vlastný agent namiesto zabudovaného?

Oboje pobeží na rovnakom čísle volai a čerpá rovnaký kredit - rozdiel je v tom, kto za vás hovorí a čo si za to priplatíte:

Inak povedané: vlastný agent sa oplatí, keď už máte rozbehnutého ElevenLabs agenta s vlastným promptom, nástrojmi a hlasom a chcete mu len pridať české číslo. Keď začínate od nuly a stačí vám jeden systémový prompt bez vlastnej ElevenLabs administrácie, rýchlejšia cesta je zabudovaný agent volai - založíte ho jedným volaním API a prepis so zhrnutím dostanete automaticky.

Čo budete potrebovať?

• Účet volai s kúpeným českým číslom a API kľúčom (vk_...) - nájdete ho v portáli v sekcii API a MCP.
• Hotový ElevenLabs Conversational AI agent vo VLASTNOM workspace - tento návod ho nezakladá, len ho napája na číslo.
• Kredit na účte volai - hovory sa z neho strhávajú rovnako ako pri zabudovanom agentovi.

Krok 1: Napojte prichádzajúce hovory

Nastavte smerovanie čísla na mode: "sip" a ako sipUri zadajte SIP adresu, na ktorej má ElevenLabs pri importe SIP trunku prijímať hovory:

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

Na účte ElevenLabs potom (Settings → Phone Numbers → Import → SIP trunk) číslo zaregistrujete s inbound_trunk_config:

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

Účtuje sa len prichádzajúca minúta (0,50 kr/min (≈ 0,02 EUR)), žiadny agent navyše - rovnaké pravidlo ako pri zabudovanom agentovi alebo bežnom softvérovom telefóne.

Krok 2: Napojte odchádzajúce hovory cez relay

Tento smer je opačný - agent sám vytáča von. Telefónna sieť však hovor s cudzou SIP adresou nepustí priamo na cieľové číslo, takže sa vedie cez krátko trvajúce relay spojenie: jednorazový SIP slot, ktorý volai založí tesne pred hovorom a po jeho skončení sám zruší. Podrobnú mechaniku (prečo to tak je aj ako to vyzerá pri iných platformách než ElevenLabs) nájdete na stránke Vlastný agent - tu len tri kroky, ktoré musíte urobiť.

2.1 Nastavte ElevenLabs na svoju linku

Vyžiadajte si SIP údaje čísla:

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

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

Pole server použijete pre obyčajný softvérový telefón (pozrite stránku SIP), ale do ElevenLabs patrí pole outboundTrunkAddress (sip.volai.cz), nie server - zámena skončí chybou 1011 sip request timed out - adresa odchádzajúceho trunku musí byť presne táto hodnota, inak sa hovor v sieti nesmeruje.

Nastavte ju ako outbound_trunk_config daného čísla v ElevenLabs (Settings → Phone Numbers → vaše číslo → Outbound calling), presne takto:

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

2.2 Vytvorte relay spojenie

Tesne pred hovorom (spojenie žije len krátko, limity sú nižšie) zavolajte:

curl -X POST https://volai.cz/v1/relay \
  -H "Authorization: Bearer vk_VAS_KLUC" \
  -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 Agentovi povedzte sipName, nie celé SIP URI

Pri ElevenLabs to znamená zavolať cez /v1/convai/sip-trunk/outbound-call s to_number nastaveným rovno na sipName:

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

Čo sa stane po zavolaní

Telefónna sieť hovor prijme na mene volai_relay_2, prepojí ho na vaše to a nastaví viditeľné číslo volajúceho na vaše from - volaný na displeji uvidí vašu linku volai, nie interné meno relay slotu (ak má číslo vlastné relay mená - inak volaný uvidí demo číslo volai, napíšte na podporu). Keď hovor skončí, lease sa uvoľní a minúty sa naúčtujú ako bežný odchádzajúci hovor - 0,92 kr/min (≈ 0,04 EUR), žiadna agentská prirážka.

Limity a zabezpečenie

• from musí byť vaše vlastné číslo volai - inak from_number_not_owned. Bez tejto kontroly by sa dalo vydávať za cudziu linku.
• Rovnaké brány ako bežný hovor - zoznam nevolať (len pre hovory, nie pre SMS), automatická 30-dňová blokácia po troch neúspešných pokusoch na to isté číslo za 24 hodín a všeobecný rate limit hovorov. Relay nič z toho neobíde.
• Lease je jednorazový - druhý hovor na ten istý lease sa odmietne, na ďalší si vytvorte nový.
• Plný pool relay slotov vráti 503 capacity_busy - je to zdieľaný strop súbežnosti CELEJ platformy volai, nielen vášho účtu. Nič sa pritom neúčtuje, stačí to o chvíľu skúsiť znova.

Kompletnú REST referenciu (chybové kódy, GET/DELETE nad leasmi) nájdete v referencii REST API, celé znenie postupu - vrátane prichádzajúcich aj odchádzajúcich hovorov na ľubovoľnú platformu, nielen ElevenLabs - je na stránke Vlastný agent.

Kedy zostať pri zabudovanom agentovi?

Úprimne: vlastný agent znamená viac pohyblivých častí - samostatný účet ElevenLabs a fakturáciu, žiadny automatický prepis ani zhrnutie priamo v portáli volai a jeden krok navyše pred každým odchádzajúcim hovorom (založiť relay lease). Ak vám stačí jeden dobrý systémový prompt a chcete mať hotovo za pár minút bez druhého účtu u inej platformy, zabudovaný agent volai zvládne to isté jedným volaním API - a agentskú prirážku 2,50 kr/min (≈ 0,10 EUR) dostanete späť v podobe automatického prepisu, zhrnutia a detekcie odkazovača pri každom hovore.

Úplné porovnanie cien s Twiliom a ďalšími poskytovateľmi nájdete v cenníku, integráciu ElevenLabs krok za krokom aj s odkazmi na ich vlastnú dokumentáciu má stránka Integrácie.

Čo ďalej