SIP-trunking

Overzicht

Met SIP-trunking (Session Initiation Protocol) kun je je bestaande telefonie-infrastructuur rechtstreeks verbinden met ElevenLabs Agents. Deze integratie stelt alle klanten in staat hun bestaande telefoonsystemen te gebruiken en tegelijkertijd gebruik te maken van de geavanceerde voice AI-mogelijkheden van ElevenLabs.

Met SIP-trunking kun je:

• Je Private Branch Exchange (PBX) of SIP-telefoonsysteem verbinden met het voice AI-platform van ElevenLabs
• Gesprekken naar AI-agents routeren zonder je bestaande telefonie-infrastructuur 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 naar het ElevenLabs-platform gerouteerd via je geconfigureerde SIP INVITE-adres.
2. Uitgaande gesprekken: Door ElevenLabs geïnitieerde gesprekken worden via je geconfigureerde hostname naar je SIP-trunk gerouteerd, zodat je agents uitgaande gesprekken kunnen voeren.
3. Authenticatie: De verbinding voor signalering wordt beveiligd met digest-authenticatie (gebruikersnaam/wachtwoord) of authenticatie met een Access Control List (ACL) op basis van het IP-adres van de signaleringsbron.
4. Signalering en media: De initiële gespreksconfiguratie (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 partijen een TLS-handshake uit voordat SIP-signalering wordt uitgewisseld. Tijdens de handshake valideren ze een certificaat en onderhandelen ze over een cipher suite. De partij die de verbinding accepteert, treedt op als TLS-server en presenteert het certificaat; de partij die de verbinding opent, treedt op als TLS-client en valideert het. ElevenLabs vereist TLS 1.2 of hoger.

De rollen zijn afhankelijk van de gespreksrichting:

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

Zorg dat beide partijen elkaars certificaten vertrouwen en ten minste één gemeenschappelijke cipher suite hebben. Zo niet, dan mislukt de TLS-handshake voordat het gesprek tot stand is gebracht. Bekijk de SIP-referentie voor definities van deze termen.

Vervolgverbindingen

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

• Vervolgverbindingen naar ElevenLabs: Je systeem maakt verbinding met het adres in de Contact-header die in het antwoord wordt teruggestuurd. Dit wordt omgezet 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, vaak een IP-adres. Je systeem retourneert doorgaans een certificaat dat geldig is voor een fully qualified domain name (FQDN), in plaats van voor dat IP-adres. Configureer het veld Remote domains in je telefoonnummerinstellingen 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.

Gesprekken voeren naar de SIP-trunk van ElevenLabs

Wanneer je gesprekken initieert naar het ElevenLabs-platform, moet je de juiste SIP-URI-indeling gebruiken. De SIP-trunk-URI van ElevenLabs hangt af 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 testen, niet in productie)

Stel een volledige SIP-URI samen die een identifier bevat om een gesprek te voeren. Bijvoorbeeld om het telefoonnummer +19991234567 via TCP 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 tekenreeks zijn, zoals 1000 of john

Vereisten

Controleer voordat je SIP-trunking instelt of je beschikt over:

1. Een SIP-compatibele PBX of telefoniesysteem
2. Telefoonnummers die je met ElevenLabs wilt verbinden
3. Beheerderstoegang tot de configuratie van je SIP-trunk
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 minimaal een van de audiocodecs G.722 of G.711 (PCMU of PCMA) ondersteunen, of audio aan jouw kant opnieuw kunnen samplen. Dit staat los van een audioformaat dat op de agent is geconfigureerd voor rechtstreekse websocketverbindingen.

SIP-trunking instellen

1

Ga naar telefoonnummers

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 gegevens:

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

4

Instellingen voor inkomende gesprekken configureren

Configureer hoe ElevenLabs gesprekken behandelt die op je SIP-trunk binnenkomen, inclusief mediaversleuteling en toegangscontroles:

• 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 gesprekken naar deze trunk mogen sturen. Laat 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 gesprekken initieert, bijvoorbeeld example.pstn.twilio.com. Deze domeinen worden gebruikt voor TLS-certificaatvalidatie. Laat dit veld leeg als je geen TLS gebruikt.
• Authentication (optioneel): Geef inloggegevens voor digest-authenticatie op die worden gebruikt om inkomende gesprekken te authenticeren.
  • SIP Trunk Username: Gebruikersnaam voor SIP-digest-authenticatie
  • SIP Trunk Password: Wachtwoord voor SIP-digest-authenticatie

