Agent ElevenLabs na czeskim numerze przez SIP

Mają już Państwo własnego agenta ElevenLabs Conversational AI i chcą nadać mu czeski numer telefonu? Nie ma w tym żadnej sztuczki: numer volai kieruje się na SIP trunk platformy agenta. Połączenia przychodzące to najprostsza część - jedno zapytanie PATCH na routing numeru. Połączenia wychodzące działają nieco inaczej, ponieważ ElevenLabs (jak większość platform głosowych AI) nie potrafi trwale zarejestrować linii telefonicznej jako klienta SIP - wysyła tylko pojedyncze, uwierzytelnione połączenie, dlatego idzie ono przez krótkotrwałe połączenie relay. Wielka różnica wobec wbudowanego agenta volai: przy połączeniach wychodzących w ogóle nie płacą Państwo dopłaty za agenta w wysokości 2,50 kr/min (≈ 0,45 PLN) - agenta prowadzą (i opłacają) Państwo sami, we własnym workspace ElevenLabs.

Kiedy własny agent ma więcej sensu niż wbudowany?

Obie drogi rozliczają się z tego samego numeru volai i tego samego salda - zmienia się to, kto prowadzi rozmowę i ile kosztuje ponad stawkę podstawową:

Innymi słowy: własny agent opłaca się, gdy mają już Państwo działającego agenta ElevenLabs z własnym promptem, narzędziami i głosem i brakuje im tylko czeskiego numeru. Zaczynają Państwo od zera, wystarcza jeden prompt systemowy i nie chcą zarządzać osobnym workspace ElevenLabs? Szybsza droga to wbudowany agent volai - jedno wywołanie API go uruchamia, a transkrypcja i podsumowanie są w cenie dopłaty za agenta, bez osobnej konfiguracji.

Czego będą Państwo potrzebować?

• Konta volai z czeskim numerem oraz klucza API (vk_...) - klucz znajdą Państwo w portalu, w sekcji API i MCP.
• Agenta ElevenLabs Conversational AI, zbudowanego już we WŁASNYM workspace - ten przewodnik podłącza go do numeru, agenta za Państwa nie buduje.
• Salda na koncie volai - połączenia obciążają je dokładnie tak samo jak przy wbudowanym agencie.

Krok 1: Podłączenie połączeń przychodzących

Routing numeru ustawiają Państwo na mode: "sip", a w polu sipUri wpisują adres, pod którym ElevenLabs przyjmuje połączenia przy imporcie trunku SIP:

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

Następnie po stronie ElevenLabs (Settings → Phone Numbers → Import → SIP trunk) rejestrują Państwo numer z inbound_trunk_config:

{
  "provider": "sip_trunk",
  "phone_number": "+420601234567",
  "label": "Mój własny agent",
  "inbound_trunk_config": {
    "allowed_addresses": ["81.31.45.0/24"],
    "media_encryption": "allowed"
  }
}

Rozliczana jest wyłącznie minuta połączenia przychodzącego (0,50 kr/min (≈ 0,09 PLN)), bez żadnej dopłaty - ta sama zasada obowiązuje wbudowanego agenta i zwykły softphone.

Krok 2: Podłączenie połączeń wychodzących przez relay

Ten kierunek działa odwrotnie - Państwa agent dzwoni sam. Sieć telefoniczna nie przekaże połączenia z obcego adresu SIP prosto na numer docelowy, więc idzie ono przez krótkotrwały relay - jednorazowy slot SIP, który volai otwiera tuż przed połączeniem i zamyka po jego zakończeniu. Pełną mechanikę i przebieg dla platform innych niż ElevenLabs opisuje strona Własny agent - tutaj tylko trzy potrzebne kroki:

2.1 Wskazanie ElevenLabs Państwa linii

Pobierają Państwo dane SIP numeru:

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

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

