ElevenLabs-agent på et tjekkisk nummer via SIP

Kører der allerede en egen ElevenLabs Conversational AI-agent, som skal have et tjekkisk telefonnummer? Det kræver intet særligt trick: et volai-nummer peger på SIP-trunken hos agentplatformen. Indgående opkald er den nemme del - én PATCH-anmodning på nummerets routing. Udgående opkald fungerer lidt anderledes, fordi ElevenLabs (som de fleste stemme-AI-platforme) ikke kan holde en telefonlinje permanent registreret som SIP-klient - den sender kun ét enkelt autentificeret opkald, så opkaldet går i stedet gennem en kortvarig relay-forbindelse. Den store forskel fra den indbyggede volai-agent: ved udgående opkald bortfalder agenttillægget på 2,50 kr/min. (≈ 0,78 DKK) helt - agenten drives (og betales) selv i eget ElevenLabs-workspace.

Hvornår giver en egen agent mere mening end den indbyggede?

Begge veje afregnes mod det samme volai-nummer og den samme saldo - det, der ændrer sig, er hvem der fører samtalen, og hvad det koster ovenpå:

Sagt på en anden måde: en egen agent kan betale sig, når der allerede kører en ElevenLabs-agent med egen prompt, egne værktøjer og egen stemme, og der blot mangler et tjekkisk nummer til den. Startes der fra bunden med ikke mere end én systemprompt og uden et separat ElevenLabs-workspace at administrere, er den hurtigere vej den indbyggede volai-agent - ét API-kald sætter den op, og udskrift og resumé følger med agenttillægget uden separat opsætning.

Hvad skal der bruges?

• En volai-konto med et tjekkisk nummer og en API-nøgle (vk_...) - den findes i portalen under API og MCP.
• En færdig ElevenLabs Conversational AI-agent i et EGET workspace - denne vejledning opretter den ikke, den kobler den kun til et nummer.
• Saldo på volai-kontoen - opkaldene trækkes fra den på samme måde som ved den indbyggede agent.

Trin 1: Forbind indgående opkald

Nummerets routing sættes til mode: "sip" med sipUri sat til den adresse, som ElevenLabs forventer opkald på ved import af en SIP-trunk:

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"}}'

Derefter registreres nummeret hos ElevenLabs (Settings → Phone Numbers → Import → SIP trunk) med en 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"
  }
}

Kun det indgående minut faktureres (0,50 kr/min. (≈ 0,16 DKK)), uden tillæg ovenpå - samme regel som den indbyggede agent og en almindelig softphone følger.

Trin 2: Forbind udgående opkald via relayet

Denne retning kører den anden vej - agenten ringer selv ud. Telefonnettet videresender ikke et opkald fra en fremmed SIP-adresse direkte til målet, så opkaldet går i stedet gennem et kortvarigt relay - en engangs-SIP-plads, som volai åbner lige før opkaldet og nedlægger igen, når det er slut. De fulde mekanismer bag, hvorfor det fungerer sådan, og hvordan det ser ud for andre platforme end ElevenLabs, står på siden Medbring din egen agent - her er kun de tre trin, der skal bruges:

2.1 Peg ElevenLabs på linjen

Hent nummerets SIP-oplysninger:

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"]
}

Feltet server er til en almindelig softphone (se siden SIP), men ElevenLabs skal bruge feltet outboundTrunkAddress (sip.volai.cz), ikke server - en udskiftning giver fejlen 1011 sip request timed out - adressen på den udgående trunk skal være præcis denne værdi, ellers routes opkaldet ikke i nettet.

Sæt den derefter som nummerets outbound_trunk_config hos ElevenLabs (Settings → Phone Numbers → nummeret → Outbound calling), i præcis denne form:

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

2.2 Åbn en relay-forbindelse

Lige før opkaldet lægges - forbindelsen er kortvarig, se begrænsningerne længere nede - kaldes:

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 Bed agenten om at ringe til sipName, ikke den fulde SIP-URI

Hos ElevenLabs betyder det at kalde /v1/convai/sip-trunk/outbound-call med to_number sat direkte til sipName:

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

Hvad der sker, når opkaldet går ud

På netsiden går opkaldet ud under navnet volai_relay_2, overdrages til det angivne to og viser nummeret fra from som opkalds-id - den, der tager telefonen, ser volai-linjen på skærmen, aldrig relay-pladsens engangsnavn (kun hvis nummeret har sine egne relay-navne - ellers ser den opkaldte volais demonummer; kontakt support). Når opkaldet er afsluttet, frigives lejen automatisk, og der faktureres den normale udgående takst - 0,92 kr/min. (≈ 0,29 DKK), uden agenttillæg ovenpå.

Begrænsninger og sikkerhed

• from skal være et eget volai-nummer - ellers from_number_not_owned. Uden den kontrol kunne enhver forfalske en andens linje som opkalds-id.
• De samme porte som et almindeligt opkald - listen over numre, der ikke må ringes til (kun opkald, SMS er undtaget), en automatisk 30-dages spærring efter tre mislykkede forsøg til ét nummer inden for 24 timer og den almindelige ratebegrænsning for opkald. Intet af det kan omgås gennem relayet.
• Lejen er til engangsbrug - et andet opkaldsforsøg på samme leje afvises, så der oprettes en ny til næste opkald.
• En fuld relay-pulje svarer med 503 capacity_busy - det er en grænse for samtidighed, der gælder for HELE volai-platformen, ikke kun den ene konto. Der faktureres ikke noget, når det sker; det er bare at prøve igen lidt senere.

Den fulde REST-reference (fejlkoder, GET/DELETE på lejer) står i REST API-referencen; den komplette gennemgang - med indgående og udgående opkald for enhver platform, ikke kun ElevenLabs - findes på siden Medbring din egen agent.

Hvornår bør den indbyggede agent beholdes?

Helt ærligt: en egen agent betyder flere bevægelige dele - en separat ElevenLabs-konto og -regning, ingen automatisk udskrift eller resumé direkte i volai-portalen og et ekstra trin før hvert udgående opkald (oprettelse af en relay-leje). Hvis én god systemprompt dækker behovet, og det er vigtigere at være færdig på få minutter end at administrere en anden platformskonto, klarer den indbyggede volai-agent det med ét API-kald - og tillægget på 2,50 kr/min. (≈ 0,78 DKK) giver automatisk udskrift, resumé og detektion af telefonsvarer ved hvert opkald, uden ekstra opsætning.

Den fulde prissammenligning med Twilio og andre udbydere findes på siden Priser; gennemgangen af ElevenLabs-integrationen med links til deres egen dokumentation står på siden Integrationer.

Læs videre