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

# Realtime monitoring

Met realtime monitoring kun je agentgesprekken live observeren via WebSocket en actieve gesprekken op afstand besturen. Deze functie biedt realtime inzicht in gespreksgebeurtenissen en maakt ingrijpen via besturingsopdrachten mogelijk.

> **Note**
>
> Dit is een functie die alleen beschikbaar is voor Enterprise.

## Overzicht

Monitoringssessies streamen gespreksgebeurtenissen realtime, waaronder transcripten, reacties van de agent en correcties. Je kunt ook besturingsopdrachten versturen om gesprekken te beëindigen, door te verbinden naar telefoonnummers of menselijke overname in te schakelen tijdens actieve chatgesprekken.

## WebSocket-endpoint

Maak verbinding met een live gesprek via het monitoringendpoint:

```
wss://api.elevenlabs.io/v1/convai/conversations/{conversation_id}/monitor
```

Vervang `{conversation_id}` door de ID van het gesprek dat je wilt monitoren.

## Authenticatie

Voor authenticatie is het volgende vereist:

* **API-sleutelmachtigingen**: Je API-sleutel moet de scope `ElevenLabs Agents Write` hebben
* **Workspacetoegang**: Je moet `EDITOR`-toegang hebben tot de workspace van de agent
* **Headerindeling**: Voeg je API-sleutel toe via de header `xi-api-key`

### Voorbeeldverbinding

```javascript
const ws = new WebSocket('wss://api.elevenlabs.io/v1/convai/conversations/conv_123/monitor', {
  headers: {
    'xi-api-key': 'your_api_key_here',
  },
});
```

```python
import websockets
import asyncio

async def monitor_conversation():
    uri = "wss://api.elevenlabs.io/v1/convai/conversations/conv_123/monitor"
    headers = {
        "xi-api-key": "your_api_key_here"
    }

    async with websockets.connect(uri, extra_headers=headers) as websocket:
        # Connection established
        pass
```

## Configuratie

Schakel de functie in de instellingen van je agent in voordat je gesprekken monitort:

### Ga naar de agentinstellingen

Open de configuratiepagina van je agent in het dashboard.

### Schakel monitoring in

Schakel in het paneel Advanced-instellingen de optie "Monitoring" in.

![Schakelaar voor monitoring in agentinstellingen](/docs/_fern-img/1a4b5507a39ddf6a517772b8c01ede5f7d12429175fdf89e04c8ba910f646f8e.webp)

### Selecteer gebeurtenissen

Kies welke gebeurtenissen je wilt monitoren. Bekijk [Client Events](/docs/nl/eleven-agents/customization/events/client-events) voor een volledige lijst met beschikbare gebeurtenissen.

> **Warning**
>
> De volgende gebeurtenissen kunnen niet worden gemonitord: VAD-scores, metriek voor beurtkans en pings.

> **Info**
>
> Het gesprek moet actief zijn voordat je verbinding kunt maken om het te monitoren. Je kunt een
> gesprek niet monitoren voordat het begint.

## Besturingsopdrachten

Stuur JSON-opdrachten via de WebSocket om het gesprek te besturen:

#### Gesprek beëindigen

Beëindig het actieve gesprek onmiddellijk.

```javascript
// End the active conversation
ws.send(JSON.stringify({
  command_type: "end_call"
}));
```

```python
import json

# End the active conversation
await websocket.send(json.dumps({
    "command_type": "end_call"
}))
```

#### Doorverbinden naar telefoonnummer

Verbind het gesprek door naar een opgegeven telefoonnummer.

```javascript
// Transfer to a phone number
ws.send(JSON.stringify({
  command_type: "transfer_to_number",
  parameters: {
    phone_number: "+1234567890"
  }
}));
```

```python
import json

# Transfer to a phone number
await websocket.send(json.dumps({
    "command_type": "transfer_to_number",
    "parameters": {
        "phone_number": "+1234567890"
    }
}))
```

> **Note**
>
> De systeemtool `transfer_to_number` moet al in de agent zijn geconfigureerd.

#### Realtime contextuele update

Voeg context of instructies toe aan het actieve gesprek, zodat de agent de nieuwe
informatie in zijn reacties kan gebruiken.

```javascript
// Send a contextual update to the agent
ws.send(JSON.stringify({
  command_type: "contextual_update",
  parameters: {
    contextual_update: "<your update text>"
  }
}));
```

```python
import json

# Send a contextual update to the agent
await websocket.send(json.dumps({
    "command_type": "contextual_update",
    "parameters": {
        "contextual_update": "<your update text>"
    }
}))
```

