Ръководства

Свържете собствен агент

Искате ли да свържете със своя номер във volai собствена гласова платформа - ElevenLabs Conversational AI във Вашето работно пространство, Vapi, Retell или дори обикновена Asterisk/FreeSWITCH IVR - вместо вградения агент? Тази страница обхваща и двете посоки: входящи и изходящи обаждания. При изходящите отпада и таксата за агент от 2,50 kr/min (≈ 0,10 EUR) - агентът работи (и се плаща) от Вас на Вашата платформа.

1Собствен агент или вграден

И двата пътя работят със същия номер и същия баланс - различават се само по това КОЙ води логиката на разговора и колко струва това допълнително:

2Входящи обаждания към собствен агент

Без нов механизъм - само съществуващото mode: "sip" маршрутизиране (същото като за Вашия собствен софтфон, вижте SIP) с sipUri адреса на Вашата платформа. За номер през ElevenLabs SIP trunk, регистриран във ВАШЕТО СОБСТВЕНО работно пространство, това е адрес със същия номер като Вашата линия във volai:

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

А във Вашия акаунт в ElevenLabs (Settings → Phone Numbers → Import → SIP trunk) регистрирате този номер с inbound_trunk_config:

{
  "provider": "sip_trunk",
  "phone_number": "+420601234567",
  "label": "Моят собствен агент",
  "inbound_trunk_config": {
    "allowed_addresses": ["81.31.45.0/24"],
    "media_encryption": "allowed"
  }
}

allowed_addresses по-горе е нашият сигнален диапазон (81.31.45.0/24) - по-безопасен от универсалния 0.0.0.0/0, който пропуска INVITE отвсякъде. И двата пропускат обаждането, но при импорт без данни за вход списъкът с разрешени адреси е ЕДИНСТВЕНАТА проверка - затова използвайте диапазона, а не 0.0.0.0/0.

Използвате различна платформа от ElevenLabs? Принципът е същият - установете на какъв SIP адрес тя очаква обажданията за Вашия номер и го поставете в sipUri. За Vapi същият диапазон се въвежда в gatewaysна BYO trunk.

За Vapi адресът за маршрутизиране е sip:<E164>@<credentialId>.sip.vapi.ai - <credentialId> ще намерите на Вашия BYO SIP trunk във Vapi; организация в региона ЕС използва домейна sip.eu.vapi.ai вместо sip.vapi.ai. Самостоятелният sip.vapi.ai е за собствените номера на Vapi и не работи за номер от нас. За BYO trunk оставете потребителското име и паролата празни - Vapi разпознава нашите обаждания по IP адреса в gateways.

В gateways въведете диапазона поотделно като IP 81.31.45.0 и netmask 24. При стандартната маска 32 Vapi би разрешил само един адрес и би отхвърлил нашите обаждания.

3Изходящи обаждания от собствен агент (релей)

Това е обратната посока - Вашата платформа сама набира. Повечето гласови AI платформи (включително ElevenLabs) не могат постоянно да регистрират телефонна линия като SIP клиент - изпращат само едно удостоверено обаждане с данните на Вашата линия. Телефонната мрежа не пуска такова обаждане направо до целевия номер, затова го насочвате през краткотрайна релейна връзка:

1. Насочете платформата към Вашата линия

Изтеглете SIP данните на Вашата линия:

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

Отговорът връща server (за REGISTER на софтфон, вижте SIP) и outboundTrunkAddress ОТДЕЛНО - те не са взаимозаменяеми.

И задайте outboundTrunkAddress - НЕ server - като изходящ trunk на Вашата платформа. За ElevenLabs това е outbound_trunk_config на съответния телефонен номер (Settings → Phone Numbers → Вашият номер → Outbound calling), точно в тази форма:

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

2. Създайте релейна връзка

Непосредствено преди обаждането (връзката живее кратко, вижте лимитите по-долу) извикайте:

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

Целевия номер подавате НА НАС в to - платформата никога не го вижда, получава само чистото sipName от отговора.

3. Накарайте платформата да набере sipName

За ElevenLabs това означава да извикате /v1/convai/sip-trunk/outbound-call със to_number зададено директно на sipName:

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

agent_id ще намерите при Вашия агент в ElevenLabs, agent_phone_number_id е phone_number_id на импортирания номер - връща го отговорът при импорта или можете да го прочетете от списъка Phone numbers.

Използвате собствен SIP клиент или PBX вместо ElevenLabs? Набирайте пълния sipUri директно, като обикновено SIP обаждане - това ограничение важи само за платформи, които искат чисто име без sip: префикса.

4. Какво следва

Телефонната мрежа приема обаждането под името volai_relay_2, прехвърля го към Вашата to и задава видимия идентификатор на обаждащия се на Вашата from - повиканият вижда на дисплея си Вашата линия във volai, а не вътрешното име на релейния слот (само ако номерът има собствени релейни имена - вижте Таксуване по-долу, иначе повиканият вижда демо номера на volai). Когато обаждането приключи, наемът се освобождава и минутите се таксуват точно като при обикновено изходящо обаждане - 0,92 kr/min (≈ 0,04 EUR), без такса за агент.

Отговорът, потвърждаващ обаждането, се връща едва след целия цикъл на звънене (лесно десетки секунди) - това не е грешка, макар кратък таймаут от Ваша страна да може да изглежда като такава, докато обаждането още звъни.

4Отстраняване на проблеми

Най-честите съобщения при собствен агент и какво да направите:

5Таксуване

Изходящо обаждане през релето се таксува по същата тарифа като обикновено изходящо обаждане - 0,92 kr/min (≈ 0,04 EUR) - без никаква такса за агент. Цените са без ДДС, както цялата ценова листа.

Едновременността е ограничена (вижте лимитите по-долу): най-много 1 активно обаждане на един от Вашите номера и най-много 2 на акаунт едновременно.

Повиканият вижда Вашата линия във volai само ако номерът има собствени релейни имена (relayNames) - номерът ги получава веднага след покупката. Докато ги няма, наемът се връща към общия пул и повиканият вижда демо номера на volai. Ако това продължи повече от час, свържете се с поддръжката.

6Лимити, квоти и сигурност

Ограничението е 1 активен наем на номер и най-много 2 на акаунт - преднамерена защита, за да не заеме един клиент целия общ пул от релейни слотове:

• from трябва да е Ваш собствен номер във volai - в противен случай from_number_not_owned. Без тази проверка бихте могли да подмените чужда линия като свой идентификатор на обаждащия се.
• Същите бариери като при обикновено обаждане - списък с номера, на които не се звъни (само обаждания, не SMS), автоматична 30-дневна блокада след 3 неуспешни опита към същия номер в рамките на 24 часа, линии с повишена тарифа, защита от цикли между номера на volai, заключване на номера на повиквания и общото ограничение на честотата на обажданията. Нищо от това не може да се заобиколи през релето.
• Пълен пул -> 503 capacity_busy - релейните слотове са общ лимит на едновременност за ЦЯЛАТА платформа, не само за Вашия акаунт. При capacity_busy нищо не се таксува, опитайте отново след малко.
• Пълната REST справка (кодове на грешки, GET/DELETE при наемите) е в справката за REST API.

Всяка грешка на API съдържа cause (кой я отстранява) и action (какво да се направи) - вижте Формат на грешките в справката за REST API.