Vonage-integrering

Integrera ElevenAgents med Vonage-röstsamtal med hjälp av en WebSocket-anslutning.

Översikt

Anslut ElevenLabs Agents till samtal via Vonage Voice API eller Video API med en WebSocket-anslutningsapplikation. 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:

Vonage initierar en WebSocket-anslutning till anslutningen för ett aktivt samtal.
Anslutningen upprättar en WebSocket-anslutning till ElevenLabs Agents-slutpunkten.
Ljudet vidarebefordras: Vonage (L16) -> Anslutning -> ElevenLabs (base64) och vice versa.
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, som är länkad i sidofältet.
Agent-ID: Hitta agenten i ElevenAgents-instrumentpanelen. 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.

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

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

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:

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 med PROCESSOR_SERVER inställd på anslutningens värdnamn.
Uppdatera en befintlig app: Ändra ditt Nexmo Call Control Object 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.