#### Menselijke overname inschakelen

Schakel voor chatgesprekken over van AI-agent naar menselijke operator.

```javascript
// Enable human takeover
ws.send(JSON.stringify({
  command_type: "enable_human_takeover"
}));
```

```python
import json

# Enable human takeover
await websocket.send(json.dumps({
    "command_type": "enable_human_takeover"
}))
```

#### Bericht verzenden als mens

Stuur in chatgesprekken een bericht naar de gebruiker als menselijke operator.

```javascript
// Send a message as a human operator
ws.send(JSON.stringify({
  command_type: "send_human_message",
  parameters: {
    text: "How can I help you?"
  }
}));
```

```python
import json

# Send a message as a human operator
await websocket.send(json.dumps({
    "command_type": "send_human_message",
    "parameters": {
        "text": "How can I help you?"
    }
}))
```

#### Menselijke overname uitschakelen

Geef de controle terug van de menselijke operator aan de AI-agent.

```javascript
// Disable human takeover and return to AI
ws.send(JSON.stringify({
  command_type: "disable_human_takeover"
}));
```

```python
import json

# Disable human takeover and return to AI
await websocket.send(json.dumps({
    "command_type": "disable_human_takeover"
}))
```

## Gebruiksscenario's

Realtime monitoring maakt verschillende operationele scenario's mogelijk:

#### Kwaliteitsborging

Monitor agentgesprekken realtime om kwaliteitsnormen te waarborgen en trainingsmogelijkheden
te identificeren.

#### Escalatie naar mens

Detecteer gesprekken die menselijke tussenkomst vereisen en neem deze naadloos over van de AI-agent.

#### Analyticsdashboards

Bouw realtime monitoringsdashboards die gespreksstatistieken en prestatie-
indicatoren samenvoegen.

#### Toezicht op callcenters

Houd tegelijkertijd toezicht op meerdere agentgesprekken en grijp in wanneer dat nodig is.

#### Geautomatiseerd ingrijpen

Implementeer geautomatiseerde systemen die gespreksinhoud analyseren en acties activeren op basis van
specifieke voorwaarden.

#### Training en coaching

Gebruik live gesprekken als trainingsmateriaal en geef realtime feedback om de prestaties van de agent
te verbeteren.

## Beperkingen

#### Asynchrone gebeurtenislevering

Monitoringsgebeurtenissen worden asynchroon naar het gesprek gestuurd en komen mogelijk niet in dezelfde
volgorde aan als de kerngebeurtenissen van het gesprek. Vertrouw bij het verwerken van gebeurtenissen niet op de gebeurtenisvolgorde om
de exacte timing van het gesprek te reconstrueren.

#### აუდiodata niet beschikbaar

Het monitoringendpoint streamt alleen tekstgebeurtenissen en metadata. Ruwe audiodata zijn niet opgenomen in
monitoringsgebeurtenissen.

#### Limiet voor historische gebeurtenissen

Alleen ongeveer de laatste 100 gebeurtenissen worden gecachet en zijn beschikbaar wanneer je verbinding maakt met een actief
gesprek. Eerdere gebeurtenissen kunnen niet worden opgehaald.

#### Beperkingen voor gebeurtenisfiltering

VAD-scores, metriek voor beurtkans en pinggebeurtenissen kunnen niet worden gemonitord wanneer aangepaste gebeurtenis-
selectie is ingeschakeld.

#### Timing van verbinding

Je moet verbinding maken nadat het gesprek is gestart. Het monitoringendpoint kan niet worden gebruikt
voordat het gesprek is gestart.

#### Vereiste machtigingen

API-sleutels moeten de scope `ElevenLabs Agents Write` hebben en je moet `EDITOR`-workspacetoegang hebben
om gesprekken te monitoren.

## Gerelateerde bronnen

#### [Webhooks na gesprekken](/docs/nl/eleven-agents/workflows/post-call-webhooks)

Ontvang gespreksdata en -analyse nadat gesprekken zijn voltooid.

#### [Agentanalyse](/docs/nl/eleven-agents/customization/agent-analysis)

Configureer succesbeoordeling en gegevensverzameling voor gesprekken.

#### [Client Events](/docs/nl/eleven-agents/customization/events/client-events)

Begrijp gebeurtenissen die tijdens conversationele applicaties worden ontvangen.

#### [WebSocket API](/docs/nl/eleven-agents/libraries/web-sockets)

Lees meer over de WebSocket API voor realtime gesprekken.