Skip to navigation
ImplementerenTelefonie

SIP-referentie

Een woordenlijst met SIP-, netwerk- en audiotermen die worden gebruikt bij het configureren van SIP-trunking met ElevenLabs Agents.

Overzicht

SIP-trunking verbindt je bestaande telefonie-infrastructuur met ElevenLabs Agents. Voor de configuratie zijn protocollen, netwerkinstellingen en audioformats met gespecialiseerde terminologie nodig.

Deze pagina legt deze termen in begrijpelijke taal uit. Gebruik deze als naslagwerk bij het lezen van de gids voor SIP-trunking of het oplossen van verbindingsproblemen.

De termen zijn ingedeeld in de volgende categorieën:

Protocollen

SIP (Session Initiation Protocol)

Het signaleringsprotocol dat realtime communicatiesessies, zoals telefoongesprekken, start, wijzigt en beëindigt. SIP onderhandelt over wie met wie belt en hoe de audio moet worden uitgewisseld, maar vervoert de audio zelf niet. Het is gedefinieerd in RFC 3261.

SDP (Session Description Protocol)

Een tekstformat in SIP-berichten dat de media van een gesprek beschrijft: welke codecs beide kanten ondersteunen, de IP-adressen en poorten voor de audiostream en de versleutelingsparameters. De twee endpoints gebruiken SDP om overeenstemming te bereiken over een gemeenschappelijke configuratie voordat audio wordt verzonden.

RTP (Real-time Transport Protocol)

Het protocol dat de daadwerkelijke audio van een gesprek vervoert nadat SIP het heeft opgezet. RTP-pakketten reizen als een doorlopende stream en zijn gevoelig voor vertraging en verlies. Daarom is de audiokwaliteit afhankelijk van de netwerkcondities.

SRTP (Secure RTP)

Een versleutelde versie van RTP. Wanneer mediaversleuteling is ingeschakeld, wordt de audiostream beschermd met SRTP zodat deze onderweg niet kan worden onderschept. Beide endpoints moeten SRTP ondersteunen om versleutelde media te laten werken.

RTCP (RTP Control Protocol)

Een aanvullend protocol voor RTP dat statistieken zoals pakketverlies en jitter rapporteert, zodat endpoints de gesprekskwaliteit kunnen monitoren.

Transport en netwerken

UDP (User Datagram Protocol)

Een snel, verbindingsloos transport dat pakketten verstuurt zonder levering of volgorde te garanderen. RTP-audio wordt via UDP vervoerd omdat lage latentie voor live spraak belangrijker is dan perfecte aflevering.

UDP-transport voor SIP-signalering is experimenteel bij ElevenLabs. Gebruik TCP of TLS voor productie- verkeer en kies UDP alleen voor tests.

TCP (Transmission Control Protocol)

Een verbindingsgericht transport dat geordende, betrouwbare levering garandeert. ElevenLabs ondersteunt TCP voor SIP-signalering op poort 5060.

TLS (Transport Layer Security)

Een versleutelingslaag die boven op TCP draait. TLS-transport versleutelt SIP-signalering zodat credentials en metagegevens van gesprekken onderweg niet kunnen worden gelezen. ElevenLabs ondersteunt TLS voor signalering op poort 5061.

MTU (Maximum Transmission Unit)

De grootste pakketgrootte, in bytes, die een netwerkverbinding kan vervoeren zonder deze in kleinere delen op te splitsen. Wanneer een SIP-bericht via UDP groter is dan de MTU, kan het worden gefragmenteerd of verloren gaan, wat kan leiden tot fouten bij het opzetten van gesprekken. SIP-signalering via TCP of TLS voorkomt dit probleem, omdat deze transportprotocollen grote berichten betrouwbaar afhandelen.

NAT (Network Address Translation)

Een techniek die routers gebruiken om één openbaar IP-adres te delen met veel apparaten in een privénetwerk. NAT kan voorkomen dat RTP-audio het juiste apparaat bereikt. Dit is een veelvoorkomende oorzaak van eenrichtingsaudio of ontbrekende audio.

