SIP-trunking

Overzicht

Met SIP-trunking (Session Initiation Protocol) kun je je bestaande telefonie-infrastructuur rechtstreeks verbinden met ElevenLabs Agents. Met deze integratie kunnen alle klanten hun bestaande telefoonsystemen gebruiken en tegelijkertijd profiteren van de geavanceerde voice AI-mogelijkheden van ElevenLabs.

Met SIP-trunking kun je:

• Je Private Branch Exchange (PBX) of SIP-compatibele telefoonsysteem verbinden met het voice AI-platform van ElevenLabs
• Gesprekken naar AI-agents routeren zonder je bestaande telefooninfrastructuur te wijzigen
• Zowel inkomende als uitgaande gesprekken afhandelen
• Versleuteld TLS-transport en mediaversleuteling gebruiken voor betere beveiliging

Hoe SIP-trunking werkt

SIP-trunking brengt een directe verbinding tot stand tussen je telefonie-infrastructuur en het ElevenLabs-platform:

1. Inkomende gesprekken: Gesprekken vanaf je SIP-trunk worden met je geconfigureerde SIP INVITE-adres naar het ElevenLabs-platform gerouteerd.
2. Uitgaande gesprekken: Gesprekken die door ElevenLabs worden gestart, worden met je geconfigureerde hostname naar je SIP-trunk gerouteerd, zodat je agents uitgaande gesprekken kunnen voeren.
3. Authenticatie: De beveiliging van de signaleringsverbinding wordt gehandhaafd via digest authentication (gebruikersnaam/wachtwoord) of Access Control List-authenticatie (ACL) op basis van het bron-IP voor signalering.
4. Signalering en media: De eerste gespreksopzet (signalering) ondersteunt meerdere transportprotocollen, waaronder TLS voor versleutelde communicatie. Zodra het gesprek tot stand is gebracht, kunnen de daadwerkelijke audiogegevens (RTP-stream) worden versleuteld op basis van je instellingen voor mediaversleuteling.

Transportbeveiliging: certificaten en cipher suites

Wanneer je TLS-transport gebruikt, voeren beide kanten een TLS-handshake uit voordat SIP-signalering wordt uitgewisseld. Tijdens de handshake valideren ze een certificaat en onderhandelen ze over een cipher suite. 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 het. ElevenLabs vereist TLS 1.2 of hoger.

De rollen zijn afhankelijk van de richting van de oproep:

• Inkomende oproepen naar ElevenLabs: Je systeem opent de verbinding, dus ElevenLabs fungeert als TLS-server. ElevenLabs presenteert een geldig certificaat voor sip.rtc.elevenlabs.io, en je systeem valideert dit als TLS-client.
• Uitgaande oproepen vanuit ElevenLabs: ElevenLabs opent de verbinding met het adres dat je hebt geconfigureerd, dus je SIP-server of SBC fungeert als TLS-server. Je systeem moet een geldig, vertrouwd certificaat presenteren, dat ElevenLabs als TLS-client valideert.

Zorg dat beide kanten elkaars certificaten vertrouwen en minstens één gemeenschappelijke cipher suite delen. Als dat niet zo is, mislukt de TLS-handshake voordat de oproep tot stand komt. Bekijk de SIP-referentie voor definities van deze termen.

Vervolgverbindingen

Voor sommige verzoeken binnen een dialoog, zoals BYE of REFER, is mogelijk een nieuwe TLS-verbinding nodig als de oorspronkelijke verbinding al is gesloten. Het certificaatgedrag voor deze vervolgverbindingen verschilt van de initiële oproepopzet:

• Vervolgverbindingen naar ElevenLabs: Je systeem maakt de verbinding met het adres in de Contact-header die in het antwoord wordt teruggegeven. Dit verwijst naar een specifieke SIP-server in de vorm <ip>.hosts.rtc.elevenlabs.io. Die server presenteert een certificaat dat geldig is voor *.hosts.rtc.elevenlabs.io, dat je systeem als TLS-client valideert.
• Vervolgverbindingen vanuit ElevenLabs: Wanneer ElevenLabs een TLS-verbinding initieert voor een BYE of REFER, maakt het verbinding met het adres in de bovenste Via-header, wat vaak een IP-adres is. Je systeem retourneert doorgaans een certificaat dat geldig is voor een fully qualified domain name (FQDN), in plaats van dat IP-adres. Configureer het veld Remote domains in de instellingen van je telefoonnummer om dit certificaat te valideren. Als een domein waarvoor het ontvangen certificaat geldig is overeenkomt met een geconfigureerd extern domein, slaagt de validatie; anders mislukt deze.

