Skip to navigation
Monitoren

Realtime monitoring

Observeer live gesprekken en stuur besturingsopdrachten tijdens actieve gesprekken

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.

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

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

Configuratie

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

1

Ga naar de agentinstellingen

Open de configuratiepagina van je agent in het dashboard.

2

Schakel monitoring in

Schakel in het paneel Advanced-instellingen de optie “Monitoring” in.

Schakelaar voor monitoring in agentinstellingen

3

Selecteer gebeurtenissen

Kies welke gebeurtenissen je wilt monitoren. Bekijk Client Events voor een volledige lijst met beschikbare gebeurtenissen.

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

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:

Beëindig het actieve gesprek onmiddellijk.

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

Verbind het gesprek door naar een opgegeven telefoonnummer.

// Transfer to a phone number
ws.send(JSON.stringify({
  command_type: "transfer_to_number",
  parameters: {
    phone_number: "+1234567890"
  }
}));
De systeemtool transfer_to_number moet al in de agent zijn geconfigureerd.

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

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

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

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

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

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

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

// Disable human takeover and return to AI
ws.send(JSON.stringify({
  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

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.

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

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.

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

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

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

Gerelateerde bronnen

Webhooks na gesprekken

Ontvang gespreksdata en -analyse nadat gesprekken zijn voltooid.

Agentanalyse

Configureer succesbeoordeling en gegevensverzameling voor gesprekken.

Client Events

Begrijp gebeurtenissen die tijdens conversationele applicaties worden ontvangen.

WebSocket API

Lees meer over de WebSocket API voor realtime gesprekken.