ElevenLabs-agent på ett tjeckiskt nummer via SIP

Finns det redan en färdig ElevenLabs Conversational AI-agent som behöver ett tjeckiskt telefonnummer? Kopplingen är ingen svart magi - det handlar bara om att knyta volai-numret till agentplattformens SIP-trunk. Inkommande samtal ordnas med en enda PATCH-förfrågan om routingen. Utgående samtal fungerar lite annorlunda, eftersom ElevenLabs (liksom de flesta AI-röstplattformar) inte kan registrera en telefonlinje permanent som SIP-klient - plattformen skickar bara ett enda autentiserat samtal, och därför leds det via en kortlivad relay-förbindelse. Och den stora skillnaden mot volais inbyggda agent: vid utgående samtal betalas inget agenttillägg på 2,50 kr/min (≈ 1,14 SEK) alls - agenten körs (och betalas) i den egna ElevenLabs-arbetsytan.

När är en egen agent bättre än den inbyggda?

Båda körs på samma volai-nummer och drar från samma saldo - skillnaden är vem som sköter samtalet och vad det kostar extra:

Med andra ord: en egen agent lönar sig när en ElevenLabs-agent med egen prompt, egna verktyg och egen röst redan är igång och bara behöver ett tjeckiskt nummer. Den som börjar från noll och nöjer sig med en enda systemprompt utan egen ElevenLabs-administration kommer snabbare till mål med den inbyggda volai-agenten - den skapas med ett enda API-anrop och utskrift med sammanfattning kommer automatiskt.

Vad behövs?

• Ett volai-konto med ett köpt tjeckiskt nummer och en API-nyckel (vk_...) - den finns i portalen under API och MCP.
• En färdig ElevenLabs Conversational AI-agent i EN EGEN arbetsyta - den här guiden skapar ingen agent, den kopplar bara en agent till numret.
• Saldo på volai-kontot - samtalen dras från det på samma sätt som för den inbyggda agenten.

Steg 1: Koppla inkommande samtal

Sätt nummrets routing till mode: "sip" och ange som sipUri den SIP-adress där ElevenLabs ska ta emot samtal när SIP-trunken importeras:

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

Därefter registreras numret i ElevenLabs-kontot (Settings → Phone Numbers → Import → SIP trunk) med inbound_trunk_config:

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

Det är bara den inkommande minuten som debiteras (0,50 kr/min (≈ 0,23 SEK)), utan något extra agenttillägg - samma regel som för den inbyggda agenten eller en vanlig softphone.

Steg 2: Koppla utgående samtal via relay

Den här riktningen är den omvända - agenten ringer själv ut. Telefonnätet släpper dock inte igenom ett samtal med en främmande SIP-adress direkt till målnumret, så samtalet leds via en kortlivad relay-förbindelse: en engångs-SIP-plats som volai skapar strax före samtalet och tar bort av sig själv när det är slut. Den detaljerade mekaniken (varför det är så och hur det ser ut på andra plattformar än ElevenLabs) finns på sidan Egen agent - här bara de tre steg som måste göras.

2.1 Ställ in ElevenLabs på den egna linjen

Begär nummrets SIP-uppgifter:

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

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

Fältet server används för en vanlig softphone (se sidan SIP), men i ElevenLabs ska fältet outboundTrunkAddress (sip.volai.cz) användas, inte server - en förväxling ger felet 1011 sip request timed out - adressen till den utgående trunken måste vara exakt det här värdet, annars routas samtalet inte i nätet.

Ange den som outbound_trunk_config för numret i ElevenLabs (Settings → Phone Numbers → numret → Outbound calling), exakt i den här formen:

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

2.2 Skapa relay-förbindelsen

Strax före samtalet (förbindelsen lever bara en kort stund, gränserna finns nedan) anropas:

curl -X POST https://volai.cz/v1/relay \
  -H "Authorization: Bearer vk_DIN_NYCKEL" \
  -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 Ge agenten sipName, inte hela SIP-URI:n

För ElevenLabs betyder det att anropet går via /v1/convai/sip-trunk/outbound-call med to_number satt direkt till sipName:

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

Vad som händer efter anropet

Telefonnätet tar emot samtalet på namnet volai_relay_2, kopplar vidare det till to och sätter det synliga uppringarnumret till from - den uppringde ser på displayen volai-linjen, inte relay-platsens interna namn (om numret har egna relay-namn - annars ser den uppringde volais demonummer, skriv då till supporten). När samtalet är slut frigörs leasen och minuterna debiteras som ett vanligt utgående samtal - 0,92 kr/min (≈ 0,42 SEK), utan agenttillägg.

Gränser och säkerhet

• from måste vara ett eget volai-nummer - annars from_number_not_owned. Utan den kontrollen skulle man kunna utge sig för en främmande linje.
• Samma spärrar som för ett vanligt samtal - listan över nummer som inte ska ringas (bara för samtal, inte för sms), automatisk 30 dagars spärr efter tre misslyckade försök till samma nummer inom 24 timmar och den allmänna rate limiten för samtal. Relay kringgår inget av detta.
• Leasen är en engångsföreteelse - ett andra samtal på samma lease avvisas, skapa en ny för nästa samtal.
• En full pool av relay-platser ger 503 capacity_busy - det är ett delat tak för samtidighet för HELA volai-plattformen, inte bara det egna kontot. Inget debiteras, det räcker att försöka igen om en stund.

Den fullständiga REST-referensen (felkoder, GET/DELETE över leaser) finns i referensen för REST-API:t, hela genomgången - med både inkommande och utgående samtal för valfri plattform, inte bara ElevenLabs - finns på sidan Egen agent.

När är det bättre att stanna vid den inbyggda agenten?

Ärligt talat: en egen agent betyder fler rörliga delar - ett separat ElevenLabs-konto och en separat faktura, ingen automatisk utskrift eller sammanfattning direkt i volai-portalen och ett extra steg före varje utgående samtal (skapa en relay-lease). Räcker en enda bra systemprompt och målet är att vara klar på några minuter utan ett andra konto hos en annan plattform klarar den inbyggda volai-agenten samma sak med ett enda API-anrop - och agenttillägget på 2,50 kr/min (≈ 1,14 SEK) ger i gengäld automatisk utskrift, sammanfattning och upptäckt av telefonsvarare vid varje samtal.

En fullständig prisjämförelse med Twilio och andra leverantörer finns i prislistan, och integrationen med ElevenLabs steg för steg, med länkar till deras egen dokumentation, finns på sidan Integrationer.

Vad händer härnäst