Oproepen plaatsen naar de ElevenLabs SIP-trunk

Wanneer je oproepen naar het ElevenLabs-platform initieert, moet je de juiste SIP URI-indeling gebruiken. De URI van de ElevenLabs SIP-trunk is afhankelijk van het transport dat je voor signalering wilt gebruiken:

• TCP: sip:sip.rtc.elevenlabs.io:5060;transport=tcp
• TLS: sip:sip.rtc.elevenlabs.io:5061;transport=tls
• UDP: sip:sip.rtc.elevenlabs.io:5060;transport=udp (experimenteel; gebruik dit alleen voor tests, niet in productie)

Stel een volledige SIP URI samen die een identifier bevat om een oproep te plaatsen. Bijvoorbeeld om via TCP het telefoonnummer +19991234567 te bellen:

sip:+19991234567@sip.rtc.elevenlabs.io:5060

Waarbij:

• +19991234567 de identifier is (meestal een telefoonnummer in E.164-indeling)
• De identifier kan ook een willekeurige tekenreekswaarde zijn, zoals 1000 of john

Vereisten

Voordat je SIP-trunking instelt, zorg je dat je beschikt over:

1. Een SIP-compatibele PBX of telefoniesysteem
2. Telefoonnummers die je met ElevenLabs wilt verbinden
3. Beheerderstoegang tot je SIP-trunkconfiguratie
4. Geschikte firewallinstellingen om SIP-verkeer toe te staan
5. TLS-ondersteuning: Zorg voor betere beveiliging dat je SIP-trunkprovider TLS-transport ondersteunt
6. Compatibiliteit met audiocodecs: Je systeem moet minstens een van de audiocodecs G.722 of G.711 (PCMU of PCMA) ondersteunen, of audio aan jouw kant kunnen resamplen. Dit staat los van eventuele audio-indelingen die voor directe websocketverbindingen op de agent zijn geconfigureerd.

SIP-trunking instellen

1

Ga naar Phone Numbers

Ga naar de sectie Phone Numbers in het ElevenLabs Agents-dashboard.

2

SIP-trunk importeren

Klik op de knop “Import number” en selecteer vervolgens “From SIP Trunk” om het configuratievenster te openen.

3

Basisconfiguratie invoeren

Vul de basisconfiguratie in met de volgende informatie:

• Label: Een beschrijvende naam voor het telefoonnummer
• Phone Number: Het telefoonnummer in E.164-indeling dat je wilt verbinden (bijv. +15551234567)

4

Instellingen voor inkomende oproepen configureren

Configureer hoe ElevenLabs oproepen behandelt die bij je SIP-trunk binnenkomen, inclusief mediaversleuteling en toegangsbeheer:

• Media Encryption: Configureer versleuteling voor RTP-mediastreams:
  • Disabled: Geen mediaversleuteling
  • Allowed: Staat versleutelde mediastreams toe
  • Required: Vereist versleutelde mediastreams
• Allowed Numbers (optioneel): Telefoonnummers die gemachtigd zijn om dit nummer te bellen. Laat leeg om alle nummers toe te staan.
• Allowed Source IP Addresses (optioneel): Werkt alleen voor TCP/TLS-transport, niet voor UDP. IP-adressen of CIDR-bereiken die oproepen naar deze trunk mogen sturen. Laat dit op 0.0.0.0/0 staan om alle adressen toe te staan.
• Remote Domains (optioneel): Geef de FQDN-domeinen op van je SIP-servers van waaruit je de oproepen initieert, bijvoorbeeld example.pstn.twilio.com. Deze domeinen worden gebruikt voor validatie van TLS-certificaten. Laat dit veld leeg als je geen TLS gebruikt.
• Authentication (optioneel): Geef digest-authenticatiegegevens op die worden gebruikt om inkomende oproepen te authenticeren.
  • SIP Trunk Username: Gebruikersnaam voor SIP-digest-authenticatie
  • SIP Trunk Password: Wachtwoord voor SIP-digest-authenticatie

