Agentul ElevenLabs pe un număr ceh prin SIP

Aveți deja propriul agent ElevenLabs Conversational AI și doriți să îi atribuiți un număr de telefon ceh? Nu există niciun truc special: îndreptați un număr volai către SIP trunk-ul platformei agentului. Apelurile primite sunt partea ușoară - o singură cerere PATCH asupra rutării numărului. Apelurile efectuate funcționează puțin diferit, pentru că ElevenLabs (ca majoritatea platformelor de agenți vocali AI) nu poate ține o linie telefonică înregistrată permanent drept client SIP - trimite doar un singur apel autentificat, așa că apelul trece printr-o conexiune relay de scurtă durată. Marea diferență față de agentul integrat volai: la apelurile efectuate nu mai plătiți deloc suplimentul pentru agent de 2,50 kr/min (≈ 0,52 RON) - agentul îl rulați (și îl plătiți) dumneavoastră, în propriul workspace ElevenLabs.

Când are mai mult sens propriul agent decât cel integrat?

Ambele variante se tarifează pe același număr volai și din același credit - se schimbă doar cine conduce conversația și cât costă în plus:

Altfel spus: propriul agent merită atunci când aveți deja în funcțiune un agent ElevenLabs, cu propriul prompt, instrumente și voce, și vă lipsește doar un număr ceh pe care să i-l atașați. Porniți de la zero, cu un singur prompt de sistem și fără un workspace ElevenLabs separat de administrat? Calea mai rapidă este agentul vocal integrat volai - o singură cerere API îl configurează, iar transcrierea și rezumatul sunt incluse în suplimentul pentru agent, fără configurare separată.

De ce aveți nevoie?

• Un cont volai cu un număr ceh deja atribuit, plus o cheie API (vk_...) - o luați din portal, la secțiunea API și MCP.
• Un agent ElevenLabs Conversational AI deja creat în PROPRIUL dumneavoastră workspace - acest ghid îl conectează la un număr, nu construiește agentul în locul dumneavoastră.
• Credit în contul volai - apelurile se scad din el exact ca în cazul agentului integrat.

Pasul 1: Conectați apelurile primite

Setați rutarea numărului pe mode: "sip" cu sipUri egal cu adresa la care ElevenLabs așteaptă apeluri pentru importul unui SIP trunk:

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

Apoi, în ElevenLabs (Settings → Phone Numbers → Import → SIP trunk), înregistrați numărul cu un inbound_trunk_config:

{
  "provider": "sip_trunk",
  "phone_number": "+420601234567",
  "label": "Agentul meu propriu",
  "inbound_trunk_config": {
    "allowed_addresses": ["81.31.45.0/24"],
    "media_encryption": "allowed"
  }
}

Se tarifează doar minutul de apel primit (0,50 kr/min (≈ 0,10 RON)), fără supliment - aceeași regulă pe care o urmează atât agentul integrat, cât și un softphone obișnuit.

Pasul 2: Conectați apelurile efectuate prin relay

Acest sens funcționează invers - agentul dumneavoastră sună singur. Rețeaua telefonică nu va redirecționa un apel venit de la o adresă SIP străină direct către destinație, așa că acesta trece printr-un relay de scurtă durată - un slot SIP de unică folosință pe care volai îl deschide chiar înainte de apel și îl închide după încheierea lui. Pentru mecanismul complet și pentru felul în care arată la alte platforme decât ElevenLabs, consultați pagina Agentul propriu - aici sunt doar cei trei pași de care aveți nevoie:

2.1 Îndreptați ElevenLabs către linia dumneavoastră

Obțineți datele de autentificare SIP ale numărului:

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

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

Câmpul server este pentru un softphone obișnuit (vezi pagina SIP), dar ElevenLabs are nevoie de câmpul outboundTrunkAddress (sip.volai.cz), nu de server - dacă îl înlocuiți, apelul eșuează cu 1011 sip request timed out - adresa trunk-ului pentru apeluri efectuate trebuie să fie exact această valoare, altfel apelul nu este rutat în rețea.

Apoi setați-o ca outbound_trunk_config al acelui număr în ElevenLabs (Settings → Phone Numbers → numărul dumneavoastră → Outbound calling), exact în această formă:

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

2.2 Deschideți o conexiune relay

Chiar înainte de a efectua apelul - conexiunea este de scurtă durată, vezi limitele mai jos - apelați:

curl -X POST https://volai.cz/v1/relay \
  -H "Authorization: Bearer vk_CHEIA_DUMNEAVOASTRA" \
  -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 Spuneți agentului să formeze sipName, nu întregul SIP URI

Pentru ElevenLabs, aceasta înseamnă apelarea /v1/convai/sip-trunk/outbound-call cu to_number setat direct pe sipName:

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

Ce se întâmplă după ce pleacă apelul

Din punctul de vedere al rețelei, apelul pleacă sub numele volai_relay_2, este predat către to-ul dumneavoastră și afișează numărul from drept identificator al apelantului - cine răspunde vede pe ecran linia dumneavoastră volai, niciodată numele provizoriu al slotului relay (doar dacă numărul are propriile nume relay - altfel destinatarul vede numărul demo volai; contactați asistența). La încheierea apelului, lease-ul se eliberează automat și se tarifează la prețul obișnuit pentru apeluri efectuate - 0,92 kr/min (≈ 0,19 RON), fără supliment pentru agent.

Limite și securitate

• from trebuie să fie propriul dumneavoastră număr volai - altfel from_number_not_owned. Fără această verificare, oricine ar putea falsifica linia altcuiva drept identificator al apelantului.
• Aceleași bariere ca la un apel obișnuit - lista de nonapelare (doar apeluri, SMS-urile sunt exceptate), blocarea automată timp de 30 de zile după trei încercări eșuate către un număr în 24 de ore și limita standard de apeluri. Nimic din toate acestea nu poate fi ocolit prin relay.
• Lease-ul este de unică folosință - o a doua încercare de apel pe același lease este respinsă, așa că deschideți unul nou pentru următorul apel.
• Un pool relay plin răspunde cu 503 capacity_busy - este o limită de concurență comună ÎNTREGII platforme volai, nu doar contului dumneavoastră. În acest caz nu se tarifează nimic; reîncercați puțin mai târziu.

Referința REST completă (coduri de eroare, GET/DELETE pentru lease-uri) se află în referința API-ului REST; descrierea completă - care acoperă apelurile primite și efectuate pentru orice platformă, nu doar ElevenLabs - se găsește pe pagina Agentul propriu.

Când să rămâneți la agentul integrat?

Să fim sinceri: un agent propriu înseamnă mai multe piese în mișcare - un cont și o factură ElevenLabs separate, nicio transcriere sau rezumat automat în portalul volai și un pas suplimentar înaintea fiecărui apel efectuat (deschiderea unui lease relay). Dacă un singur prompt de sistem bun acoperă ce vă trebuie și preferați să terminați în câteva minute decât să administrați contul unei a doua platforme, agentul vocal integrat volai vă duce acolo cu o singură cerere API - iar suplimentul de 2,50 kr/min (≈ 0,52 RON) vă aduce transcriere automată, rezumat și detectarea mesageriei vocale la fiecare apel, fără configurare suplimentară.

Pentru comparația completă de prețuri cu Twilio și alți furnizori, consultați pagina de prețuri; ghidul integrării ElevenLabs, cu trimiteri la documentația lor, se află pe pagina Integrări.

Pașii următori