Guider

SIP

När en röstagent eller enkel vidarekoppling inte räcker och numret ska kopplas till en egen softphone eller telefonväxel (PBX) behövs en SIP-trunkleverantör - volai är en sådan. Den här sidan är en guide steg för steg.

1Inkommande samtal till din SIP-server

Sätt numrets routing till mode: "sip" och ange din sipUri - därifrån går samtalet direkt till dig, inte till vårt agenterbjudande eller vidarekoppling:

curl -X PATCH "https://volai.eu/v1/numbers/+420601234567" \
  -H "Authorization: Bearer vk_DIN_NYCKEL" \
  -H "Content-Type: application/json" \
  -d '{"routing": {"mode": "sip", "sipUri": "sip:reception@din-server.se"}}'

Bara den inkommande minuten debiteras (0,50 kr/min (≈ 0,23 SEK)), ingen agent tillkommer - den fullständiga formen på förfrågan och övriga routinglägen finns i REST API-referensen.

Autentisering på din växel

Samtalet till din SIP-server skickar vi först som en oautentiserad INVITE till sipUri. En växel som svarar på den med en inloggningsutmaning (401/407) och utan ytterligare uppgifter avvisar samtalet får det inte i den här formen - utmaningen har ingen som kan besvara den. Fyll därför i även sipUsername och sipPassword i routingen - när båda är ifyllda loggar vårt nät in på målet (SIP digest) och slår det anropade numret. Verifierat med ett live-samtal till ett inbyggt SIP-nummer hos Vapi, som godtar inloggningsuppgifter oavsett innehåll. Om samtalet kopplas även av din växel beror på den - den måste verkligen svara på INVITE med en utmaning och godkänna det angivna namnet och lösenordet; det garanterar vi inte för varje växel (i testet lyckades det till exempel inte mot Twilios SIP-domän). Utan sipUsername och sipPassword förblir routingen i dagens oautentiserade form. Inloggningen läggs till i routingen så här:

curl -X PATCH "https://volai.eu/v1/numbers/+420601234567" \
  -H "Authorization: Bearer vk_DIN_NYCKEL" \
  -H "Content-Type: application/json" \
  -d '{"routing": {"mode": "sip", "sipUri": "sip:reception@din-server.se", "sipUsername": "reception", "sipPassword": "hemligtlosenord123"}}'

Det anropade numret skickar vi alltid exakt i den form det har i sipUri före snabel-a - vi lägger varken till eller tar bort något riktnummer eller någon nolla, så målväxeln måste kunna hantera exakt det som skrivs där.

sipUsername och sipPassword får inte innehålla kolon, snabel-a, mellanslag, citattecken eller omvänt snedstreck och får vara högst 64 tecken vardera.

Det går inte att fylla i bara ett av fälten - API:t returnerar felet „Please fill in both username and password, or leave both empty.“.

Kolon i användardelen av sipUri (före snabel-a) och port i värden (efter kolon vid servern, t.ex. :5060) stöds ännu inte tillsammans med ifyllda sipUsername och sipPassword - båda ger samma hårda fel. Utan inloggningsuppgifter fungerar båda oförändrat.

Undantag: BYO SIP-trunk hos Vapi (adress <credentialId>.sip.vapi.ai, för en organisation i EU-regionen <credentialId>.sip.eu.vapi.ai) använder inte inloggningsuppgifter. Vapi känner igen våra samtal på IP-adressen i trunkens gateways, och med ifyllda sipUsername och sipPassword skulle samtalet inte kopplas, därför avvisar API:t sådan routing med koden validation. Det gäller inte Vapis inbyggda SIP-nummer (sip:<namn>@sip.vapi.ai).

2Numrets SIP-uppgifter

Linjens inloggningsuppgifter hämtas med ett enda anrop:

curl "https://volai.eu/v1/numbers/+420601234567/sip" \
  -H "Authorization: Bearer vk_DIN_NYCKEL"

{
  "server": "sip.volai.cz",
  "username": "123456",
  "password": "a1b2c3d4e5f6",
  "outboundTrunkAddress": "sip.volai.cz",
  "port": 5060,
  "transport": "tcp",
  "inboundSignallingCidrs": ["81.31.45.0/24"]
}

Inställning i softphone (Zoiper, Linphone)

I båda apparna anges i princip samma sak, bara med olika namn - leta efter „Lägg till konto“ / „SIP-konto“:

Efter att inställningarna sparats bör softphonen registrera sig (statusikon „online“/„registrerad“) och samtal till numret börjar ringa direkt i den.

3Utgående samtal via SIP-klient

När softphonen är registrerad kan den själv ringa ut via den här linjen - inget av våra API behöver anropas, samtalen ringas direkt från klienten som från en vanlig telefonlinje.

4Begränsningar

• En registrering per linje - en uppsättning inloggningsuppgifter klarar en registrerad enhet åt gången. Loggar en andra klient in tappar den första sannolikt sin registrering - lita inte på flera enheter samtidigt på en linje.
• Utgående från en egen agent ja, full trunk-peering nej - linjens inloggningsuppgifter finns för att DIN klient ska registrera sig hos OSS som en telefon. Utgående samtal från en egen röstagent (ElevenLabs eller annan plattform) FUNGERAR däremot idag - via relay, se Egen agent. Fortfarande går det dock inte att ansluta din växel som en jämbördig operatör med egen routing av INKOMMANDE samtal utifrån - använd i så fall routingen forward till numret på din växel.
• Bara röst - ingen video och inga andra SIP-tillägg.