5

Instellingen voor uitgaande oproepen configureren

Configureer waar ElevenLabs oproepen voor je telefoonnummer naartoe moet sturen:

• Address: Hostnaam of IP-adres waar de SIP INVITE naartoe wordt gestuurd (bijv. sip.telnyx.com). Dit mag alleen een hostnaam of IP-adres zijn, geen volledige SIP URI. Gebruik bij TLS een hostnaam met een geldig certificaat.

• Transport Type: Selecteer het transportprotocol voor SIP-signalering:

  • TCP: Standaard TCP-transport
  • TLS: Versleuteld TLS-transport voor betere beveiliging
  • UDP: Verbindingsloos transport (experimenteel; gebruik TCP of TLS voor productie)

• Media Encryption: Configureer versleuteling voor RTP-mediastreams:

  • Disabled: Geen mediaversleuteling
  • Allowed: Staat versleutelde mediastreams toe
  • Required: Vereist versleutelde mediastreams

• Enabled Codecs: Codecs die in de SDP voor uitgaande oproepen worden aangeboden (G.722, PCMU, PCMA). Handig wanneer je SIP-provider alleen bepaalde codecs ondersteunt.

• Custom Headers (optioneel): Voeg aangepaste SIP-headers toe die bij uitgaande oproepen moeten worden opgenomen. Klik op “Add Header” om de headernaam en -waarde in te voeren die je provider vereist; je kunt naar behoefte meerdere headers toevoegen. Aangepaste headers kunnen worden gebruikt voor oproeproutering en -identificatie, facturering en tracking, en providerspecifieke vereisten.

• Authentication (optioneel): Geef digest-authenticatiegegevens op als je SIP-trunkprovider deze vereist.

  • SIP Trunk Username: Gebruikersnaam voor SIP-digest-authenticatie
  • SIP Trunk Password: Wachtwoord voor SIP-digest-authenticatie

  Als je dit leeg laat, wordt authenticatie met een Access Control List (ACL) gebruikt. Hiervoor moet je ElevenLabs-IP-adressen op de allowlist in de instellingen van je provider zetten.

Aanbevolen beveiligingsmethode: Gebruik TLS-transport met Required-mediaversleuteling voor maximale beveiliging. Dit zorgt ervoor dat zowel signalering als media end-to-end zijn versleuteld.

Authenticatiemethoden:

• Digest Authentication: Gebruikt gebruikersnaam- en wachtwoordgegevens voor veilige authenticatie (aanbevolen)
• ACL Authentication: Gebruikt IP-adressen op de allowlist voor toegangsbeheer

Digest Authentication wordt sterk aanbevolen, omdat dit betere beveiliging biedt zonder afhankelijk te zijn van IP-adressen op de allowlist, wat bij dynamische IP-adressen complex kan zijn om te beheren.

Het veld Address geeft aan waar ElevenLabs uitgaande oproepen van je AI-agenten naartoe stuurt. Voer alleen de hostnaam of het IP-adres in, zonder het protocolvoorvoegsel sip:.

6

Installatie voltooien

Klik op “Import” om de configuratie te voltooien.

Klantgegevens en personalisatie

Neem de volgende aangepaste SIP-headers op in je webhook-payload en SIP INVITE-verzoek om te zorgen voor een correcte doorsturing en traceerbaarheid van oproepmetadata:

• X-CALL-ID: Unieke identifier voor de oproep
• X-CALLER-ID: Identifier voor de beller

Met deze headers kan het systeem oproepmetadata aan het gesprek koppelen en context bieden voor personalisatie.

Ondersteuning voor fallback-headers

Als de bovenstaande standaardheaders niet aanwezig zijn, zoekt het systeem automatisch naar de Twilio-specifieke SIP-header:

• sip.twilio.callSid: De unieke oproepidentifier van Twilio

Deze fallback zorgt voor compatibiliteit met Twilio’s Elastic SIP Trunking zonder dat configuratiewijzigingen nodig zijn.

