> 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.

# Sinch SIP-trunking

> **Note**
>
> Innan du följer den här guiden kan du läsa [ElevenLabs guide om SIP-trunking ](/docs/sv/eleven-agents/phone-numbers/sip-trunking) och [Sinch Voice-guide om SIP-trunking ](https://developers.sinch.com/docs/voice/api-reference/sip-trunking).

## Översikt

Den här guiden förklarar hur du ansluter en Sinch Voice-applikation direkt till ElevenLabs Agents. Integreringen gör att du kan behålla dina Sinch-nummer och din dirigering medan ElevenLabs hanterar AI-röstagentupplevelsen.

## Så fungerar SIP-trunking med Sinch

En Sinch SIP-trunk är en tvåvägsanslutning mellan Sinch-nätverket och ElevenLabs-plattformen:

1. **Inkommande samtal**: Ett DID som tilldelats din Sinch Voice-applikation tar emot ett samtal. Sinch skickar `INVITE` till ElevenLabs origination-adress som konfigurerats som en statisk slutpunkt i trunkens inkommande inställningar.
2. **Utgående samtal**: Samtal som initieras av ElevenLabs skickas till din applikations SIP-adress med fullständigt kvalificerat domännamn (FQDN), som Sinch dirigerar till PSTN.
3. **Autentisering**: Sinch kräver autentisering för utgående samtal (SIP-inloggningsuppgifter) och stöder ACL-autentisering (IP-tillåtelselista) för trafik som kommer in på trunken.

## Krav

Innan du börjar ska du se till att du har:

1. Ett aktivt ElevenLabs-konto med en konfigurerad agent
2. Ett Sinch-konto med en röstapplikation skapad i [Sinch Build-dashboarden](https://dashboard.sinch.com/voice/apps)
3. Minst ett telefonnummer (DID) som köpts i Sinch och tilldelats applikationen

## Konfigurera inkommande samtal (Sinch till ElevenLabs)

Peka din applikations vidarekoppling av samtal mot ElevenLabs SIP-adress.

### Logga in på Sinch Build-dashboarden

Logga in på ditt Sinch-konto och gå till applikationen som du vill ansluta.

### Lägg till en statisk slutpunkt för ElevenLabs

I applikationens inställningar för vidarekoppling av samtal uppdaterar du hanteraren för samtalshändelser till `SIP Forwarding` och lägger till en statisk SIP-URI som riktar sig mot ElevenLabs origination-adress:

* **DID**: Sinch-telefonnumret som du vill ringa
* **Adress**: `sip.rtc.elevenlabs.io`
* **Port och transport**: `5061/TLS`, `5060/TCP`

Till exempel: `sip:15551234567@sip.rtc.elevenlabs.io:5061;transport=tls`.

Om din ElevenLabs-arbetsyta använder en isolerad region för datahemvist eller den statiska IP-baserade SIP-infrastrukturen ska du använda motsvarande slutpunkt i stället för `sip.rtc.elevenlabs.io`. Se [datahemvist](/docs/sv/overview/administration/data-residency) för tillgängliga regioner.

### Tilldela ditt DID till applikationen

Tilldela det telefonnummer som ska nå din agent till den här applikationen.

## Konfigurera utgående samtal (ElevenLabs till Sinch)

För utgående samtal skickar ElevenLabs en SIP-`INVITE` till din Sinch-applikation och autentiserar mot den.

### Notera FQDN för din Sinch-region

Hämta din Sinch-regions [SIP-FDQN](https://developers.sinch.com/docs/voice/api-reference/sip-trunking#termination-uris). Detta är termination-adressen som du anger i ElevenLabs. Ange endast värdnamnet, utan prefixet `sip:`.

### Ange SIP-inloggningsuppgifter

Kopiera nyckeln och hemligheten för din Sinch-applikation på ett säkert sätt. De används som ditt användarnamn och lösenord i ElevenLabs.

### Vidarekopplingsnummer

Din Sinch-applikation vidarekopplar samtalet till sin vidarekopplingsadress. För att ringa ett utgående samtal till numret som anges i begäran om utgående samtal lämnar du det här fältet tomt i applikationens inställningar.

## Slutför konfigureringen i ElevenLabs

### Importera SIP-trunkens telefonnummer

Följ [guiden om SIP-trunking](/docs/sv/eleven-agents/phone-numbers/sip-trunking) för att importera ditt Sinch-nummer med följande inställningar:

| Inställning               | Värde                                                                                       |
| ------------------------- | ------------------------------------------------------------------------------------------- |
| Telefonnummer             | Ditt Sinch DID, till exempel `15551234567`                                                  |
| Transporttyp              | TLS                                                                                         |
| Mediekryptering           | `Disabled` för TCP; `Allowed` eller `Required` när trunken är konfigurerad för TLS och SRTP |
| Adress                    | FQDN för din Sinch-trunk, endast värdnamn                                                   |
| SIP-trunkens användarnamn | Nyckel för Sinch-applikationen                                                              |
| SIP-trunkens lösenord     | Hemlighet för Sinch-applikationen                                                           |

Håll transport- och krypteringsinställningarna konsekventa på båda sidor.

### Tilldela en agent

Tilldela en agent till numret i [Phone Numbers-dashboarden](https://elevenlabs.io/app/agents/phone-numbers). Inkommande samtal till DID-numret når nu den agenten.

### Testa ett utgående samtal

Ring ett samtal från agenten via din Sinch-applikation, antingen via telefonnummermenyn eller API:t för utgående samtal:

```bash
curl -X POST https://api.elevenlabs.io/v1/convai/sip-trunk/outbound-call \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6",
    "agent_phone_number_id": "phnum_8901k4t9z5defmb8vh3e9361y7nj",
    "to_number": "+15551234567"
  }'
```

Se [Utgående samtal via SIP-trunk](/docs/sv/eleven-agents/api-reference/sip-trunk/outbound-call) för det fullständiga begärandeschemat och [Batchsamtal](/docs/sv/eleven-agents/phone-numbers/batch-calls) för att köra utgående kampanjer.

## Konfigurera överföringar

Agenter överför samtal till en människa med systemverktyget [`transfer_to_number`](/docs/sv/eleven-agents/customization/tools/system-tools/transfer-to-number).

> **Warning**
>
> Endast konferensöverföringar fungerar via en Sinch-trunk. SIP REFER och blinda överföringar misslyckas.

### Konferensöverföringar

ElevenLabs ringer upp destinationen via din Sinch-trunk, ansluter båda parter i en konferens och kopplar sedan bort agenten.

## Använd Sinch Voice API v2 i stället

Konfigurationen ovan ger ElevenLabs hela röstflödet. Om du behöver att Sinch äger samtalsstyrningen kan Sinch Voice API v2 besvara ett samtal, tillämpa sin egen logik och koppla ett andra samtalsben till din ElevenLabs-agent med SVAML, utan en reläserver. Den modellen passar bättre när du vill lägga in Sinch-funktioner som detektering av telefonsvarare, samtalsinspelning eller nummermaskering innan agenten ansluter, eller när agenten är ett steg i ett större Sinch-samtalsflöde.

Se Sinchs guide [Integrera en ElevenLabs AI-agent via SIP](https://developers.sinch.com/docs/voice-2.0/tutorials/elevenlabs-sip) för andra vanliga scenarier.

## Felsökning

#### Inkommande samtal kan inte ansluta

* Bekräfta att trunkens statiska inkommande slutpunkt riktar sig mot `sip.rtc.elevenlabs.io` på den port och med den transport som du avser att använda.
* Bekräfta att DID-numret är tilldelat till den trunken.
* Kontrollera att numret i ElevenLabs matchar det som Sinch skickar, inklusive inledande `+`.
* Vänta minst 60 sekunder efter att du har ändrat slutpunkter eller ACL:er och testa sedan igen.
* Kontrollera att din brandvägg tillåter SIP-signalering på 5060 för TCP eller 5061 för TLS och inte blockerar RTP.

#### Utgående samtal får svaren 403 eller 407

* Bekräfta att SIP-trunkens användarnamn och lösenord i ElevenLabs matchar inloggningsuppgifterna på Sinch-trunken.
* Kontrollera att fältet **Adress** endast innehåller trunkens FQDN, utan prefixet `sip:`.
* Bekräfta att landsbehörigheter är aktiverade på trunken för destinationslandet.
* Bekräfta att det nummerpresentation-ID som du använder är ett nummer som Sinch godkänner på den trunken.
* Om du förlitar dig på ACL-autentisering, kom ihåg att ElevenLabs signalering kommer från en distribuerad pool av adresser. Byt till digest-autentisering eller gå över till den statiska IP-infrastrukturen.

#### Enkelriktat ljud eller inget ljud

* Bekräfta att din brandvägg tillåter RTP via UDP i båda riktningarna och inte är begränsad till specifika statiska adresser.
* Kontrollera att mediekrypteringen matchar: en TLS Sinch-trunk förväntar sig SRTP, så ställ in mediekryptering på `Allowed` eller `Required` i ElevenLabs.
* Testa med TCP och mediekryptering inaktiverad för att isolera om problemet är relaterat till TLS eller SRTP.
* Kontrollera att G711 erbjuds på trunken. ElevenLabs stöder G711 och G722.

#### Samtal avslutas inte när agenten lägger på

Ett `481`-svar på ett `BYE` innebär vanligtvis att begäran nådde en SIP-server utan dialogstatusen för det samtalet. Skicka begäranden inom dialogen till den `Contact`-URI som returneras i `200 OK`, i stället för till den delade adressen `sip.rtc.elevenlabs.io`. Om `BYE` eller `REFER` via TLS misslyckas med certifikatvalideringen lägger du till FQDN:en som din trunks certifikat är utfärdat för i fältet **Remote domains** i telefonnumrets inställningar.

## Vanliga frågor

#### Vilken transport ska jag använda?

TLS på 5061 för produktion, tillsammans med SRTP-media på Sinch-trunken. TCP på 5060 är en rimlig utgångspunkt för validering. UDP är experimentellt i ElevenLabs och bör inte användas för produktionstrafik.

#### Vilka ljudkodekar är kompatibla?

ElevenLabs stöder G711 (8 kHz) och G722 (16 kHz). Låt G711 erbjudas på Sinch-trunken som gemensam nämnare.

#### Hur skickar jag samtalskontext till konversationen?

Anpassade `X-`-rubriker i inkommande `INVITE` exponeras som dynamiska variabler, där `X-Contact-ID` till exempel blir `{{sip_contact_id}}`. `X-Call-ID` och `X-Caller-ID` mappas till `system__call_sid` respektive `system__caller_id`. Se [SIP-trunking](/docs/sv/eleven-agents/phone-numbers/sip-trunking) för de fullständiga normaliseringsreglerna.

## Användbara länkar

* [Guide om SIP-trunking](/docs/sv/eleven-agents/phone-numbers/sip-trunking)
* [SIP-referens](/docs/sv/eleven-agents/phone-numbers/sip-reference)
* [Överför till nummer](/docs/sv/eleven-agents/customization/tools/system-tools/transfer-to-number)
* [Sinch Voice API v2: integrera en ElevenLabs AI-agent via SIP](https://developers.sinch.com/docs/voice-2.0/tutorials/elevenlabs-sip)