Latentie

De vertraging tussen het verzenden en ontvangen van audio. Hoge latentie zorgt ervoor dat gesprekken onnatuurlijk aanvoelen, omdat beide kanten langer moeten wachten om de ander te horen.

Jitter

Variatie in de aankomsttijd van audiopakketten. Hoge jitter veroorzaakt haperende of vervormde audio, zelfs wanneer de algemene latentie acceptabel is.

Pakketverlies

Het percentage audiopakketten dat nooit aankomt. Zelfs kleine hoeveelheden pakketverlies verslechteren de audiokwaliteit, omdat RTP verloren pakketten niet opnieuw verstuurt.

Poort

Een genummerd endpoint op een IP-adres dat een specifieke service identificeert. SIP-signalering gebruikt poort 5060 voor TCP en 5061 voor TLS; RTP-media gebruiken doorgaans een breed bereik van dynamisch toegewezen poorten.

Infrastructuurcomponenten

SBC (Session Border Controller)

Een apparaat of service aan de rand van een netwerk voor het beheren en beveiligen van SIP-verkeer. Een SBC verwerkt taken zoals bescherming tegen ongeautoriseerde toegang, het normaliseren van SIP-berichten tussen systemen die het protocol verschillend implementeren, en het beheren van NAT-traversal. Veel SIP-trunkproviders plaatsen een SBC tussen hun netwerk en dat van jou.

PBX (Private Branch Exchange)

Een privételefoonsysteem dat gesprekken binnen een organisatie routeert en met externe lijnen verbindt. Een SIP-compatibele PBX kan via een SIP-trunk verbinding maken met ElevenLabs.

SIP-trunk

Een virtuele verbinding tussen je telefoniesysteem en een spraakservice die meerdere gelijktijdige gesprekken via internet vervoert in plaats van via fysieke telefoonlijnen. Een SIP-trunk verbindt je PBX of provider met ElevenLabs.

Gesprekssignalering

SIP INVITE

Het SIP-bericht waarmee een nieuw gesprek wordt aangevraagd. De INVITE bevat de bestemmings-ID en een SDP-beschrijving van de mediamogelijkheden van de beller.

200 OK

Het SIP-antwoord dat bevestigt dat een verzoek is geslaagd. Voor een INVITE bevat de 200 OK de SDP van de antwoordende kant en een Contact-adres dat de exacte server identificeert die het gesprek afhandelt.

BYE

Het SIP-bericht waarmee een bestaand gesprek wordt beëindigd. Een BYE moet worden verstuurd naar het Contact-adres dat in de 200 OK is teruggegeven, zodat het dezelfde server bereikt die het gesprek heeft afgehandeld.

Contact header

Een veld in een SIP-antwoord dat de exacte server en het adres voor vervolgberichten binnen hetzelfde gesprek identificeert. ElevenLabs verwerkt SIP-verkeer via meerdere servers achter het gedeelde adres sip.rtc.elevenlabs.io. Als je latere verzoeken, zoals een BYE, naar dat gedeelde adres stuurt in plaats van naar het Contact-adres, kunnen ze daardoor een andere server bereiken.

Dialog

De gedeelde status die twee endpoints tijdens een gesprek behouden. Als een bericht zoals een BYE een server bereikt die geen gegevens over de dialog heeft, wijst de server het af.

Response codes

Driecijferige getallen die het resultaat van een SIP-verzoek aangeven, vergelijkbaar met HTTP-statuscodes. Codes in het bereik 1xx zijn voorlopig en rapporteren voortgang: 100 (Trying) bevestigt dat het verzoek is ontvangen en verwerkt wordt, en 180 (Ringing) geeft aan dat de bestemming wordt gewaarschuwd. Definitieve antwoorden rapporteren de uitkomst: 200 (OK) betekent succes, 401 en 407 geven aan dat authenticatie vereist is en 481 betekent dat de server geen overeenkomende dialog voor het verzoek heeft.

Authenticatie en beveiliging

Digest authentication

