ElevenLabs aģents uz Čehijas numura caur SIP

Jums jau darbojas savs ElevenLabs Conversational AI aģents un vēlaties tam piešķirt Čehijas tālruņa numuru? Tam nav nekāda īpaša triku: volai numuru pieslēdzat savas aģentu platformas SIP trunkam. Ienākošie zvani ir vieglā daļa - viens PATCH pieprasījums numura maršrutēšanai. Izejošie darbojas nedaudz citādi, jo ElevenLabs (tāpat kā lielākā daļa balss AI platformu) nevar pastāvīgi reģistrēt tālruņa līniju kā SIP klientu - tā tikai nosūta vienu autentificētu zvanu, tāpēc zvans iet pa īslaicīgu relay savienojumu. Galvenā atšķirība salīdzinājumā ar iebūvēto volai aģentu: izejošiem zvaniem aģenta uzcenojumu 2.50 CZK/min (~EUR 0.10) nemaksājat vispār - aģentu darbinat (un apmaksājat) pats savā ElevenLabs workspace.

Kad savs aģents ir lietderīgāks par iebūvēto?

Abi ceļi tiek rēķināti uz viena un tā paša volai numura un no viena kredīta - atšķiras tas, kas vada sarunu un kādas papildu izmaksas tas rada:

Citiem vārdiem: savs aģents atmaksājas, kad jums jau darbojas ElevenLabs aģents ar savu uzvedni, rīkiem un balsi un tam tikai jāpiesaista Čehijas numurs. Sākat no nulles, ar vienu sistēmas uzvedni un bez atsevišķa ElevenLabs workspace, ko pārvaldīt? Ātrākais ceļš ir iebūvētais volai aģents - to iestata ar vienu API izsaukumu, un transkripts un kopsavilkums nāk komplektā ar aģenta uzcenojumu, bez atsevišķas iestatīšanas.

Kas jums būs vajadzīgs?

• volai konts ar Čehijas numuru un API atslēga (vk_...) - to atradīsiet portālā sadaļā API un MCP.
• ElevenLabs Conversational AI aģents, kas jau izveidots JŪSU PAŠU workspace - šī pamācība to pieslēdz numuram, bet pašu aģentu neizveido.
• Kredīts jūsu volai kontā - zvani no tā tiek noņemti tieši tāpat kā ar iebūvēto aģentu.

1. solis: pieslēdziet ienākošos zvanus

Iestatiet numura maršrutēšanu uz mode: "sip", ar sipUri norādot adresi, kurā ElevenLabs gaida zvanus SIP trunka importam:

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

Pēc tam ElevenLabs pusē (Settings → Phone Numbers → Import → SIP trunk) reģistrējiet numuru ar 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"
  }
}

Tiek rēķināta tikai ienākošā minūte (0.50 CZK/min (~EUR 0.02)), bez uzcenojuma - tas pats noteikums, ko ievēro gan iebūvētais aģents, gan parasts softphone.

2. solis: pieslēdziet izejošos zvanus caur relay

Šis virziens iet otrādi - jūsu aģents zvana pats. Tālruņu tīkls nenovirza zvanu no svešas SIP adreses tieši uz galamērķi, tāpēc tas iet pa īslaicīgu relay - vienreizēju SIP slotu, ko volai atver tieši pirms zvana un aizver, kad zvans beidzies. Pilnu skaidrojumu, kāpēc tas strādā šādi un kā tas izskatās citām platformām, nevis tikai ElevenLabs, skatiet lapā Savs aģents - šeit tikai trīs nepieciešamie soļi:

2.1 Norādiet ElevenLabs savu līniju

Iegūstiet numura SIP pieteikšanās datus:

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

Lauks server paredzēts parastam softphone (skatiet lapu SIP), bet ElevenLabs vajadzīgs lauks outboundTrunkAddress (sip.volai.cz), nevis server - ja to aizstājat, zvans beidzas ar kļūdu 1011 sip request timed out - izejošā trunka adresei jābūt tieši šai vērtībai, citādi zvans tīklā netiek maršrutēts.

