> 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. # Exotel-integrering ## Översikt Den här guiden förklarar hur du ansluter dina Exotel-telefonnummer direkt till ElevenAgents. Med den här integrationen kan du använda dina befintliga Exotel-nummer och din infrastruktur samtidigt som du använder ElevenLabs avancerade AI-röstfunktioner för både inkommande och utgående samtal. ## Så fungerar integrationen Exotel-integrationen använder två Exotel-funktioner: 1. **Voicebot-applet (inkommande + utgående media)**: En ExoML-applet på Exotel som öppnar en WebSocket till ElevenLabs och strömmar samtalets ljud i båda riktningarna. 2. **Connect API (utgående uppringning)**: För utgående samtal anropar ElevenLabs Exotels slutpunkt `Calls/connect.json` med din API-nyckel och API-token. Exotel ringer upp mottagaren och dirigerar, när samtalsbenet besvaras, ljudet genom samma Voicebot-applet till ElevenLabs. För **inkommande** samtal dirigerar Exotel inkommande samtal till Voicebot-appleten som du kopplar till telefonnumret, vilken öppnar WebSocket-anslutningen till ElevenLabs. För **utgående** samtal initierar ElevenLabs samtalet via Connect API och Exotel kopplar tillbaka samtalet genom Voicebot-appleten. ## Krav Innan du konfigurerar Exotel-integrationen ska du kontrollera att du har: 1. Ett aktivt [Exotel-konto](https://exotel.com/) med minst ett tilldelat telefonnummer. 2. Administratörsåtkomst till Exotel-instrumentpanelen på [my.exotel.com](https://my.exotel.com) (Singapore) eller [my.exotel.in](https://my.exotel.in) (Mumbai). 3. Ett ElevenLabs-konto och en [agent](/docs/sv/eleven-agents/quickstart) som du vill koppla telefonnumret till. > **Note** > > Exotel stöds för närvarande i klustren **Singapore** (`api.exotel.com`) och **Mumbai** > (`api.in.exotel.com`). Välj det kluster där ditt Exotel-konto har konfigurerats. Fel region > leder till autentiseringsfel. ## Aktivera Voicebot för ditt Exotel-konto Innan du gör något annat kontaktar du **Exotels support** och ber dem att: 1. **Aktivera Voicebot-appleten** för ditt konto. Den är spärrad som standard och visas inte i App Bazaar förrän ditt konto har aktiverats för den. 2. **Tilldela det antal kanaler (samtidiga samtal)** du behöver. Detta är gränsen för hur många samtidiga Voicebot-samtal Exotel låter ditt konto köra. Anpassa antalet efter din förväntade högsta trafik. > **Warning** > > Det här steget tar vanligtvis 1–2 arbetsdagar. Påbörja det innan du fortsätter med resten av konfigurationen. ## ElevenLabs WebSocket-slutpunkt Du konfigurerar din Exotel Voicebot-applet för att strömma ljud till följande WebSocket-URL. | Miljö | WebSocket-URL | | ------------------------------ | -------------------------------------------------------------------- | | Standard (USA/internationellt) | `wss://api.elevenlabs.io/v1/convai/conversation/exotel` | | EU-residens | `wss://api.eu.residency.elevenlabs.io/v1/convai/conversation/exotel` | | Indien-residens | `wss://api.in.residency.elevenlabs.io/v1/convai/conversation/exotel` | > **Info** > > Om ditt ElevenLabs-konto finns i en isolerad residensmiljö (EU eller Indien) måste du använda > motsvarande residens-URL. Läs mer om [dataresidens](/docs/sv/overview/administration/data-residency). ## Konfiguration i Exotel #### Hämta dina Exotel-uppgifter Öppna menyn **Monitor** till vänster i Exotel-instrumentpanelen och klicka på **Developer**. Då öppnas sidan med API-uppgifter där du kan se Account SID, API Key och API Token. ![Exotel-sidofält: Developer](/docs/_fern-img/ebe936f8cd0d1773a88bb4922a7642cf8c2f844f39eb4ee9ee04eab50ecfa6c4.webp) Du behöver fyra värden: * **Account SID**: SID för ditt Exotel-konto. * **API Key**: Användarnamnsdelen av Exotels API-uppgifter. * **API Token**: Lösenordsdelen av Exotels API-uppgifter. Håll den hemlig. * **Region (API-underdomän)**: Klustret där ditt Exotel-konto finns. Det är antingen `api.exotel.com` (Singapore) eller `api.in.exotel.com` (Mumbai). Du kan bekräfta vilket genom att titta på värden för API-URL:er på Developer-sidan. ElevenLabs använder API Key + API Token för HTTP Basic Auth när Exotels Connect API anropas för utgående uppringning. #### Skapa en Voicebot-applet i App Bazaar 1. Öppna menyn **Manage** till vänster i Exotel-instrumentpanelen och klicka på **App Bazaar**. ![Exotel-sidofält: App Bazaar](/docs/_fern-img/1e50c6687044e4fea1e6e636bc2db8a4a481c87eb44cdfc8019cff20bd1fe363.webp) 2. Klicka på **Create / Add New Flow** och ge appen ett beskrivande namn (t.ex. `ElevenLabs`). Klicka sedan på **OK**. ![Exotel: Dialogrutan Add New Flow](/docs/_fern-img/928f17d1351f93e7a9bd60d92498dde8b24d350686cf273be146e9d315927704.webp) 3. Dra appleten **Voicebot** från appletpaletten till höger till arbetsytan **Call Start**. ![Exotel-appletpalett med Voicebot markerad](/docs/_fern-img/d19a0e66925d5931cd8f9eae7a1264b8a0e259d07736564cab4e1e894401c508.webp) 4. Öppna konfigurationen för Voicebot-appleten och klistra in ElevenLabs WebSocket-URL för din residensmiljö i fältet **URL** (fältet "Which bot you want to connect the enduser?"): ``` wss://api.elevenlabs.io/v1/convai/conversation/exotel ``` > **Info** > > Om ditt ElevenLabs-konto använder EU- eller Indien-residens använder du den matchande residens-URL:en i > tabellen ovan (t.ex. `wss://api.in.residency.elevenlabs.io/v1/convai/conversation/exotel`) i stället > för standard-`api.elevenlabs.io`. Övriga Voicebot-alternativ ("Record this?", "Recording Channels", "Recording Format", "Encrypt DTMF") kan behålla sina standardvärden, om du inte har särskilda krav för inspelning eller efterlevnad. ![Voicebot-applet konfigurerad med ElevenLabs WebSocket- URL](/docs/_fern-img/bb375863bb02b0908786403c080280f4561f21d887fb490050d54ff4ec211794.webp) 5. **(Valfritt) Koppla en Connect-applet för överföringar till människor.** Hoppa över detta om agenten inte behöver kunna överföra samtalet till en människa. Om du vill använda agentens verktyg **Transfer to number** måste du lägga till en **Connect**-applet direkt efter Voicebot-appleten i flödet. Dra appleten **Connect** från paletten **Voice Applets** till höger till platsen **Next → Continue to the next applet** i Voicebot. ![Voice Applets-palett med Connect markerad](/docs/_fern-img/1c325fc4ae992db551209b667519ffd75161b6a97ebf71ed6b751bbf26339faf.webp) I konfigurationen för Connect-appleten väljer du **Configure parameters dynamically by providing a URL** och klistrar in ElevenLabs Connect-applet-slutpunkt för din residensmiljö i **Primary URL**: ``` https://api.elevenlabs.io/v1/convai/exotel/connect-applet ``` ![Connect-applet konfigurerad med ElevenLabs dynamiska URL](/docs/_fern-img/7ed4516ec33ea62830d9279a266ada20311741d0489fe2661dc528b8dbcbe126.webp) De matchande residens-URL:erna är: | Miljö | Connect-applet-URL | | ------------------------------ | ------------------------------------------------------------------------ | | Standard (USA/internationellt) | `https://api.elevenlabs.io/v1/convai/exotel/connect-applet` | | EU-residens | `https://api.eu.residency.elevenlabs.io/v1/convai/exotel/connect-applet` | | Indien-residens | `https://api.in.residency.elevenlabs.io/v1/convai/exotel/connect-applet` | > **Info** > > När agenten använder verktyget **Transfer to number** lämnar ElevenLabs tillbaka kontrollen till Exotel > och Exotel hämtar denna URL för att få telefonnumret som ska ringas upp. Lämna **Fallback URL** > tom och behåll alla andra standardinställningar. 6. Spara och publicera appleten. 7. Anteckna **Applet ID** (kallas ibland **App ID**). Du hittar det i URL:en för ExoML-redigeraren (t.ex. `.../exoml/start_voice/12345`) eller i applistan. Du behöver det när du importerar numret till ElevenLabs. > **Note** > > Voicebot-appleten hanterar både inkommande och utgående samtalsben. Du behöver bara en applet per > konto. Alla telefonnummer du importerar till ElevenLabs kan dela den. #### Koppla flödet till ett telefonnummer (endast inkommande) Spara och publicera ExoML-flödet från föregående steg. Dirigera sedan ett Exotel-telefonnummer till det så att inkommande samtal hamnar i din Voicebot-applet. 1. Öppna menyn **Manage** till vänster i Exotel-instrumentpanelen och klicka på **ExoPhones** (precis under **App Bazaar**). ![Exotel-sidofält: ExoPhones](/docs/_fern-img/30351173b2c2cfaa2ccd8d9e29e6aaba319ac3b5f2ee51d91a4f7913d3e218a4.webp) 2. Om du inte redan har ett telefonnummer klickar du på **Buy a number** och köper ett i det land eller område du behöver innan du fortsätter. 3. Hitta numret du vill använda med din ElevenLabs-agent. Öppna rullgardinsmenyn i kolumnen **Installed App** och välj flödet du skapade i föregående steg (t.ex. **ElevenLabs**). ![ExoPhones: tilldela Installed App till ett telefon- nummer](/docs/_fern-img/5ed6b42794bb00f330dd52d50a5831622e3156955d59adb1ca64b746d1ec7d2b.webp) 4. Spara konfigurationen. Inkommande samtal till numret dirigeras nu direkt till Voicebot-appleten och strömmas till ElevenLabs. > **Note** > > Om numret endast ska användas för utgående samtal kan du hoppa över detta steg. Utgående samtal > rings via Connect API från ElevenLabs och beror inte på tilldelningen **Installed App**. ## Konfiguration i ElevenLabs #### Importera Exotel-telefonnumret Gå till fliken [**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers) i ElevenAgents-instrumentpanelen. Klicka på **+ Import number** och välj **From Exotel** i rullgardinsmenyn. ![ElevenAgents: rullgardinsmenyn Import number med From Exotel valt](/docs/_fern-img/2a62cf9f6b63914c5688da5f58515168fa1ff39b8602f70fea7a1ff257bb6918.webp) Fyll i följande fält: * **Label**: Ett beskrivande namn (t.ex. `Support Line`). * **Phone number**: Exotel-numret i E.164-format (t.ex. `+918048961234`). * **Exotel Account SID**: Från steg 1 ovan. * **Exotel API Key**: Från steg 1 ovan. * **Exotel API Token**: Från steg 1 ovan (lagras som en arbetsytehemlighet). * **Region**: Välj `Singapore (api.exotel.com)` eller `Mumbai (api.in.exotel.com)` som matchar ditt Exotel-kluster. * **Voicebot Applet ID**: App ID från steg 2 ovan. Klicka på **Import** för att spara numret. ElevenLabs verifierar uppgifterna mot Exotel och lagrar API-token som en arbetsytehemlighet. #### Tilldela din agent När numret har importerats öppnar du det från listan **Phone Numbers** och väljer den agent som ska hantera inkommande samtal i rullgardinsmenyn **Assigned agent**. > **Note** > > Inkommande samtal kräver att Voicebot-appleten har kopplats till numret hos Exotel (se föregående > avsnitt). Konfigurationer för enbart utgående samtal behöver ingen tilldelning för inkommande samtal. #### Testa ett inkommande samtal Ring ditt Exotel-nummer från valfri telefon. Exotel dirigerar samtalet till Voicebot-appleten, som öppnar en WebSocket till ElevenLabs. Din agent svarar och startar konversationen. > **Tip** > > Övervaka samtalet i instrumentpanelen [Calls History](https://elevenlabs.io/app/agents/history) för att > kontrollera att allt fungerar som förväntat. ## Ring utgående samtal Importerade Exotel-nummer kan även initiera utgående samtal. Din agent ringer upp ett telefonnummer och startar konversationen när mottagaren svarar. #### Initiera ett utgående samtal Hitta ditt Exotel-nummer på fliken [**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers) och klicka på knappen **Outbound call**. #### Konfigurera samtalet I dialogrutan Outbound Call: 1. Välj agenten som ska hantera konversationen. 2. Ange mottagarens telefonnummer i E.164-format. 3. Klicka på **Send Test Call** för att initiera samtalet. ElevenLabs anropar Exotels Connect API med dina lagrade uppgifter. Exotel ringer upp mottagaren och dirigerar ljudet tillbaka genom Voicebot-appleten när samtalet besvaras. > **Note** > > När du ringer utgående samtal initierar din agent konversationen, så se till att agenten har > ett lämpligt första meddelande konfigurerat. Om du vill utlösa utgående samtal programmatiskt i stället för från instrumentpanelen använder du slutpunkten [Outbound call via Exotel](/docs/sv/api-reference/exotel/outbound-call). API-referensen innehåller begärandeschemat och färdiga SDK-kodexempel. ## Krav för agentkonfiguration Voicebot-appleten strömmar ljud med **8 kHz PCM**. ElevenLabs-plattformen hanterar automatiskt konverteringen av ljudformatet. Du behöver **inte** ändra agentens TTS- eller inställningar för ingångsljud. ## Telefonnummerformat Telefonnummer lagras i E.164-format (t.ex. `+918048961234`). När du importerar ett indiskt Exotel-nummer som du lokalt kanske skriver som `08048961234` eller `8048961234`, anger du det som `+918048961234`. ElevenLabs avvisar dubblettimporter av samma nummer i olika format. ## Samtalsöverföringar Du kan överföra samtal från din agent tillbaka till Exotel genom att konfigurera ett verktyg **Transfer to number** för agenten. När verktyget aktiveras avslutar ElevenLabs Voicebot-samtalsbenet och Exotel hämtar mottagarnumret från den kedjade **Connect**-appleten dynamiska URL och ringer sedan upp målet. För att detta ska fungera behöver du **båda**: 1. Den valfria **Connect-appleten** konfigurerad direkt efter Voicebot-appleten i ditt ExoML-flöde (se steg 5 i [Konfiguration i Exotel](#setup-on-exotel)). 2. Verktyget **Transfer to number** konfigurerat för din agent. Se [guiden för agentöverföring](/docs/sv/eleven-agents/customization/tools/system-tools/transfer-to-number). Utan Connect-appleten i flödet misslyckas agentens överföringsförsök eftersom Exotel inte har någonstans att dirigera samtalet efter att Voicebot avslutas. ## Felsökning #### Felet \`exotel\_connect\_failed\` när ett utgående samtal startas ElevenLabs fick ett annat svar än 200 från Exotels Connect API. De vanligaste orsakerna är: * Fel **Region**. Kontrollera att regionen du valde vid import matchar Exotel-klustret där ditt konto finns (`Singapore` eller `Mumbai`). * Ogiltig **API Key** eller **API Token**. Kontrollera uppgifterna på sidan **API Settings** i Exotel och importera numret igen med rätt värden. * **Account SID** matchar inte paret API Key/API Token. * Mottagarnumret är inte i E.164-format. #### Inkommande samtal når inte min agent * Kontrollera att Voicebot-appletens fält **URL** exakt matchar ElevenLabs WebSocket-slutpunkt för din dataresidensmiljö (inklusive `wss://`). * Kontrollera att Exotel-**telefonnumret** dirigeras till ExoML-appen som innehåller Voicebot-appleten (Exotel-instrumentpanelen, ExoPhones, numret, Installed App). * Kontrollera i ElevenLabs att telefonnumret har en tilldelad agent på fliken **Phone Numbers**. #### Fel för \`Applet ID\`-matchning vid import Fältet **Voicebot Applet ID** förväntar sig det numeriska App ID från ExoML-redigerarens URL (t.ex. är ID:t `12345` för `.../exoml/start_voice/12345`). Klistra inte in hela URL:en. Använd endast ID:t. #### Telefonnummer importerat två gånger i olika format ElevenLabs normaliserar Exotel-nummer till E.164 innan de lagras och säkerställer unika värden för `(provider, phone_number)`. Om du tidigare har importerat samma nummer i ett format som inte är E.164 raderar du först den gamla posten och importerar sedan numret igen i E.164-format. ## Användbara länkar * [API-referens för utgående samtal via Exotel](/docs/sv/api-reference/exotel/outbound-call) * [Exotels API-dokumentation](https://developer.exotel.com/api/) * [Referens för Exotel Voicebot-applet](https://support.exotel.com/support/solutions/articles/3000099826) * [ElevenAgents instrumentpanel för telefonnummer](https://elevenlabs.io/app/agents/phone-numbers)