Een authenticatiemethode die een verbinding verifieert met een gebruikersnaam en wachtwoord, zonder het wachtwoord als platte tekst te versturen. ElevenLabs raadt digest authentication aan omdat deze niet afhankelijk is van vaste IP-adressen.

ACL (Access Control List)

Een authenticatiemethode die is gebaseerd op het toestaan van vertrouwde IP-adressen. Met ACL-authenticatie accepteert een systeem SIP-verkeer alleen van goedgekeurde bronadressen. Dit kan lastiger te beheren zijn wanneer IP-adressen veranderen.

Mediaversleuteling

De bescherming die met SRTP op de RTP-audiostream wordt toegepast. ElevenLabs biedt drie instellingen: Disabled (geen versleuteling), Allowed (versleutelt wanneer beide kanten dit ondersteunen) en Required (wijst gesprekken af die niet kunnen worden versleuteld).

Certificaat

Een digitaal X.509-document dat de identiteit van een server bewijst tijdens een TLS-handshake. De kant die de verbinding accepteert, fungeert als TLS-server en presenteert het certificaat; de kant die de verbinding opent, fungeert als TLS-client en valideert dit bij een vertrouwde certificeringsinstantie, waarbij de hostname en vervaldatum worden gecontroleerd. De rollen verschillen per gespreksrichting:

  • Inkomende gesprekken naar ElevenLabs: je systeem opent de verbinding, dus ElevenLabs fungeert als TLS-server en presenteert een certificaat voor sip.rtc.elevenlabs.io, dat je systeem valideert.
  • Uitgaande gesprekken van ElevenLabs: ElevenLabs opent de verbinding, dus je SIP-server of SBC fungeert als TLS-server en moet een geldig, vertrouwd certificaat presenteren dat ElevenLabs valideert.

Cipher suite

De verzameling algoritmen die een TLS-verbinding gebruikt om sleutels uit te wisselen, gegevens te versleutelen en integriteit te verifiëren. Tijdens de handshake biedt de TLS-client de cipher suites aan die deze ondersteunt en selecteert de TLS-server er een die beide delen. ElevenLabs vereist TLS 1.2 of hoger. Voor inkomende gesprekken naar ElevenLabs selecteert ElevenLabs (als TLS-server) de suite; voor uitgaande gesprekken van ElevenLabs selecteert je systeem (als TLS-server) deze. Beide kanten moeten minstens één moderne cipher suite delen, anders mislukt de handshake voordat het gesprek verbinding maakt.

Audio en codecs

Codec

Een algoritme dat audio comprimeert voor verzending en deze aan de andere kant decomprimeert. Beide endpoints moeten een gemeenschappelijke codec ondersteunen voordat een gesprek audio heeft.

G711

Een breed ondersteunde, ongecomprimeerde codec die audio vervoert met een sample rate van 8 kHz. Dit is de meest compatibele keuze voor telefoniesystemen.

G722

Een wideband-codec die audio vervoert met een sample rate van 16 kHz en duidelijkere spraak biedt dan G711 wanneer beide endpoints deze ondersteunen.

Sample rate

Hoe vaak audio per seconde wordt gemeten, uitgedrukt in kilohertz (kHz). De SIP-deployment van ElevenLabs verzendt en ontvangt audio als G711 op 8 kHz of G722 op 16 kHz. Systemen die andere rates gebruiken, moeten de audio resamplen.

DTMF (Dual-Tone Multi-Frequency)

De tonen die ontstaan wanneer je op toetsen van een telefoontoetsenblok drukt en die worden gebruikt om geautomatiseerde menu’s te navigeren. Zie DTMF-invoer voor hoe agents cijfers van een toetsenblok ontvangen, en toetsenbloktoon afspelen voor hoe agents DTMF verzenden.

Adressering en routing

SIP URI

Het adres waarmee je een SIP-bestemming bereikt, geschreven als sip:identifier@domain:port. Bijvoorbeeld: sip:+19991234567@sip.rtc.elevenlabs.io:5060 routeert een gesprek naar de identifier +19991234567. De identifier is vereist om het gesprek te kunnen routeren.