Verwerkingsstroom

Zodra de relevante metadata via een van de ondersteunde headers is ontvangen, zijn caller_id en/of call_id beschikbaar in de webhook voor gespreksinitiatie en als dynamische systeemvariabelen.

Aangepaste inkomende headers als dynamische variabelen

Aangepaste SIP X--headers van inkomende SIP-trunkingoproepen worden automatisch beschikbaar gesteld als dynamische variabelen in het gesprek.

Headernamen worden genormaliseerd door het voorvoegsel X- te verwijderen, de naam om te zetten naar kleine letters, koppeltekens te vervangen door underscores en het voorvoegsel sip_ toe te voegen. Zo wordt X-Contact-ID bijvoorbeeld {{sip_contact_id}} en wordt X-Campaign-ID {{sip_campaign_id}}.

Gebruik deze variabelen in agentprompts, eerste berichten en tools om het gesprek te personaliseren met context die de beller heeft verstrekt. De waarden zijn ook zichtbaar in de gesprekshistorie op het tabblad Phone Call.

BYE-headers vanuit dynamische variabelen

Wanneer een oproep eindigt, stuurt ElevenLabs een SIP BYE om de dialoog te beëindigen. Je kunt aangepaste headers aan die BYE koppelen door dynamische variabelen in je SIP-trunkconfiguratie aan headernamen toe te wijzen.

Stel attributes_to_headers in op inbound_trunk_config of outbound_trunk_config wanneer je via de API een SIP-trunktelefoonnummer maakt of bijwerkt. Elke invoer koppelt een naam van een dynamische variabele aan de SIP-headernaam die je in de BYE wilt opnemen:

"inbound_trunk_config": {
  "attributes_to_headers": {
    "dynamic_variable_name": "bye_header_name"
  }
}

De headerwaarde is de uiteindelijke waarde van de dynamische variabele aan het einde van het gesprek. Waarden die tijdens de oproep worden ingesteld — via agenttools, webhookoverschrijvingen of andere runtime-updates — worden opgenomen in de BYE.

Als attributes_to_headers bijvoorbeeld "disposition_code": "X-Disposition" bevat en de dynamische variabele disposition_code de waarde resolved heeft wanneer het gesprek eindigt, bevat de BYE X-Disposition: resolved.

Agenten toewijzen aan telefoonnummers

Nadat je je SIP-trunktelefoonnummer hebt geïmporteerd, kun je het toewijzen aan een ElevenLabs-agent:

1. Ga naar de sectie Phone Numbers in het ElevenAgents-dashboard
2. Selecteer je geïmporteerde SIP-trunktelefoonnummer
3. Klik op “Assign Agent”
4. Selecteer de agent die oproepen naar dit nummer moet afhandelen

Problemen oplossen

Beperkingen en aandachtspunten

• Ondersteuning voor meerdere gelijktijdige oproepen is afhankelijk van je abonnementsniveau. Schakel oproepwachtrij in om inkomende bellers vast te houden wanneer de limiet is bereikt, in plaats van ze te weigeren
• Functies voor oproepopname en analyses zijn beschikbaar, maar vereisen mogelijk aanvullende configuratie
• Mogelijkheden voor uitgaande oproepen kunnen beperkt zijn door je SIP-trunkprovider
• TLS-ondersteuning: Zorg dat je SIP-trunkprovider TLS 1.2 of hoger ondersteunt voor versleuteld transport
• Mediaversleuteling: SRTP-ondersteuning verschilt per provider; controleer de compatibiliteit voordat je versleuteling vereist
• Audio-indeling: De SIP-implementatie van ElevenLabs verzendt en ontvangt audio met de codecs PCMU of PCMA (G.711, 8 kHz) of G.722 (16 kHz). Dit staat los van eventuele audio-indelingen die voor directe websocketverbindingen op de agent zijn geconfigureerd. Je SIP-trunksysteem moet een van deze codecs native ondersteunen of resampling uitvoeren om te voldoen aan de vereisten van je systeem

Veelgestelde vragen

Volgende stappen

• SIP-referentie: verklarende woordenlijst met SIP- en netwerkt termen
• Lees hoe je ElevenLabs-agents maakt