ElevenLabs-i agent Tšehhi telefoninumbril SIP kaudu

Kasutate juba oma ElevenLabs Conversational AI agenti ja soovite sellele Tšehhi telefoninumbrit? Selleks pole mingit erilist trikki: suunate volai numbri oma agendiplatvormi SIP-trunkile. Sissetulevad kõned on lihtne osa - üks PATCH-päring numbri suunamisele. Väljaminevad töötavad veidi teisiti, sest ElevenLabs (nagu enamik tehisintellekti häälplatvorme) ei suuda telefoniliini püsivalt SIP-kliendina registreerituna hoida - see saadab vaid ühe autentitud kõne, seega liigub kõne hoopis lühiajalise relee-ühenduse kaudu. Suur erinevus sisseehitatud volai agendist: väljaminevate kõnede puhul jääb agendi lisatasu 2,50 kr/min (≈ 0,10 EUR) täielikult ära - agenti käitate (ja maksate selle eest) ise oma ElevenLabs workspace'is.

Millal on oma agent mõistlikum kui sisseehitatud?

Mõlemad teed arveldavad samalt volai numbrilt ja samast krediidist - erinevus on selles, kes vestlust juhib ja mis see lisaks maksab:

Teisisõnu: oma agent tasub end ära siis, kui teil on juba töötav ElevenLabs agent oma prompti, tööriistade ja häälega ning vajate sellele lihtsalt Tšehhi numbrit. Alustate nullist, vaid ühe süsteemiprompti käes ja ilma eraldi ElevenLabs workspace'i haldamata? Kiirem tee on sisseehitatud volai agent - üks API-kõne seadistab selle ning ärakiri ja kokkuvõte tulevad agendi lisatasuga kaasa, eraldi seadistust pole vaja.

Mida te vajate?

• volai konto, millel on juba Tšehhi number, ning API-võti (vk_...) - leiate selle portaalist jaotisest API ja MCP.
• ElevenLabs Conversational AI agent, mis on juba loodud TEIE ENDA workspace'is - see juhend ühendab selle numbriga, agenti ennast see teie eest ei loo.
• Krediit oma volai kontol - kõned arvestatakse sellest maha täpselt nagu sisseehitatud agendi puhul.

Samm 1: ühendage sissetulevad kõned

Suunake numbri suunamine režiimile mode: "sip" ja määrake sipUri aadressiks, millel ElevenLabs SIP-trunki impordi puhul kõnesid ootab:

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

Seejärel registreerige ElevenLabsi poolel (Settings → Phone Numbers → Import → SIP trunk) number koos inbound_trunk_config-iga:

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

Arvestatakse ainult sissetulevat minutit (0,50 kr/min (≈ 0,02 EUR)), lisatasu pealegi ei lisandu - sama reegel kehtib nii sisseehitatud agendile kui ka tavalisele pehmetelefonile.

Samm 2: ühendage väljaminevad kõned relee kaudu

See suund töötab vastupidi - teie agent valib numbri ise. Telefonivõrk ei suuna kõnet võõralt SIP-aadressilt otse sihtkohta, seega liigub see hoopis lühiajalise relee kaudu - ühekordne SIP-pesa, mille volai avab vahetult enne kõnet ja sulgeb pärast selle lõppu. Täieliku mehhanismi, miks see nii töötab, ja kuidas see näeb välja muudel platvormidel kui ElevenLabs, leiate lehelt Tooge oma agent - siin on vaid kolm vajalikku sammu:

2.1 Suunake ElevenLabs oma liinile

Võtke numbri SIP-andmed:

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

Väli server on mõeldud tavalisele pehmetelefonile (vt lehte SIP), ElevenLabs aga vajab välja outboundTrunkAddress (sip.volai.cz), mitte server - selle asendamine annab vea 1011 sip request timed out - väljamineva trunki aadress peab olema täpselt see väärtus, vastasel juhul kõnet võrgus ei suunata.

Seejärel määrake see selle numbri outbound_trunk_config-iks ElevenLabsis (Settings → Phone Numbers → teie number → Outbound calling), täpselt selles vormis:

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

2.2 Avage releeühendus

Vahetult enne kõne tegemist - ühendus on lühiajaline, vt piiranguid allpool - kutsuge:

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 Käskige agendil valida sipName, mitte täielikku SIP URI-d

ElevenLabsi puhul tähendab see /v1/convai/sip-trunk/outbound-call väljakutsumist, kus to_number on seatud otse väärtusele sipName:

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

Mis juhtub, kui kõne välja läheb

Võrgu poolel läheb kõne välja nime volai_relay_2 all, antakse edasi teie to numbrile ning helistaja numbrina kuvatakse teie from number - kes kõne vastu võtab, näeb oma ekraanil teie volai liini, mitte kunagi relee-pesa ühekordset nime (ainult siis, kui numbril on oma relee nimed - muidu näeb kõne saaja volai demonumbrit; pöörduge toe poole). Kui kõne lõpeb, vabaneb rendileping automaatselt ja teilt arvestatakse tavapärane väljamineva kõne hind - 0,92 kr/min (≈ 0,04 EUR), agendi lisatasu lisamata.

Piirangud ja turvalisus

• from peab olema teie enda volai number - muidu from_number_not_owned. Ilma selle kontrollita võiks igaüks võltsida kellegi teise liini oma helistaja numbrina.
• Samad väravad nagu tavalisel kõnel - helistamiskeelu loend (ainult kõned, SMS on vabastatud), automaatne 30-päevane blokeering pärast kolme ebaõnnestunud katset ühele numbrile 24 tunni jooksul ning tavaline kõnede päringulimiit. Ühtegi neist ei saa releest mööda minna.
• Rendileping on ühekordne - teine kõnekatse samal rendilepingul lükatakse tagasi, seega avage järgmise kõne jaoks uus.
• Täis releepoolile vastatakse 503 capacity_busy - see on samaaegsuse piirang, mis on jagatud KOGU volai platvormi vahel, mitte ainult teie konto jaoks. Sel juhul midagi ei arveldata; proovige veidi hiljem uuesti.

Täielik REST-viide (veakoodid, GET/DELETE rendilepingutel) on REST API viitedokumentatsioonis; täielik juhend - mis hõlmab sissetulevaid ja väljaminevaid kõnesid mis tahes platvormi jaoks, mitte ainult ElevenLabsi - asub lehel Tooge oma agent.

Millal jääda sisseehitatud agendi juurde?

Ausalt öeldes: oma agendi käitamine tähendab rohkem liikuvaid osi - eraldi ElevenLabsi konto ja arve, volai portaalis ei ilmu automaatset ärakirja ega kokkuvõtet ning iga väljamineva kõne ees on lisasamm (releerendilepingu avamine). Kui üks hea süsteemiprompt katab teie vajaduse ja soovite olla valmis minutitega, mitte hallata teist platvormikontot, viib teid sihile sisseehitatud volai agent ühe API-kõnega - ning see 2,50 kr/min (≈ 0,10 EUR) lisatasu toob igale kõnele automaatse ärakirja, kokkuvõtte ja kõneposti tuvastuse, ilma lisaseadistuseta.

Täieliku hinnavõrdluse Twilio ja teiste pakkujatega leiate hinnakirja lehelt; ElevenLabsi lõimimise juhend koos linkidega nende enda dokumentatsiooni on lehel Lõimingud.

Mis edasi