Pamācības

Savs aģents

Vai vēlaties volai numuram pieslēgt savu balss platformu - ElevenLabs Conversational AI savā darbvietā, Vapi, Retell vai pat parastu Asterisk/FreeSWITCH IVR - iebūvētā aģenta vietā? Šajā lapā aprakstīti abi virzieni: ienākošie un izejošie zvani. Izejošajiem zvaniem jūs arī nemaksājat aģenta uzcenojumu 2,50 kr/min (≈ 0,10 EUR) - aģentu darbinājat (un apmaksājat) paši savā platformā.

1Savs aģents pret iebūvēto

Abi ceļi darbojas ar vienu un to pašu numuru un vienu un to pašu kredītu - atšķiras tikai tas, KAS vada sarunas loģiku un cik tas maksā papildus:

2Ienākošie zvani uz jūsu paša aģentu

Nekādas jaunas mehānikas - tikai esošā mode: "sip" maršrutēšana (tāpat kā jūsu softfonam, skatiet SIP) ar jūsu platformas sipUri adresi. ElevenLabs SIP trunka numuram, kas reģistrēts JŪSU PAŠA darbvietā, tā ir adrese ar to pašu numuru, kāds ir jūsu volai līnijai:

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

Savā ElevenLabs kontā (Settings → Phone Numbers → Import → SIP trunk) šo numuru reģistrējat ar inbound_trunk_config:

{
  "provider": "sip_trunk",
  "phone_number": "+420601234567",
  "label": "Mans aģents",
  "inbound_trunk_config": {
    "allowed_addresses": ["81.31.45.0/24"],
    "media_encryption": "allowed"
  }
}

allowed_addresses iepriekš ir mūsu signalizācijas diapazons (81.31.45.0/24) - drošāk nekā universālais 0.0.0.0/0, kas ļauj INVITE ienākt no jebkuras vietas. Abi ļauj zvanam cauri, taču importam bez piekļuves datiem atļauto adrešu saraksts ir VIENĪGĀ pārbaude - tāpēc izmantojiet diapazonu, nevis 0.0.0.0/0.

Izmantojat citu platformu, nevis ElevenLabs? Princips tāds pats - noskaidrojiet SIP adresi, uz kuru tā gaida zvanus jūsu numuram, un ierakstiet to sipUri. Vapi gadījumā tas pats diapazons tiek ievadīts BYO trunka gateways.

Vapi gadījumā maršrutēšanas adrese ir sip:<E164>@<credentialId>.sip.vapi.ai - <credentialId> atradīsiet savam BYO SIP trunkam Vapi; organizācija ES reģionā izmanto domēnu sip.eu.vapi.ai, nevis sip.vapi.ai. Tukšais sip.vapi.ai pieder Vapi dzimtajiem numuriem un numuram no mums nedarbojas. BYO trunkam lietotājvārdu un paroli atstājiet tukšus - Vapi mūsu zvanus atpazīst pēc IP vārteju sarakstā.

Vārtejās ievadiet diapazonu kā IP 81.31.45.0 un tīkla masku 24 atsevišķi. Ar noklusējuma masku 32 Vapi atļautu tikai vienu adresi un mūsu zvanus noraidītu.

3Izejošie zvani no jūsu paša aģenta (relejs)

Šis ir pretējais virziens - jūsu platforma zvana pati. Lielākā daļa balss MI platformu (arī ElevenLabs) nevar pastāvīgi reģistrēt tālruņa līniju kā SIP klientu - tās sūta tikai vienu autentificētu zvanu ar jūsu līnijas piekļuves datiem. Tālruņu tīkls šādu zvanu tieši uz galamērķa numuru nelaiž, tāpēc to virzāt caur īslaicīgu releja savienojumu:

1. Norādiet platformai savu līniju

Iegūstiet savas līnijas SIP piekļuves 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"]
}

Atbilde atgriež server (softfona REGISTER vajadzībām, skatiet SIP) un outboundTrunkAddress ATSEVIŠĶI - tie nav savstarpēji aizvietojami.

