> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # SIP-referens ## Översikt [SIP-trunkning](/docs/sv/eleven-agents/phone-numbers/sip-trunking) ansluter din befintliga telefoniinfrastruktur till ElevenLabs Agents. Konfigurationen omfattar protokoll, nätverksinställningar och ljudformat som använder specialiserad terminologi. Den här sidan förklarar dessa termer på ett enkelt språk. Använd den som referens när du läser guiden om SIP-trunkning eller felsöker en anslutning. Termerna är indelade i följande kategorier: * [Protokoll](#protocols) — standarderna som hanterar signalering och ljud. * [Transport och nätverk](#transport-and-networking) — hur paket skickas mellan system. * [Infrastrukturkomponenter](#infrastructure-components) — systemen som hanterar samtal. * [Samtalssignalering](#call-signaling) — meddelandena som upprättar och avslutar ett samtal. * [Autentisering och säkerhet](#authentication-and-security) — hur anslutningar verifieras och krypteras. * [Ljud och codecs](#audio-and-codecs) — hur tal kodas och överförs. * [Adressering och dirigering](#addressing-and-routing) — hur samtal hittar sin destination. * [ElevenLabs-konfiguration](#elevenlabs-configuration) — inställningar som är specifika för ElevenLabs-panelen. ## Protokoll **SIP (Session Initiation Protocol)** Signaleringsprotokollet som startar, ändrar och avslutar kommunikationssessioner i realtid, till exempel röstsamtal. SIP förhandlar om vem som ringer vem och hur ljudet ska utbytas, men överför inte själva ljudet. Det definieras i [RFC 3261](https://datatracker.ietf.org/doc/html/rfc3261). **SDP (Session Description Protocol)** Ett textformat i SIP-meddelanden som beskriver ett samtals media: vilka codecs varje sida stöder, IP-adresserna och portarna för ljudströmmen samt krypteringsparametrarna. De två ändpunkterna använder SDP för att komma överens om en gemensam konfiguration innan ljudet börjar överföras. **RTP (Real-time Transport Protocol)** Protokollet som överför det faktiska ljudet i ett samtal när SIP har upprättat det. RTP-paket skickas som en kontinuerlig ström och är känsliga för fördröjning och förlust, vilket är anledningen till att ljudkvaliteten beror på nätverksförhållandena. **SRTP (Secure RTP)** En krypterad version av RTP. När mediekryptering är aktiverad skyddas ljudströmmen med SRTP så att den inte kan avlyssnas under överföringen. Båda ändpunkterna måste ha stöd för SRTP för att krypterade medier ska fungera. **RTCP (RTP Control Protocol)** Ett kompletterande protokoll till RTP som rapporterar statistik som paketförlust och jitter, så att ändpunkter kan övervaka samtalskvaliteten. ## Transport och nätverk **UDP (User Datagram Protocol)** Ett snabbt, anslutningslöst transportprotokoll som skickar paket utan att garantera leverans eller ordning. RTP-ljud överförs via UDP eftersom låg latens är viktigare än perfekt leverans för direkttal. > **Note** > > UDP-transport för SIP-signalering är experimentell hos ElevenLabs. Använd TCP eller TLS för > produktionstrafik och välj endast UDP för testning. **TCP (Transmission Control Protocol)** Ett anslutningsorienterat transportprotokoll som garanterar ordnad och tillförlitlig leverans. ElevenLabs stöder TCP för SIP-signalering på port 5060. **TLS (Transport Layer Security)** Ett krypteringslager som körs ovanpå TCP. TLS-transport krypterar SIP-signalering så att autentiseringsuppgifter och samtalsmetadata inte kan läsas under överföringen. ElevenLabs stöder TLS för signalering på port 5061. **MTU (Maximum Transmission Unit)** Den största paketstorleken, i byte, som en nätverkslänk kan överföra utan att dela upp den i mindre delar. När ett SIP-meddelande via UDP överskrider MTU kan det fragmenteras eller tappas, vilket kan leda till fel när samtal upprättas. SIP-signalering som skickas via TCP eller TLS undviker detta problem eftersom dessa transportprotokoll hanterar stora meddelanden tillförlitligt. **NAT (Network Address Translation)** En teknik som routrar använder för att dela en offentlig IP-adress mellan många enheter i ett privat nätverk. NAT kan hindra RTP-ljud från att nå rätt enhet, vilket är en vanlig orsak till enkelriktat eller saknat ljud. **Latens** Fördröjningen mellan när ljud skickas och när det tas emot. Hög latens gör att samtal känns onaturliga eftersom varje sida måste vänta längre på att höra den andra. **Jitter** Variation i när ljudpaket anländer. Hög jitter orsakar hackigt eller förvrängt ljud även när den totala latensen är acceptabel. **Paketförlust** Andelen ljudpaket som aldrig kommer fram. Även små mängder paketförlust försämrar ljudkvaliteten eftersom RTP inte skickar om förlorade paket. **Port** En numrerad ändpunkt på en IP-adress som identifierar en specifik tjänst. SIP-signalering använder port 5060 för TCP och 5061 för TLS. RTP-media använder vanligtvis ett stort intervall av dynamiskt tilldelade portar. ## Infrastrukturkomponenter **SBC (Session Border Controller)** En enhet eller tjänst som finns i utkanten av ett nätverk för att hantera och säkra SIP-trafik. En SBC hanterar uppgifter som att skydda mot obehörig åtkomst, normalisera SIP-meddelanden mellan system som implementerar protokollet på olika sätt och hantera NAT-traversering. Många SIP-trunkleverantörer placerar en SBC mellan sitt nätverk och ditt. **PBX (Private Branch Exchange)** Ett privat telefonsystem som dirigerar samtal inom en organisation och ansluter dem till externa linjer. En SIP-aktiverad PBX kan ansluta till ElevenLabs via en SIP-trunk. **SIP-trunk** En virtuell anslutning mellan ditt telefonsystem och en rösttjänst som överför flera samtidiga samtal över internet i stället för fysiska telefonlinjer. En SIP-trunk är länken mellan din PBX eller leverantör och ElevenLabs. ## Samtalssignalering **SIP INVITE** SIP-meddelandet som begär ett nytt samtal. INVITE innehåller destinationsidentifieraren och en SDP-beskrivning av uppringarens mediekapacitet. **200 OK** SIP-svaret som bekräftar att en begäran lyckades. För en INVITE innehåller 200 OK den svarande sidans SDP och en `Contact`-adress som identifierar den exakta server som hanterar samtalet. **BYE** SIP-meddelandet som avslutar ett etablerat samtal. Ett BYE ska skickas till den `Contact`-adress som returneras i 200 OK så att det når samma server som hanterade samtalet. **Contact-header** Ett fält i ett SIP-svar som identifierar den exakta servern och adressen för uppföljande meddelanden inom samma samtal. ElevenLabs hanterar SIP-trafik från flera servrar bakom den gemensamma adressen `sip.rtc.elevenlabs.io`, så om senare begäranden, till exempel ett BYE, skickas till den gemensamma adressen i stället för `Contact`-adressen kan de nå en annan server. **Dialog** Det gemensamma tillstånd som två ändpunkter upprätthåller under ett samtal. Om ett meddelande som ett BYE når en server som saknar information om dialogen avvisar servern det. **Svarskoder** Tresiffriga tal som anger resultatet av en SIP-begäran, på samma sätt som HTTP-statuskoder. Koder i intervallet `1xx` är preliminära och rapporterar förlopp: `100` (Trying) bekräftar att begäran har tagits emot och bearbetas, och `180` (Ringing) signalerar att destinationen avisieras. Slutliga svar rapporterar resultatet: `200` (OK) betyder att begäran lyckades, `401` och `407` anger att autentisering krävs och `481` betyder att servern inte har någon matchande dialog för begäran. ## Autentisering och säkerhet **Digest-autentisering** En autentiseringsmetod som verifierar en anslutning med användarnamn och lösenord utan att skicka lösenordet i klartext. ElevenLabs rekommenderar digest-autentisering eftersom den inte är beroende av fasta IP-adresser. **ACL (Access Control List)** En autentiseringsmetod som baseras på att tillåtslista betrodda IP-adresser. Med ACL-autentisering accepterar ett system SIP-trafik endast från godkända källadresser. Den kan vara svårare att hantera när IP-adresser ändras. **Mediekryptering** Skyddet som tillämpas på RTP-ljudströmmen med SRTP. ElevenLabs erbjuder tre inställningar: `Disabled` (ingen kryptering), `Allowed` (krypterar när båda sidor stöder det) och `Required` (avvisar samtal som inte kan krypteras). **Certifikat** Ett digitalt X.509-dokument som bevisar en servers identitet under en TLS-handskakning. Sidan som accepterar anslutningen fungerar som TLS-server och presenterar certifikatet. Sidan som öppnar anslutningen fungerar som TLS-klient och validerar det mot en betrodd certifikatutfärdare genom att kontrollera värdnamnet och utgångsdatumet. Roller skiljer sig åt beroende på samtalsriktning: * **Inkommande samtal till ElevenLabs**: ditt system öppnar anslutningen, så ElevenLabs fungerar som TLS-server och presenterar ett certifikat för `sip.rtc.elevenlabs.io`, som ditt system validerar. * **Utgående samtal från ElevenLabs**: ElevenLabs öppnar anslutningen, så din SIP-server eller SBC fungerar som TLS-server och måste presentera ett giltigt, betrott certifikat som ElevenLabs validerar. **Krypteringssvit** Den uppsättning algoritmer som en TLS-anslutning använder för att utbyta nycklar, kryptera data och verifiera integritet. Under handskakningen erbjuder TLS-klienten de krypteringssviter den stöder och TLS-servern väljer en som båda har gemensamt. ElevenLabs kräver TLS 1.2 eller senare. För inkommande samtal till ElevenLabs väljer ElevenLabs (som TLS-server) sviten. För utgående samtal från ElevenLabs väljer ditt system (som TLS-server) den. Båda sidor måste ha minst en modern krypteringssvit gemensamt, annars misslyckas handskakningen innan samtalet ansluts. ## Ljud och codecs **Codec** En algoritm som komprimerar ljud för överföring och dekomprimerar det i andra änden. Båda ändpunkterna måste ha stöd för en gemensam codec för att ett samtal ska ha ljud. **G711** En allmänt stödd, okomprimerad codec som överför ljud med en samplingsfrekvens på 8 kHz. Det är det mest kompatibla valet mellan telefonsystem. **G722** En bredbandscodec som överför ljud med en samplingsfrekvens på 16 kHz och ger tydligare tal än G711 när båda ändpunkterna stöder den. **Samplingsfrekvens** Hur många gånger per sekund ljud mäts, uttryckt i kilohertz (kHz). ElevenLabs SIP-distribution skickar och tar emot ljud som G711 vid 8 kHz eller G722 vid 16 kHz. System som använder andra frekvenser måste sampla om ljudet. **DTMF (Dual-Tone Multi-Frequency)** Tonerna som skapas när du trycker på knappar på en telefonknappsats och används för att navigera i automatiserade menyer. Se [DTMF-indata](/docs/sv/eleven-agents/customization/multimodal-input#dtmf-input) för information om hur agenter tar emot siffror från knappsatsen, och [spela upp knappsatston](/docs/sv/eleven-agents/customization/tools/system-tools/play-keypad-touch-tone) för information om hur agenter skickar DTMF. ## Adressering och dirigering **SIP URI** Adressen som används för att nå en SIP-destination, skriven som `sip:identifier@domain:port`. Till exempel dirigerar `sip:+19991234567@sip.rtc.elevenlabs.io:5060` ett samtal till identifieraren `+19991234567`. Identifieraren krävs för att samtalet ska kunna dirigeras. **E.164** Den internationella standarden för telefonnummerformat, som består av ett inledande `+`, en landskod och abonnentnumret, till exempel `+15551234567`. Formatet måste matcha mellan din SIP URI och ditt importerade telefonnummer. **NAPTR- och SRV-poster** DNS-posttyper som låter ett SIP-system upptäcka vilka servrar, transportprotokoll och portar som ska användas för en domän. ElevenLabs publicerar NAPTR- och SRV-poster för serveridentifiering som följer [RFC 3263](https://datatracker.ietf.org/doc/html/rfc3263). ## ElevenLabs-konfiguration **Transporttyp** Protokollet som väljs för SIP-signalering i panelen. ElevenLabs stöder `TCP` (port 5060) och `TLS` (port 5061). TLS rekommenderas för produktion eftersom det krypterar signaleringen. **Konfiguration för inkommande samtal** Inställningarna som styr hur samtal från din SIP-trunk når ElevenLabs, inklusive transporttyp och mediekryptering som tillämpas på inkommande samtal. **Konfiguration för utgående samtal** Inställningarna som styr hur ElevenLabs skickar samtal till ditt system, inklusive `Address` (ett värdnamn eller en IP-adress utan prefixet `sip:`) dit SIP INVITE levereras. **Anpassade headers** Ytterligare SIP-headerfält med prefixet `X-` som du kan lägga till i samtal för dirigering, identifiering eller leverantörsspecifika krav. Anpassade headers för inkommande samtal exponeras också som [dynamiska variabler](/docs/sv/eleven-agents/customization/personalization/dynamic-variables) i konversationen. Headers för utgående INVITE konfigureras med det statiska fältet `headers` på `outbound_trunk_config`. **User-to-User Information (UUI)** En liten applikationsnyttolast som utbyts i SIP-headern `User-to-User` ([RFC 7433](https://www.rfc-editor.org/rfc/rfc7433)) och ofta används av kontaktcenterplattformar som Talkdesk och Genesys Cloud. Vid **inkommande** samtal, när INVITE innehåller en `User-to-User`-header, exponeras dess värde för agenten som två [dynamiska variabler](/docs/sv/eleven-agents/customization/personalization/dynamic-variables): `{{sip_uui_raw}}` (det råa headervärdet) och `{{sip_uui_data}}` (den avkodade nyttolasten — hexavkodad, med protokolldiskriminatoroktetten borttagen när headern innehåller `purpose=isdn-uui`). Vid **utgående** samtal läggs UUI till i SIP REFER-överföringar som riktas till en SIP URI via överföringsregelns inställning `uui` — se [Överför till nummer](/docs/sv/eleven-agents/customization/tools/system-tools/transfer-to-number). **Attribut till headers** En inställning som endast är tillgänglig via API på `inbound_trunk_config` och `outbound_trunk_config` och som mappar namn på dynamiska variabler till SIP-headernamn för BYE-begäranden. Varje nyckel är ett namn på en dynamisk variabel och varje värde är namnet på headern som ska inkluderas när samtalet avslutas. Headervärdet är variabelns slutliga värde i slutet av konversationen. Se [BYE-headers från dynamiska variabler](/docs/sv/eleven-agents/phone-numbers/sip-trunking#bye-headers-from-dynamic-variables). **Fjärrdomäner** En telefonnummerinställning som listar de domäner ElevenLabs accepterar vid validering av ditt TLS-certifikat i uppföljande anslutningar som vi initierar, till exempel ett `BYE` eller `REFER`. Eftersom ElevenLabs ofta ansluter till en IP-adress från den översta `Via`-headern i stället för ett värdnamn kan vi inte matcha certifikatet enbart efter värdnamn. Om någon domän som det mottagna certifikatet är giltigt för matchar en konfigurerad fjärrdomän lyckas valideringen, annars misslyckas den. Se [uppföljande anslutningar](/docs/sv/eleven-agents/phone-numbers/sip-trunking#follow-up-connections). **SIP-servrar med statisk IP** Ett företagsalternativ som tillhandahåller SIP-ändpunkter med fasta IP-intervall för kunder vars säkerhetspolicy kräver IP-tillåtslistor. Läs [guiden om SIP-trunkning](/docs/sv/eleven-agents/phone-numbers/sip-trunking) för mer information. ## Nästa steg * [Konfigurera SIP-trunkning](/docs/sv/eleven-agents/phone-numbers/sip-trunking) * [Läs om hur du skapar ElevenLabs-agenter](/docs/sv/eleven-agents/quickstart)