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

# Vonage-integrering

## Översikt

Anslut ElevenLabs Agents till samtal via Vonage Voice API eller Video API med en [WebSocket-anslutningsapplikation](https://github.com/nexmo-se/elevenlabs-agent-ws-connector). Det möjliggör dubbelriktad ljudströmning i realtid för användningsområden som PSTN-samtal, SIP-trunkar och WebRTC-klienter.

## Så fungerar det

Node.js-anslutningen bygger en brygga mellan Vonage och ElevenLabs:

1. Vonage initierar en WebSocket-anslutning till anslutningen för ett aktivt samtal.
2. Anslutningen upprättar en WebSocket-anslutning till ElevenLabs Agents-slutpunkten.
3. Ljudet vidarebefordras: Vonage (L16) -> Anslutning -> ElevenLabs (base64) och vice versa.
4. Anslutningen hanterar konversationshändelser (`user_transcript`, `agent_response`, `interruption`).

## Konfiguration

### 1. Hämta ElevenLabs-uppgifter

* **API-nyckel**: API-nycklar finns på fliken [API Keys på sidan Developers](https://elevenlabs.io/app/developers), som är länkad i sidofältet.
* **Agent-ID**: Hitta agenten i [ElevenAgents-instrumentpanelen](https://elevenlabs.io/app/agents/agents/). När du har valt agenten klickar du på inställningsknappen och väljer "Copy Agent ID".

### 2. Konfigurera anslutningen

Klona kodarkivet och konfigurera miljöfilen.

```bash
git clone https://github.com/nexmo-se/elevenlabs-agent-ws-connector.git
cd elevenlabs-agent-ws-connector
cp .env.example .env
```

Lägg till dina uppgifter i `.env`:

**`.env`**

```bash title=".env"
ELEVENLABS_API_KEY = YOUR_API_KEY;
ELEVENLABS_AGENT_ID = YOUR_AGENT_ID;
```

Installera beroenden: `npm install`.

### 3. Exponera anslutningen (lokal utveckling)

Använd ngrok eller en liknande tjänst för att skapa en offentlig URL för anslutningen (standardporten är 6000).

```bash
ngrok http 6000
```

Notera den offentliga `Forwarding`-URL:en (t.ex. `xxxxxxxx.ngrok-free.app`). **Ta inte med `https://`** när du konfigurerar Vonage.

### 4. Kör anslutningen

Starta applikationen:

```bash
node elevenlabs-agent-ws-connector.cjs
```

### 5. Konfigurera Vonage-röstapplikationen

Din Vonage-app måste ansluta till anslutningens WebSocket-slutpunkt (`wss://YOUR_CONNECTOR_HOSTNAME/socket`). Detta är ngrok-URL:en från steg 3.

* **Använd exempelappen**: Konfigurera [Vonage-exempelappen](https://github.com/nexmo-se/voice-to-ai-engines) med `PROCESSOR_SERVER` inställd på anslutningens värdnamn.
* **Uppdatera en befintlig app**: Ändra ditt [Nexmo Call Control Object](https://developer.vonage.com/en/voice/voice-api/ncco-reference) så att det inkluderar en `connect`-åtgärd som riktar sig mot anslutningens WebSocket-URI (`wss://...`) med `content-type: audio/l16;rate=16000`. Skicka med nödvändiga frågeparametrar som `peer_uuid` och `webhook_url`.

### 6. Testa

Ring ett inkommande eller utgående samtal via din Vonage-applikation för att interagera med ElevenLabs-agenten.

## Molndistribution

För produktion distribuerar du anslutningen till en stabil webbhotellsleverantör (t.ex. Vonage Cloud Runtime) med ett offentligt värdnamn.