Un kā savas platformas izejošo trunku iestatiet outboundTrunkAddress - NEVIS server . ElevenLabs gadījumā tas ir attiecīgā tālruņa numura outbound_trunk_config (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. Izveidojiet releja savienojumu

Tieši pirms zvana (savienojumam ir īss darbības laiks, skatiet ierobežojumus zemā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"
}

Galamērķa numuru lauka to jūs norādāt MUMS - platforma to nekad neredz, tā saņem tikai tukšo sipName no atbildes.

3. Likt platformai zvanīt uz sipName

ElevenLabs gadījumā tas nozīmē izsaukt /v1/convai/sip-trunk/outbound-call ar to_number iestatītu tieši uz sipName:

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

agent_id atrodams jūsu aģentam ElevenLabs, agent_phone_number_id ir importētā numura phone_number_id - to atgriež importa atbilde, vai arī to var nolasīt no Phone numbers saraksta.

Izmantojat savu SIP klientu vai centrāli, nevis ElevenLabs? Zvaniet uz pilno sipUri tieši, kā parastu SIP zvanu - šis ierobežojums attiecas tikai uz platformām, kuras vēlas tukšu nosaukumu bez sip: prefiksa.

4. Kas notiek tālāk

Tālruņu tīkls pieņem zvanu ar nosaukumu volai_relay_2, pārsūta to uz jūsu to un redzamo zvanītāja ID iestata uz jūsu from - zvana saņēmējs savā displejā redz jūsu volai līniju, nevis releja vietas iekšējo nosaukumu (tikai tad, ja numuram ir savi releja nosaukumi - skatiet Norēķini zemāk, citādi zvana saņēmējs redz volai demonstrācijas numuru). Kad zvans beidzas, nomas savienojums tiek atbrīvots un minūtes tiek rēķinātas tieši kā parasts izejošs zvans - 0,92 kr/min (≈ 0,04 EUR), bez aģenta uzcenojuma.

Atbilde, kas apstiprina zvanu, atnāk tikai pēc visa zvana signāla cikla (viegli desmitiem sekunžu) - tā nav kļūda, lai gan īss taimauts jūsu pusē var tā izskatīties, kamēr zvans vēl zvana.

4Problēmu novēršana

Biežākie ziņojumi ar savu aģentu un ko darīt:

5Norēķini

Izejošs zvans caur releju tiek rēķināts pēc tā paša tarifa kā parasts izejošs zvans - 0,92 kr/min (≈ 0,04 EUR) - bez jebkāda aģenta uzcenojuma. Tarifi ir bez PVN, tāpat kā viss cenrādis.

Vienlaicīgums ir ierobežots (skatiet ierobežojumus zemāk): ne vairāk kā 1 aktīvs zvans uz katru jūsu numuru un ne vairāk kā 2 vienlaikus uz kontu.

Zvana saņēmējs redz jūsu volai līniju tikai tad, ja numuram ir savi releja nosaukumi (relayNames) - numurs tos saņem uzreiz pēc pirkuma. Kamēr to nav, noma pāriet uz kopīgo kopumu un zvana saņēmējs redz volai demonstrācijas numuru. Ja tas ilgst ilgāk par stundu, sazinieties ar atbalstu.

6Ierobežojumi, kvotas un drošība

Ierobežojums ir 1 aktīva noma uz numuru un ne vairāk kā 2 uz kontu - apzināts drošības pasākums, lai viens klients neaizņemtu visu kopīgo releja vietu kopumu:

• from jābūt jūsu pašu volai numuram - citādi from_number_not_owned. Bez šīs pārbaudes jūs varētu viltot kāda cita līniju kā savu zvanītāja ID.
• Tie paši vārti kā parastam zvanam - zvanīšanas aizlieguma saraksts (tikai zvaniem, ne SMS), automātisks 30 dienu bloks pēc 3 neveiksmīgiem mēģinājumiem uz to pašu numuru 24 stundu laikā, paaugstinātas maksas līnijas, aizsardzība pret cilpām starp volai numuriem, zvana saņēmēja numura slēgšana un vispārējais zvanu ātruma ierobežojums. Neko no tā caur releju apiet nevar.
• Kopums pilns -> 503 capacity_busy - releja vietas ir kopīgs vienlaicīguma ierobežojums VISAI platformai, ne tikai jūsu kontam. Pie capacity_busy nekas netiek rēķināts, mēģiniet vēlreiz pēc brīža.
• Pilna REST atsauce (kļūdu kodi, GET/DELETE par nomām) ir REST API atsaucē.

Katra API kļūda nes cause (kam tā jālabo) un action (kas jādara) - skatiet Kļūdu formāts REST API atsaucē.