ElevenLabs агент на чешки номер през SIP

Вече ли имате собствен агент ElevenLabs Conversational AI и искате да му дадете чешки телефонен номер? Няма специален трик: насочвате номер на volai към SIP trunk на платформата на Вашия агент. Входящата посока е лесната част - една PATCH заявка към маршрутизацията на номера. Изходящата работи малко по-различно, защото ElevenLabs (като повечето платформи за гласов AI) не може да държи телефонна линия постоянно регистрирана като SIP клиент - само изстрелва едно удостоверено обаждане, затова обаждането минава през краткотрайна релейна връзка. Голямата разлика спрямо вградения агент на volai: при изходящи обаждания изобщо пропускате надбавката за агент от 2,50 kr/мин. (≈ 0,10 EUR) - агентът е Ваш (и го плащате Вие) във Вашето собствено работно пространство в ElevenLabs.

Кога собственият агент има повече смисъл от вградения?

И двата маршрута се таксуват от един и същ номер във volai и един и същ баланс - променя се кой води разговора и колко струва отгоре:

С други думи: собственият агент се отплаща, щом вече имате работещ агент в ElevenLabs със своя заявка, инструменти и глас и просто Ви трябва чешки номер към него. Започвате от нулата само с една системна заявка и без отделно работно пространство в ElevenLabs за управление? По-бързият път е вграденият агент на volai - една API заявка го настройва, а преписът и резюмето са включени в надбавката за агент, без отделна настройка.

Какво ще Ви трябва?

• Акаунт във volai с чешки номер в него, плюс API ключ (vk_...) - вземате го от портала, под API и MCP.
• Агент ElevenLabs Conversational AI, вече създаден във ВАШЕТО собствено работно пространство - този наръчник го свързва с номер, не го създава вместо Вас.
• Баланс в акаунта Ви във volai - обажданията се удържат от него точно както при вградения агент.

Стъпка 1: Свържете входящите обаждания

Насочете маршрутизацията на номера към mode: "sip" със sipUri, зададен на адреса, на който ElevenLabs очаква обаждания при внос на SIP trunk:

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": "My own agent",
  "inbound_trunk_config": {
    "allowed_addresses": ["81.31.45.0/24"],
    "media_encryption": "allowed"
  }
}

Таксува се само входящата минута (0,50 kr/мин. (≈ 0,02 EUR)), без надбавка отгоре - същото правило, което следват и вграденият агент, и обикновеният софтфон.

Стъпка 2: Свържете изходящите обаждания през релето

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

2.1 Насочете ElevenLabs към Вашата линия

Вземете 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 е за обикновен софтфон (вижте страницата за SIP), но ElevenLabs има нужда от полето outboundTrunkAddress (sip.volai.cz), а не от server - ако го замените с него, получавате грешка 1011 sip request timed out - адресът на изходящия trunk трябва да е точно тази стойност, иначе обаждането не се маршрутизира в мрежата.

След това го задайте като outbound_trunk_config на този номер в ElevenLabs (Settings → Phone Numbers → Вашият номер → Outbound calling), точно в тази форма:

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

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

2.3 Кажете на агента да набира sipName, а не пълния SIP URI

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

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

Какво се случва, след като обаждането тръгне

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

Ограничения и сигурност

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

Пълният REST справочник (кодове на грешки, GET/DELETE над наемите) е в справочника за REST API; пълният наръчник - обхващащ входящи и изходящи обаждания за всяка платформа, не само за ElevenLabs - е на страницата Собствен агент.

Кога да останете при вградения агент?

Откровено казано: собственият агент означава повече подвижни части - отделен акаунт и сметка в ElevenLabs, без автоматичен препис или резюме в портала на volai и допълнителна стъпка преди всяко изходящо обаждане (създаване на релеен наем). Ако една добра системна заявка покрива нуждите Ви и предпочитате да приключите за минути, вместо да управлявате втори акаунт в платформа, вграденият агент на volai Ви води дотам с една API заявка - а надбавката от 2,50 kr/мин. (≈ 0,10 EUR) купува автоматичен препис, резюме и разпознаване на гласова поща при всяко обаждане, без допълнителна настройка.

За пълното ценово сравнение с Twilio и други доставчици вижте страницата с цените; наръчникът за интеграцията с ElevenLabs, с връзки към собствената им документация, е на страницата Интеграции.

Какво следва