SIP-trunkning

Översikt

SIP-trunkning (Session Initiation Protocol) låter dig ansluta din befintliga telefoninfrastruktur direkt till ElevenLabs Agents. Med den här integrationen kan alla kunder använda sina befintliga telefonsystem samtidigt som de drar nytta av ElevenLabs avancerade AI-röstfunktioner.

Med SIP-trunkning kan du:

• Ansluta din Private Branch Exchange (PBX) eller ditt SIP-aktiverade telefonsystem till ElevenLabs plattform för AI-röst
• Routa samtal till AI-agenter utan att ändra din befintliga telefoninfrastruktur
• Hantera både inkommande och utgående samtal
• Använda krypterad TLS-transport och mediekryptering för bättre säkerhet

Så fungerar SIP-trunkning

SIP-trunkning upprättar en direkt anslutning mellan din telefoninfrastruktur och ElevenLabs plattform:

1. Inkommande samtal: Samtal från din SIP-trunk routas till ElevenLabs plattform med din konfigurerade SIP INVITE-adress.
2. Utgående samtal: Samtal som initieras av ElevenLabs routas till din SIP-trunk med ditt konfigurerade värdnamn, så att dina agenter kan ringa utgående samtal.
3. Autentisering: Anslutningens säkerhet för signaleringen upprätthålls antingen genom digest-autentisering (användarnamn/lösenord) eller autentisering med åtkomstkontrollista (ACL) baserat på signaleringens käll-IP.
4. Signalering och media: Den inledande samtalsupprättningen (signalering) stöder flera transportprotokoll, inklusive TLS för krypterad kommunikation. När samtalet har upprättats kan själva ljuddatan (RTP-strömmen) krypteras utifrån dina inställningar för mediekryptering.

Transportsäkerhet: certifikat och chiffersviter

När du använder TLS-transport utför båda sidor en TLS-handskakning innan någon SIP-signalering utbyts. Under handskakningen validerar de ett certifikat och förhandlar fram en chiffersvit. Sidan som accepterar anslutningen fungerar som TLS-server och presenterar certifikatet. Sidan som öppnar anslutningen fungerar som TLS-klient och validerar det. ElevenLabs kräver TLS 1.2 eller senare.

Rollerna beror på samtalets riktning:

• Inkommande samtal till ElevenLabs: Ditt system öppnar anslutningen, så ElevenLabs fungerar som TLS-server. ElevenLabs presenterar ett giltigt certifikat för sip.rtc.elevenlabs.io, och ditt system validerar det som TLS-klient.
• Utgående samtal från ElevenLabs: ElevenLabs öppnar anslutningen till adressen du har konfigurerat, så din SIP-server eller SBC fungerar som TLS-server. Ditt system måste presentera ett giltigt, betrott certifikat som ElevenLabs validerar som TLS-klient.

Se till att båda sidor litar på varandras certifikat och delar minst en gemensam chiffersvit. Annars misslyckas TLS-handskakningen innan samtalet upprättas. Se SIP-referensen för definitioner av dessa termer.

Uppföljningsanslutningar

Vissa förfrågningar under dialogen, till exempel BYE eller REFER, kan kräva en ny TLS-anslutning när den ursprungliga anslutningen redan har stängts. Certifikatbeteendet för dessa uppföljningsanslutningar skiljer sig från den inledande samtalsupprättningen:

• Uppföljningsanslutningar till ElevenLabs: Ditt system upprättar anslutningen till adressen i Contact-huvudet som returneras i svaret, vilken löses till en specifik SIP-server i formen <ip>.hosts.rtc.elevenlabs.io. Den servern presenterar ett certifikat som är giltigt för *.hosts.rtc.elevenlabs.io, vilket ditt system validerar som TLS-klient.
• Uppföljningsanslutningar från ElevenLabs: När ElevenLabs initierar en TLS-anslutning för en BYE eller REFER ansluter tjänsten till adressen i det översta Via-huvudet, som ofta är en IP-adress. Ditt system returnerar vanligtvis ett certifikat som är giltigt för ett fullständigt kvalificerat domännamn (FQDN) i stället för den IP-adressen. För att validera det här certifikatet konfigurerar du fältet Fjärrdomäner i inställningarna för ditt telefonnummer. Om någon domän som det mottagna certifikatet är giltigt för matchar en konfigurerad fjärrdomän lyckas valideringen, annars misslyckas den.

Ringa samtal till ElevenLabs SIP-trunk

När du initierar samtal till ElevenLabs plattform måste du använda rätt SIP URI-format. URI:n för ElevenLabs SIP-trunk beror på vilken transport du vill använda för signalering:

• 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 (experimentellt; använd detta endast för testning, inte i produktion)

För att ringa ett samtal konstruerar du en fullständig SIP URI som innehåller en identifierare. Till exempel för att ringa telefonnumret +19991234567 via TCP:

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

Där:

• +19991234567 är identifieraren (vanligtvis ett telefonnummer i E.164-format)
• Identifieraren kan också vara ett valfritt strängvärde, till exempel 1000 eller john

Krav