E.164

De internationale standaard voor telefoonnummeropmaak, bestaande uit een voorloopteken +, een landcode en het abonneenummer, bijvoorbeeld +15551234567. De opmaak moet overeenkomen in je SIP URI en je geïmporteerde telefoonnummer.

NAPTR- en SRV-records

DNS-recordtypen waarmee een SIP-systeem kan ontdekken welke servers, transportprotocollen en poorten voor een domein moeten worden gebruikt. ElevenLabs publiceert NAPTR- en SRV-records voor serverdetectie volgens RFC 3263.

ElevenLabs-configuratie

Transporttype

Het protocol dat in het dashboard is geselecteerd voor SIP-signalering. ElevenLabs ondersteunt TCP (poort 5060) en TLS (poort 5061). TLS wordt aanbevolen voor productie omdat het signalering versleutelt.

Inkomende configuratie

De instellingen die bepalen hoe gesprekken vanuit je SIP-trunk ElevenLabs bereiken, waaronder het transporttype en de mediaversleuteling die wordt toegepast op inkomende gesprekken.

Uitgaande configuratie

De instellingen die bepalen hoe ElevenLabs gesprekken naar je systeem verstuurt, waaronder het Address (een hostname of IP-adres, zonder het voorvoegsel sip:) waar de SIP INVITE wordt afgeleverd.

Custom headers

Extra SIP-headervelden met het voorvoegsel X- die je voor routing, identificatie of providerspecifieke vereisten aan gesprekken kunt toevoegen. Inkomende custom headers zijn ook beschikbaar als dynamische variabelen in het gesprek. Uitgaande INVITE-headers worden geconfigureerd met het statische veld headers op outbound_trunk_config.

User-to-User Information (UUI)

Een kleine application payload die wordt uitgewisseld in de SIP-header User-to-User (RFC 7433), vaak gebruikt door contactcenterplatforms zoals Talkdesk en Genesys Cloud. Bij inkomende gesprekken wordt de waarde van een User-to-User-header in de INVITE aan de agent beschikbaar gesteld als twee dynamische variabelen: {{sip_uui_raw}} (de onbewerkte headerwaarde) en {{sip_uui_data}} (de gedecodeerde payload — hex-gedecodeerd, waarbij het protocol-discriminator-octet wordt verwijderd als de header purpose=isdn-uui bevat). Bij uitgaande gesprekken wordt UUI gekoppeld aan SIP REFER-transfers die via de instelling uui van de transferregel een SIP URI als doel hebben — zie Naar nummer doorverbinden.

Attributes to headers

Een instelling die alleen via de API beschikbaar is op inbound_trunk_config en outbound_trunk_config en die namen van dynamische variabelen toewijst aan SIP-headernamen voor BYE-verzoeken. Elke sleutel is een naam van een dynamische variabele; elke waarde is de headernaam die moet worden opgenomen wanneer het gesprek eindigt. De headerwaarde is de uiteindelijke waarde van de variabele aan het einde van het gesprek. Zie BYE-headers uit dynamische variabelen.

Remote domains

Een telefoonnummerinstelling die de domeinen vermeldt die ElevenLabs accepteert bij het valideren van je TLS-certificaat voor vervolgverbindingen die het initieert, bijvoorbeeld een BYE of REFER. Omdat ElevenLabs vaak verbinding maakt met een IP-adres uit de bovenste Via-header in plaats van met een hostname, kan het certificaat niet alleen op hostname worden gematcht. Als een domein waarvoor het ontvangen certificaat geldig is, overeenkomt met een geconfigureerd remote domain, slaagt de validatie; anders mislukt deze. Zie vervolgverbindingen.

Static IP SIP servers

Een enterpriseoptie die SIP-endpoints met vaste IP-bereiken biedt voor klanten wier beveiligingsbeleid IP-allowlisting vereist. Zie de gids voor SIP-trunking voor meer informatie.

Volgende stappen