ElevenLabs agent na českém telefonním čísle přes SIP

Máš hotového ElevenLabs Conversational AI agenta a chceš mu přidat české telefonní číslo? Napojení není žádná černá magie - jde jen o to, napojit číslo volai na SIP trunk tvé agentní platformy. Příchozí hovory zvládneš jedním PATCH požadavkem na směrování. Odchozí je to trochu jinak, protože ElevenLabs (stejně jako většina hlasových AI platforem) neumí telefonní linku trvale zaregistrovat jako SIP klienta - jen pošle jeden autentizovaný hovor, a proto se vede přes krátce trvající relay spojení. A hlavní rozdíl proti zabudovanému agentovi volai: u odchozích hovorů agentní přirážku 2,50 Kč/min vůbec neplatíš - agenta provozuješ (a platíš) ve vlastním ElevenLabs workspace.

Kdy dává smysl vlastní agent místo zabudovaného?

Obojí poběží na stejném volai čísle a čerpá stejný kredit - rozdíl je v tom, kdo mluví za tebe a co si za to připlatíš:

Jinak řečeno: vlastní agent se vyplatí, když už máš rozjetého ElevenLabs agenta s vlastním promptem, nástroji a hlasem a chceš mu jen přidat české číslo. Když začínáš od nuly a stačí ti jeden systémový prompt bez vlastní ElevenLabs administrace, rychlejší cesta je zabudovaný agent volai - založíš ho jedním voláním API a přepis se shrnutím dostaneš automaticky.

Co budeš potřebovat?

• Účet volai s koupeným českým číslem a API klíčem (vk_...) - najdeš ho v portálu v sekci API a MCP.
• Hotový ElevenLabs Conversational AI agent ve VLASTNÍM workspace - tenhle návod ho nezakládá, jen ho napojuje na číslo.
• Kredit na účtu volai - hovory se z něj strhávají stejně jako u zabudovaného agenta.

Krok 1: Napoj příchozí hovory

Nastav směrování čísla na mode: "sip" a jako sipUri zadej SIP adresu, na kterou má ElevenLabs pro import SIP trunku hovory přijímat:

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

Na ElevenLabs účtu pak (Settings → Phone Numbers → Import → SIP trunk) číslo zaregistruješ s inbound_trunk_config:

{
  "provider": "sip_trunk",
  "phone_number": "+420601234567",
  "label": "Muj vlastni agent",
  "inbound_trunk_config": {
    "allowed_addresses": ["0.0.0.0/0"],
    "media_encryption": "allowed"
  }
}

Účtuje se jen příchozí minuta (0,50 Kč/min), žádný agent navíc - stejné pravidlo jako u zabudovaného agenta nebo běžného softphonu.

Krok 2: Napoj odchozí hovory přes relay

Tenhle směr je opačný - agent sám vytáčí ven. Telefonní síť ale hovor s cizí SIP adresou nepustí rovnou na cílové číslo, takže se vede přes krátce trvající relay spojení: jednorázový SIP slot, který volai založí těsně před hovorem a po jeho konci sám zruší. Detailní mechaniku (proč to tak je, i jak to vypadá u jiných platforem než ElevenLabs) najdeš na stránce Vlastní agent - tady jen tři kroky, co musíš udělat.

2.1 Nastav ElevenLabs na svou linku

Vyzvedni si SIP údaje čísla:

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

{
  "server": "sip.volai.cz",
  "username": "123456",
  "password": "a1b2c3d4e5f6"
}

Stejné SIP údaje použiješ i pro obyčejný softphone, viz stránka SIP.

A nastav je jako outbound_trunk_config daného čísla na ElevenLabs (Settings → Phone Numbers → tvoje číslo → Outbound calling), přesně takhle:

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

2.2 Vytvoř relay spojení

Těsně před hovorem (spojení žije jen krátce, limity jsou níž) zavolej:

curl -X POST https://volai.cz/v1/relay \
  -H "Authorization: Bearer vk_TVUJ_KLIC" \
  -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 řekni sipName, ne celé SIP URI

U ElevenLabs to znamená zavolat přes /v1/convai/sip-trunk/outbound-call s to_number nastaveným rovnou na sipName:

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

Co se stane po zavolání

Telefonní síť hovor přijme na jméně volai_relay_2, přepojí ho na tvoje to a nastaví viditelné číslo volajícího na tvoje from - volaný na displeji uvidí tvoji linku volai, nikdy interní jméno relay slotu. Jakmile hovor skončí, lease se uvolní a minuty se naúčtují jako běžný odchozí hovor - 0,92 Kč/min, žádná agentní přirážka.

Limity a zabezpečení

• from musí být tvoje vlastní číslo volai - jinak from_number_not_owned. Bez týhle kontroly by šlo vydávat se za cizí linku.
• Stejné brány jako běžný hovor - seznam nevolat (jen pro hovory, ne pro SMS), automatická 30denní blokace po třech neúspěšných pokusech na stejné číslo za 24 hodin a obecný rate limit hovorů. Relay nic z tohohle neobejde.
• Lease je jednorázový - druhý hovor na týž lease se odmítne, na další si vytvoř nový.
• Plný pool relay slotů vrátí 503 capacity_busy - je to sdílený strop souběžnosti CELÉ platformy volai, ne jen tvého účtu. Nic se přitom neúčtuje, stačí to za chvíli zkusit znovu.

Kompletní REST referenci (chybové kódy, GET/DELETE nad leasy) najdeš v REST API referenci, celé znění postupu - včetně příchozích i odchozích hovorů na libovolnou platformu, ne jen ElevenLabs - je na stránce Vlastní agent.

Kdy zůstat u zabudovaného agenta?

Poctivě: vlastní agent znamená víc pohyblivých částí - samostatný ElevenLabs účet a fakturaci, žádný automatický přepis ani shrnutí přímo v portálu volai a jeden krok navíc před každým odchozím hovorem (založit relay lease). Pokud ti stačí jeden dobrý systémový prompt a chceš mít hotovo za pár minut bez druhého účtu u jiné platformy, zabudovaný agent volai zvládne totéž jedním voláním API - a agentní přirážku 2,50 Kč/min dostaneš zpátky v podobě automatického přepisu, shrnutí a detekce záznamníku u každého hovoru.

Úplné srovnání cen s Twiliem a dalšími poskytovateli najdeš na ceníku, integraci ElevenLabs krok za krokem i s odkazy na jejich vlastní dokumentaci má stránka Integrace.

Co dál