5

Instellingen voor uitgaande gesprekken configureren

Configureer waarheen ElevenLabs gesprekken voor je telefoonnummer moet sturen:

• Address: Hostname of IP-adres waarheen de SIP INVITE wordt verstuurd (bijv. sip.telnyx.com). Dit moet alleen een hostname of IP-adres zijn, geen volledige SIP-URI. Gebruik bij TLS een hostname 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 in 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 worden aangeboden voor uitgaande gesprekken (G.722, PCMU, PCMA). Handig als je SIP-provider slechts bepaalde codecs ondersteunt.

• Custom Headers (optioneel): Voeg aangepaste SIP-headers toe die met uitgaande gesprekken worden meegestuurd. Klik op “Add Header” om de headernaam en -waarde in te voeren die je provider vereist; je kunt indien nodig meerdere headers toevoegen. Aangepaste headers kunnen worden gebruikt voor gespreksroutering en identificatie, facturering en tracking, en vereisten van specifieke providers.

• Authentication (optioneel): Geef inloggegevens voor digest-authenticatie op als je SIP-trunkprovider dit vereist.

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

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

Best practice voor beveiliging: Gebruik TLS-transport met Required-mediaversleuteling voor maximale beveiliging. Zo worden zowel signalering als media end-to-end versleuteld.

Authenticatiemethoden:

• Digest Authentication: Gebruikt inloggegevens met gebruikersnaam/wachtwoord voor veilige authenticatie (aanbevolen)
• ACL Authentication: Gebruikt IP-adresallowlisting voor toegangsbeheer

Digest Authentication wordt sterk aanbevolen, omdat deze betere beveiliging biedt zonder afhankelijk te zijn van IP-allowlisting, wat lastig te beheren kan zijn met dynamische IP-adressen.

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

6

Installatie voltooien

Klik op “Import” om de configuratie te voltooien.

Clientgegevens en personalisatie

Neem de volgende aangepaste SIP-headers op in je webhook-payload en SIP INVITE-verzoek om gespreksmetadata correct door te sturen en traceerbaar te maken:

• X-CALL-ID: Unieke identifier voor het gesprek
• X-CALLER-ID: Identifier voor de bellende partij

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

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 gespreksidentifier van Twilio

Deze fallback zorgt voor compatibiliteit met Elastic SIP Trunking van Twilio 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 headers voor inkomende gesprekken als dynamische variabelen

Aangepaste SIP-headers met X- van inkomende SIP-trunkinggesprekken worden automatisch in het gesprek beschikbaar gemaakt als dynamische variabelen.

Headernamen worden genormaliseerd door het voorvoegsel X- te verwijderen, de naam naar kleine letters om te zetten, afbreekstreepjes te vervangen door underscores en het voorvoegsel sip_ toe te voegen. Zo wordt X-Contact-ID {{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 door de beller is verstrekt. De waarden zijn ook zichtbaar in de gespreksgeschiedenis op het tabblad Phone Call.

BYE-headers vanuit dynamische variabelen

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

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 het gesprek worden ingesteld — via agenttools, webhookoverschrijvingen of andere runtime-updates — worden in de BYE weergegeven.

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.

Agents aan telefoonnummers toewijzen

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

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 gesprekken naar dit nummer moet afhandelen

Problemen oplossen

Beperkingen en aandachtspunten

• Ondersteuning voor meerdere gelijktijdige oproepen hangt af van je abonnementsniveau. Schakel oproepwachtrij in om inkomende bellers in de wacht te zetten 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 verplicht stelt
• Audioformaat: 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 elk audioformaat dat op de agent is geconfigureerd voor directe websocketverbindingen. Je SIP-trunksysteem moet een van deze codecs standaard ondersteunen of resampling uitvoeren om aan de vereisten van je systeem te voldoen

Veelgestelde vragen

Volgende stappen

• SIP-referentie: woordenlijst met SIP- en netwerkt termen
• Meer informatie over het maken van ElevenLabs-agents