Pēc tam iestatiet to kā šī numura outbound_trunk_config ElevenLabs (Settings → Phone Numbers → jūsu numurs → Outbound calling), tieši šādā formā:

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

2.2 Atveriet relay savienojumu

Tieši pirms zvana veikšanas - savienojums ir īslaicīgs, skatiet ierobežojumus tālāk - izsauciet:

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 Liekiet aģentam zvanīt uz sipName, nevis uz pilno SIP URI

ElevenLabs gadījumā tas nozīmē izsaukt /v1/convai/sip-trunk/outbound-call, laukā to_number tieši norādot sipName:

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

Kas notiek, kad zvans iziet

Tīkla pusē zvans iziet ar nosaukumu volai_relay_2, tiek nodots jūsu to un kā zvanītāja numuru rāda jūsu from numuru - tas, kas paceļ klausuli, savā ekrānā redz jūsu volai līniju, nevis relay slota pagaidu nosaukumu (tikai ja numuram ir savi relay nosaukumi - citādi zvanāmais redz volai demonstrācijas numuru; sazinieties ar atbalstu). Kad zvans beidzas, nomas savienojums tiek atbrīvots automātiski un jums tiek rēķināta parastā izejošā likme - 0.92 CZK/min (~EUR 0.04), bez pievienota aģenta uzcenojuma.

Ierobežojumi un drošība

• from jābūt jūsu pašu volai numuram - citādi tiek atgriezts from_number_not_owned. Bez šīs pārbaudes ikviens varētu viltot svešu līniju kā savu zvanītāja numuru.
• Tie paši vārti kā parastam zvanam - zvanīšanas aizliegumu saraksts (tikai zvaniem, SMS ir izņemti), automātisks 30 dienu bloks pēc trim neveiksmīgiem mēģinājumiem uz vienu numuru 24 stundu laikā un standarta zvanu ātruma ierobežojums. Neviens no tiem nav apejams caur relay.
• Noma ir vienreizēja - otrs zvana mēģinājums uz tās pašas nomas tiek noraidīts, tāpēc nākamajam zvanam izveidojiet jaunu.
• Pilns relay pūls atbild ar 503 capacity_busy - tas ir vienlaicīgo savienojumu ierobežojums, kas kopīgs VISAI volai platformai, nevis tikai jūsu kontam. Šādā gadījumā nekas netiek rēķināts; mēģiniet drīz vēlreiz.

Pilnā REST atsauce (kļūdu kodi, GET/DELETE darbības ar nomām) ir REST API atsaucē; pilns apraksts - ienākošie un izejošie zvani jebkurai platformai, ne tikai ElevenLabs - ir lapā Savs aģents.

Kad labāk palikt pie iebūvētā aģenta?

Atklāti sakot: savs aģents nozīmē vairāk kustīgu daļu - atsevišķu ElevenLabs kontu un rēķinu, nav automātiska transkripta vai kopsavilkuma volai portālā un papildu solis pirms katra izejošā zvana (relay nomas izveide). Ja jums pietiek ar vienu kvalitatīvu sistēmas uzvedni un vēlaties būt gatavs dažās minūtēs, nevis pārvaldīt otru platformas kontu, iebūvētais volai aģents to nodrošina ar vienu API izsaukumu - un uzcenojums 2.50 CZK/min (~EUR 0.10) nozīmē automātisku transkriptu, kopsavilkumu un atbildētājaparāta noteikšanu katram zvanam bez papildu iestatīšanas.

Pilnu cenu salīdzinājumu ar Twilio un citiem sniedzējiem skatiet cenrāža lapā; ElevenLabs integrācijas apraksts ar saitēm uz to pašu dokumentāciju ir lapā Integrācijas.

Kas tālāk