ElevenLabs-agent op een Tsjechisch nummer via SIP

Gebruikt u al een eigen ElevenLabs Conversational AI-agent en wilt u hem een Tsjechisch telefoonnummer geven? Daar is geen bijzondere truc voor nodig: u richt een volai-nummer op de SIP-trunk van uw agentplatform. Inkomend is het eenvoudige deel - één PATCH-verzoek op de routing van het nummer. Uitgaand werkt iets anders, omdat ElevenLabs (zoals de meeste AI-spraakplatforms) een telefoonlijn niet permanent als SIP-client geregistreerd kan houden - het verstuurt alleen één geauthenticeerd gesprek, dus het gesprek loopt in plaats daarvan via een kortstondige relayverbinding. Het grote verschil met de ingebouwde volai-agent: bij uitgaande gesprekken vervalt de agenttoeslag van 2,50 kr/min (≈ 0,10 EUR) volledig - u beheert (en betaalt) de agent zelf, in uw eigen ElevenLabs-workspace.

Wanneer is een eigen agent zinvoller dan de ingebouwde?

Beide routes lopen via hetzelfde volai-nummer en hetzelfde tegoed - wat verandert is wie het gesprek voert en wat dat er bovenop kost:

Anders gezegd: een eigen agent loont zodra u al een ElevenLabs-agent hebt draaien, met eigen prompt, tools en stem, en er alleen nog een Tsjechisch nummer aan wilt koppelen. Begint u vanaf nul met niet meer dan één systeemprompt en zonder aparte ElevenLabs-workspace om te beheren? Dan is de snellere route de ingebouwde volai-agent - één API-aanroep stelt hem in, en transcriptie en samenvatting zitten bij de agenttoeslag inbegrepen, zonder aparte configuratie.

Wat hebt u nodig?

• Een volai-account met een Tsjechisch nummer erop, plus een API-sleutel (vk_...) - die haalt u uit het portaal, onder API en MCP.
• Een ElevenLabs Conversational AI-agent die al in UW EIGEN workspace is gebouwd - deze handleiding koppelt hem aan een nummer, maar bouwt de agent niet voor u.
• Tegoed op uw volai-account - gesprekken worden ervan afgeschreven, precies zoals bij de ingebouwde agent.

Stap 1: inkomende gesprekken koppelen

Zet de routing van het nummer op mode: "sip" met sipUri ingesteld op het adres waarop ElevenLabs gesprekken verwacht bij een SIP-trunkimport:

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

Registreer het nummer vervolgens aan de kant van ElevenLabs (Settings → Phone Numbers → Import → SIP trunk) met een inbound_trunk_config:

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

Alleen de inkomende minuut wordt in rekening gebracht (0,50 kr/min (≈ 0,02 EUR)), zonder toeslag - dezelfde regel die de ingebouwde agent en een gewone softphone volgen.

Stap 2: uitgaande gesprekken koppelen via de relay

Deze richting loopt andersom - uw agent belt zelf uit. Het telefoonnetwerk stuurt een gesprek vanaf een vreemd SIP-adres niet rechtstreeks door naar de bestemming, dus het loopt via een kortstondige relay - een eenmalige SIP-slot die volai vlak voor het gesprek opent en na afloop weer afbreekt. Waarom het zo werkt en hoe het eruitziet bij andere platforms dan ElevenLabs, leest u op de pagina Eigen agent meenemen - hier alleen de drie stappen die u nodig hebt:

2.1 ElevenLabs op uw lijn richten

Haal de SIP-inloggegevens van het nummer op:

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

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

Het veld server is bedoeld voor een gewone softphone (zie de SIP-pagina), maar ElevenLabs heeft het veld outboundTrunkAddress nodig (sip.volai.cz), niet server - wie in plaats daarvan dat veld invult, krijgt de fout 1011 sip request timed out - het adres van de uitgaande trunk moet precies deze waarde zijn, anders wordt het gesprek op het netwerk niet gerouteerd.

Stel het daarna in als outbound_trunk_config van dat nummer bij ElevenLabs (Settings → Phone Numbers → uw nummer → Outbound calling), in precies deze vorm:

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

2.2 Een relayverbinding openen

Vlak voordat u het gesprek start - de verbinding is kortstondig, zie de beperkingen verderop - roept u aan:

curl -X POST https://volai.cz/v1/relay \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -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 De agent de sipName laten bellen, niet de volledige SIP-URI

Bij ElevenLabs betekent dat: /v1/convai/sip-trunk/outbound-call aanroepen met to_number rechtstreeks ingesteld op de sipName:

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

Wat er gebeurt zodra het gesprek uitgaat

Aan de netwerkkant gaat het gesprek uit onder de naam volai_relay_2, wordt doorgegeven aan uw to en toont uw from-nummer als beller-ID - wie opneemt, ziet uw volai-lijn op het scherm en nooit de wegwerpnaam van de relay-slot (alleen als het nummer eigen relaynamen heeft - anders ziet de gebelde het demonummer van volai; neem dan contact op met de support). Zodra het gesprek is afgelopen, wordt de lease automatisch vrijgegeven en brengen we het normale uitgaande tarief in rekening - 0,92 kr/min (≈ 0,04 EUR), zonder agenttoeslag erbovenop.

Beperkingen en beveiliging

• from moet uw eigen volai-nummer zijn - anders volgt from_number_not_owned. Zonder die controle zou iedereen de lijn van iemand anders als beller-ID kunnen vervalsen.
• Dezelfde drempels als bij een gewoon gesprek - de bel-me-niet-lijst (alleen gesprekken, sms is uitgezonderd), een automatische blokkade van 30 dagen na drie mislukte pogingen naar één nummer binnen 24 uur en de standaardlimiet voor gesprekken. Niets daarvan is via de relay te omzeilen.
• De lease is eenmalig - een tweede belpoging op dezelfde lease wordt geweigerd, dus open voor het volgende gesprek een nieuwe.
• Een volle relaypool antwoordt met 503 capacity_busy - het is een limiet voor gelijktijdigheid die geldt voor het HELE volai-platform, niet alleen voor uw account. Er wordt dan niets in rekening gebracht; probeer het kort daarna opnieuw.

De volledige REST-referentie (foutcodes, GET/DELETE op leases) staat in de REST-API-referentie; de volledige handleiding - met inkomende en uitgaande gesprekken voor elk platform, niet alleen ElevenLabs - staat op de pagina Eigen agent meenemen.

Wanneer kunt u beter bij de ingebouwde agent blijven?

Om eerlijk te zijn: een eigen agent betekent meer bewegende delen - een apart ElevenLabs-account en een aparte rekening, geen automatische transcriptie of samenvatting in het volai-portaal en een extra stap voor elk uitgaand gesprek (een relay-lease openen). Als één degelijke systeemprompt dekt wat u nodig hebt en u liever in enkele minuten klaar bent dan een tweede platformaccount beheert, brengt de ingebouwde volai-agent u er met één API-aanroep - en die toeslag van 2,50 kr/min (≈ 0,10 EUR) levert u bij elk gesprek een automatische transcriptie, samenvatting en voicemailherkenning op, zonder extra configuratie.

Voor de volledige prijsvergelijking met Twilio en andere aanbieders, zie de prijzenpagina; de ElevenLabs-integratiehandleiding, met links naar hun eigen documentatie, staat op de pagina Integraties.

Wat nu