Innan du konfigurerar SIP-trunkning ska du se till att du har:

1. En SIP-kompatibel PBX eller telefonilösning
2. Telefonnummer som du vill ansluta till ElevenLabs
3. Administratörsåtkomst till din SIP-trunkkonfiguration
4. Lämpliga brandväggsinställningar för att tillåta SIP-trafik
5. TLS-stöd: För ökad säkerhet ska du se till att din SIP-trunkleverantör stöder TLS-transport
6. Kompatibilitet med ljudkodekar: Ditt system måste ha stöd för minst en av ljudkodekarna G.722 eller G.711 (PCMU eller PCMA), eller kunna sampla om ljud på din sida. Detta är oberoende av det ljudformat som konfigurerats för agenten för direkta websocket-anslutningar.

Konfigurera SIP-trunkning

1

Gå till Telefonnummer

Gå till avsnittet Telefonnummer i ElevenLabs Agents-instrumentpanelen.

2

Importera SIP-trunk

Klicka på knappen “Importera nummer” och välj sedan “Från SIP-trunk” för att öppna konfigurationsdialogrutan.

3

Ange grundläggande konfiguration

Slutför den grundläggande konfigurationen med följande information:

• Etikett: Ett beskrivande namn för telefonnumret
• Telefonnummer: Det E.164-formaterade telefonnummer som ska anslutas (t.ex. +15551234567)

4

Konfigurera inställningar för inkommande samtal

Konfigurera hur ElevenLabs hanterar samtal som kommer till din SIP-trunk, inklusive mediekryptering och åtkomstkontroller:

• Mediekryptering: Konfigurera kryptering för RTP-medieströmmar:
  • Inaktiverad: Ingen mediekryptering
  • Tillåten: Tillåter krypterade medieströmmar
  • Krävs: Kräver krypterade medieströmmar
• Tillåtna nummer (valfritt): Telefonnummer som har behörighet att ringa detta nummer. Lämna tomt för att tillåta alla nummer.
• Tillåtna käll-IP-adresser (valfritt): Fungerar endast för TCP/TLS-transport, inte UDP. IP-adresser eller CIDR-intervall som får skicka samtal till denna trunk. Lämna som 0.0.0.0/0 för att tillåta alla adresser.
• Fjärrdomäner (valfritt): Ange FQDN-domänerna för dina SIP-servrar från vilka du initierar samtalen, till exempel example.pstn.twilio.com. Dessa domäner används för TLS-certifikatvalidering. Lämna fältet tomt om du inte använder TLS.
• Autentisering (valfritt): Ange uppgifter för digest-autentisering som används för att autentisera inkommande samtal.
  • SIP-trunkens användarnamn: Användarnamn för SIP digest-autentisering
  • SIP-trunkens lösenord: Lösenord för SIP digest-autentisering

5

Konfigurera inställningar för utgående samtal

Konfigurera vart ElevenLabs ska skicka samtal för ditt telefonnummer:

• Adress: Värdnamn eller IP-adress dit SIP INVITE skickas (t.ex. sip.telnyx.com). Detta ska endast vara ett värdnamn eller en IP-adress, inte en fullständig SIP URI. Om du använder TLS ska du använda ett värdnamn med ett giltigt certifikat.

• Transporttyp: Välj transportprotokoll för SIP-signalering:

  • TCP: Standardtransport via TCP
  • TLS: Krypterad TLS-transport för bättre säkerhet
  • UDP: Anslutningslös transport (experimentellt; använd TCP eller TLS i produktion)

• Mediekryptering: Konfigurera kryptering för RTP-medieströmmar:

  • Inaktiverad: Ingen mediekryptering
  • Tillåten: Tillåter krypterade medieströmmar
  • Krävs: Kräver krypterade medieströmmar

• Aktiverade kodekar: Kodekar som ska erbjudas i SDP för utgående samtal (G.722, PCMU, PCMA). Användbart när din SIP-leverantör endast stöder vissa kodekar.

• Anpassade rubriker (valfritt): Lägg till anpassade SIP-rubriker som ska inkluderas i utgående samtal. Klicka på “Lägg till rubrik” för att ange det rubriknamn och värde som krävs av din leverantör. Du kan lägga till flera rubriker efter behov. Anpassade rubriker kan användas för samtalsroutning och identifiering, fakturering och spårning samt leverantörsspecifika krav.

• Autentisering (valfritt): Ange uppgifter för digest-autentisering om din SIP-trunkleverantör kräver det.

  • SIP-trunkens användarnamn: Användarnamn för SIP digest-autentisering
  • SIP-trunkens lösenord: Lösenord för SIP digest-autentisering

  Om de lämnas tomma används autentisering med åtkomstkontrollista (ACL), vilket kräver att du tillåtslistar ElevenLabs IP-adresser i din leverantörs inställningar.

Bästa praxis för säkerhet: Använd TLS-transport med obligatorisk mediekryptering för maximal säkerhet. Då krypteras både signalering och media från början till slut.

Autentiseringsmetoder:

• Digest-autentisering: Använder användarnamn/lösenord för säker autentisering (rekommenderas)
• ACL-autentisering: Använder IP-tillåtelselistor för åtkomstkontroll

Digest-autentisering rekommenderas starkt eftersom den ger bättre säkerhet utan att förlita sig på IP-tillåtelselistor, som kan vara svåra att hantera med dynamiska IP-adresser.

Fältet Adress anger vart ElevenLabs skickar utgående samtal från dina AI-agenter. Ange endast värdnamnet eller IP-adressen utan protokollprefixet sip:.

6

Slutför konfigurationen

Klicka på “Importera” för att slutföra konfigurationen.

Klientdata och personanpassning

För att säkerställa korrekt vidarebefordran och spårbarhet av samtalsmetadata ska du inkludera följande anpassade SIP-rubriker i din webhook-payload och SIP INVITE-förfrågan:

• X-CALL-ID: Unik identifierare för samtalet
• X-CALLER-ID: Identifierare för den som ringer

Dessa rubriker gör det möjligt för systemet att koppla samtalsmetadata till konversationen och ge kontext för personanpassning.

Stöd för reservrubriker

Om standardrubrikerna ovan saknas söker systemet automatiskt efter den Twilio-specifika SIP-rubriken:

• sip.twilio.callSid: Twilios unika samtalsidentifierare

Denna reservlösning säkerställer kompatibilitet med Twilios Elastic SIP Trunking utan att konfigurationsändringar krävs.

Bearbetningsflöde

När relevanta metadata har tagits emot via någon av de rubriker som stöds är caller_id och/eller call_id tillgängliga i webhooken för konversationsinitiering och som dynamiska systemvariabler.

Anpassade inkommande rubriker som dynamiska variabler

Anpassade SIP-rubriker med X- från inkommande SIP-trunkningssamtal exponeras automatiskt som dynamiska variabler i konversationen.

Rubriknamn normaliseras genom att ta bort prefixet X-, konvertera namnet till gemener, ersätta bindestreck med understreck och lägga till prefixet sip_. Till exempel blir X-Contact-ID {{sip_contact_id}} och X-Campaign-ID blir {{sip_campaign_id}}.

Använd dessa variabler i agentprompter, första meddelanden och verktyg för att personanpassa konversationen med kontext som den som ringer har angett. Värdena syns även i konversationshistoriken under fliken Telefonsamtal.

BYE-rubriker från dynamiska variabler

När ett samtal avslutas skickar ElevenLabs ett SIP BYE för att avsluta dialogen. Du kan lägga till anpassade rubriker i detta BYE genom att mappa dynamiska variabler till rubriknamn i din SIP-trunkkonfiguration.

Ange attributes_to_headers på inbound_trunk_config eller outbound_trunk_config när du skapar eller uppdaterar ett SIP-trunktelefonnummer via API:t. Varje post mappar ett dynamiskt variabelnamn till SIP-rubriknamnet som ska inkluderas i BYE:

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

Rubrikvärdet är den dynamiska variabelns slutliga värde när konversationen avslutas. Värden som anges under samtalet – via agentverktyg, webhook-åsidosättningar eller andra uppdateringar under körning – återspeglas i BYE.

Om attributes_to_headers till exempel innehåller "disposition_code": "X-Disposition" och den dynamiska variabeln disposition_code är resolved när konversationen avslutas, innehåller BYE X-Disposition: resolved.

Tilldela agenter till telefonnummer

När du har importerat telefonnumret för din SIP-trunk kan du tilldela det till en ElevenLabs-agent:

1. Gå till avsnittet Telefonnummer i ElevenAgents-instrumentpanelen
2. Välj ditt importerade SIP-trunktelefonnummer
3. Klicka på “Tilldela agent”
4. Välj agenten som ska hantera samtal till detta nummer

Felsökning

Begränsningar och överväganden

• Stöd för flera samtidiga samtal beror på din prenumerationsnivå. Aktivera samtalskö för att hålla kvar inkommande uppringare när gränsen nås i stället för att avvisa dem
• Funktioner för samtalsinspelning och analys är tillgängliga, men kan kräva ytterligare konfiguration
• Möjligheterna att ringa utgående samtal kan begränsas av din SIP trunk-leverantör
• TLS-stöd: Säkerställ att din SIP trunk-leverantör stöder TLS 1.2 eller senare för krypterad transport
• Mediekryptering: SRTP-stöd varierar mellan leverantörer; kontrollera kompatibiliteten innan du kräver kryptering
• Ljudformat: ElevenLabs SIP-distribution skickar och tar emot ljud med codec:arna PCMU eller PCMA (G.711, 8 kHz) eller G.722 (16 kHz). Detta är oberoende av ljudformatet som konfigurerats för agenten vid direkta websocket-anslutningar. Ditt SIP trunk-system måste antingen ha inbyggt stöd för någon av dessa codec:ar eller utföra omsampling för att uppfylla systemets krav

Vanliga frågor

Nästa steg

• SIP-referens: ordlista över SIP- och nätverkstermer
• Läs om hur du skapar ElevenLabs-agenter