Pole server jest przeznaczone dla zwykłego softphone'a (zob. stronę SIP), ale ElevenLabs potrzebuje pola outboundTrunkAddress (sip.volai.cz), a nie server - podmiana kończy się błędem 1011 sip request timed out - adres trunku wychodzącego musi mieć dokładnie tę wartość, w przeciwnym razie połączenie nie zostanie skierowane w sieci.

Następnie ustawiają Państwo go jako outbound_trunk_config tego numeru w ElevenLabs (Settings → Phone Numbers → Państwa numer → Outbound calling), dokładnie w takim kształcie:

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

2.2 Otwarcie połączenia relay

Tuż przed wykonaniem połączenia - relay jest krótkotrwały, zob. ograniczenia niżej - wywołują Państwo:

curl -X POST https://volai.cz/v1/relay \
  -H "Authorization: Bearer vk_TWOJ_KLUCZ" \
  -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 Agent ma wybierać sipName, a nie pełny SIP URI

W przypadku ElevenLabs oznacza to wywołanie /v1/convai/sip-trunk/outbound-call z to_number ustawionym bezpośrednio na sipName:

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

Co dzieje się po wyjściu połączenia

Po stronie sieci połączenie wychodzi pod nazwą volai_relay_2, jest przekazywane na Państwa to i jako numer dzwoniącego pokazuje Państwa numer from - kto odbierze, widzi na ekranie Państwa linię volai, a nigdy tymczasową nazwę slotu relay (tylko jeśli numer ma własne nazwy relay - w przeciwnym razie odbierający zobaczy numer demo volai; prosimy o kontakt z pomocą). Po zakończeniu rozmowy lease jest zwalniany automatycznie, a rozliczenie następuje według zwykłej stawki za połączenie wychodzące - 0,92 kr/min (≈ 0,16 PLN), bez doliczonej dopłaty za agenta.

Ograniczenia i bezpieczeństwo

• from musi być Państwa własnym numerem volai - w przeciwnym razie from_number_not_owned. Bez tej kontroli każdy mógłby podszyć się pod cudzą linię jako numer dzwoniącego.
• Te same bramki co przy zwykłym połączeniu - lista numerów, na które nie wolno dzwonić (dotyczy tylko połączeń, SMS-y są wyłączone), automatyczna 30-dniowa blokada po trzech nieudanych próbach na jeden numer w ciągu 24 godzin oraz standardowy limit zapytań dla połączeń. Żadnej z tych barier nie da się obejść przez relay.
• Lease jest jednorazowy - druga próba połączenia na tym samym lease zostanie odrzucona, więc do kolejnego połączenia trzeba otworzyć nowy.
• Pełna pula relay odpowiada 503 capacity_busy - to limit równoległości wspólny dla CAŁEJ platformy volai, a nie tylko Państwa konta. Nic wtedy nie jest rozliczane; wystarczy spróbować ponownie za chwilę.

Pełna dokumentacja REST (kody błędów, GET/DELETE na lease) znajduje się w dokumentacji REST API; kompletny opis - obejmujący połączenia przychodzące i wychodzące dla dowolnej platformy, nie tylko ElevenLabs - jest na stronie Własny agent.

Kiedy lepiej zostać przy wbudowanym agencie?

Mówiąc wprost: własny agent to więcej ruchomych części - osobne konto i rachunek w ElevenLabs, brak automatycznej transkrypcji i podsumowania w portalu volai oraz dodatkowy krok przed każdym połączeniem wychodzącym (otwarcie relay lease). Jeśli jeden solidny prompt systemowy wystarcza, a wolą Państwo skończyć w kilka minut, niż zarządzać drugim kontem na innej platformie, wbudowany agent volai załatwi to jednym wywołaniem API - a dopłata 2,50 kr/min (≈ 0,45 PLN) daje automatyczną transkrypcję, podsumowanie i wykrywanie poczty głosowej przy każdym połączeniu, bez dodatkowej konfiguracji.

Pełne porównanie cen z Twilio i innymi dostawcami znajdą Państwo w cenniku; integrację z ElevenLabs krok po kroku, z odnośnikami do ich własnej dokumentacji, opisuje strona Integracje.

Co dalej