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

# Monitoramento em tempo real

O monitoramento em tempo real permite observar ao vivo as conversas dos agentes via WebSocket e controlar remotamente chamadas ativas. Esse recurso oferece visibilidade em tempo real dos eventos da conversa e permite intervir por meio de comandos de controle.

> **Note**
>
> Este recurso está disponível apenas para empresas.

## Visão geral

As sessões de monitoramento transmitem eventos de conversa em tempo real, incluindo transcrições, respostas do agente e correções. Você também pode enviar comandos de controle para encerrar chamadas, transferir para números de telefone ou habilitar a intervenção humana durante conversas de chat ativas.

## Endpoint WebSocket

Conecte-se a uma conversa ao vivo usando o endpoint de monitoramento:

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

Substitua `{conversation_id}` pelo ID da conversa que você quer monitorar.

## Autenticação

A autenticação exige:

* **Permissões da chave de API**: sua chave de API deve ter o escopo `ElevenLabs Agents Write`
* **Acesso ao workspace**: você deve ter acesso `EDITOR` ao workspace do agente
* **Formato do cabeçalho**: inclua sua chave de API pelo cabeçalho `xi-api-key`

### Exemplo de conexão

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

## Configuração

Antes de monitorar conversas, habilite o recurso nas configurações do agente:

### Acessar as configurações do agente

Abra a página de configuração do agente no dashboard.

### Habilitar o monitoramento

No painel de configurações avançadas, ative a opção "Monitoramento".

![Botão de monitoramento nas configurações do agente](/docs/_fern-img/1a4b5507a39ddf6a517772b8c01ede5f7d12429175fdf89e04c8ba910f646f8e.webp)

### Selecionar eventos

Escolha quais eventos você quer monitorar. Consulte [Eventos do cliente](/docs/pt/eleven-agents/customization/events/client-events) para ver uma lista completa dos eventos disponíveis.

> **Warning**
>
> Os seguintes eventos não podem ser monitorados: pontuações de VAD, métricas de probabilidade de turno e pings.

> **Info**
>
> A conversa deve estar ativa antes de você poder se conectar para monitorá-la. Não é possível monitorar uma
> conversa antes de ela começar.

## Comandos de controle

Envie comandos JSON pelo WebSocket para controlar a conversa:

#### Encerrar chamada

Encerre a conversa ativa imediatamente.

```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"
}))
```

#### Transferir para um número de telefone

Transfira a chamada para um número de telefone específico.

```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**
>
> A ferramenta de sistema `transfer_to_number` já deve estar configurada no agente.

#### Atualização contextual em tempo real

Insira contexto ou instruções na conversa ativa para que o agente possa usar as novas
informações nas respostas.

```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>"
    }
}))
```

#### Habilitar intervenção humana

Mude do agente de IA para o modo de operador humano nas conversas de chat.

```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"
}))
```

#### Enviar mensagem como humano

Envie uma mensagem ao usuário como um operador humano nas conversas de chat.

```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?"
    }
}))
```

#### Desabilitar intervenção humana

Devolva o controle do operador humano ao agente de IA.

```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"
}))
```

## Casos de uso

O monitoramento em tempo real permite vários cenários operacionais:

#### Garantia de qualidade

Monitore as conversas dos agentes em tempo real para garantir padrões de qualidade e identificar
oportunidades de treinamento.

#### Escalonamento humano

Detecte conversas que exigem intervenção humana e assuma o controle do agente de IA sem interrupções.

#### Dashboards de análise

Crie dashboards de monitoramento em tempo real que agregam métricas de conversa e indicadores
de desempenho.

#### Supervisão de central de atendimento

Supervisione várias conversas de agentes simultaneamente e intervenha quando necessário.

#### Intervenção automatizada

Implemente sistemas automatizados que analisam o conteúdo das conversas e acionam ações com base em
condições específicas.

#### Treinamento e orientação

Use conversas ao vivo como material de treinamento e forneça feedback em tempo real para melhorar o
desempenho do agente.

## Limitações

#### Entrega assíncrona de eventos

Os eventos de monitoramento são enviados de forma assíncrona à conversa e podem não chegar na mesma
ordem dos eventos principais da conversa. Ao processar eventos, não dependa da ordem deles para
reconstruir o momento exato da conversa.

#### Dados de áudio indisponíveis

O endpoint de monitoramento transmite apenas eventos de texto e metadados. Dados de áudio brutos não são incluídos nos
eventos de monitoramento.

#### Limite de eventos históricos

Apenas aproximadamente os últimos 100 eventos são armazenados em cache e ficam disponíveis ao se conectar a uma
conversa ativa. Eventos anteriores não podem ser recuperados.

#### Restrições de filtragem de eventos

Pontuações de VAD, métricas de probabilidade de turno e eventos de ping não podem ser monitorados quando a seleção personalizada de eventos
está habilitada.

#### Momento da conexão

Você deve se conectar depois que a conversa tiver começado. O endpoint de monitoramento não pode ser usado
antes do início da conversa.

#### Permissões necessárias

As chaves de API devem ter o escopo `ElevenLabs Agents Write`, e você deve ter acesso `EDITOR` ao workspace
para monitorar conversas.

## Recursos relacionados

#### [Webhooks pós-chamada](/docs/pt/eleven-agents/workflows/post-call-webhooks)

Receba dados e análises da conversa após a conclusão das chamadas.

#### [Análise de agentes](/docs/pt/eleven-agents/customization/agent-analysis)

Configure a avaliação de sucesso e a coleta de dados para conversas.

#### [Eventos do cliente](/docs/pt/eleven-agents/customization/events/client-events)

Entenda os eventos recebidos durante aplicações conversacionais.

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

Saiba mais sobre a API WebSocket para conversas em tempo real.