Visão geral de Chamadas
O Zivlo oferece chamadas de voz integradas, baseadas em WebRTC (LiveKit), permitindo que agentes recebam e façam ligações direto pelo navegador, sem softphone externo.
Disponibilidade
Funcionalidade opcional, controlada pelo feature flag calls no PostHog. Quando habilitada, aparece como Sidebar > Chamadas (/calls).
Onde acessar
- Rota:
/calls(fila de chamadas) - Banner de chamada recebida: aparece no topo de qualquer página em qualquer rota autenticada (componente
- Barra de chamada ativa: aparece quando há ligação em andamento (componente
Estados de chamada
| Estado | Significado |
|---|---|
| Tocando (ringing) | Chamada entrante aguardando agente atender |
| Atendida (active) | Áudio fluindo entre agente e contato |
| Em espera (hold) | Áudio pausado |
| Encerrada (ended) | Registro fica no histórico com duração |
Como funciona
- 1Provedor: LiveKit Cloud (ou self-hosted).
- 2Token: o frontend obtém um JWT via
/api/calls/voip/token(rota emwhatsapp-service) com identidade do agente e sala. - 3Conexão: estabelece sessão WebRTC peer-to-peer com TURN relay quando necessário.
- 4Registro: cada chamada gera entrada em
call_historycom duração, status final, gravação opcional.
Pré-requisitos
- Plano Pro ou superior
- Feature flag
callsativada para o tenant - Microfone funcional no navegador (com permissão concedida)
- Configuração de número/SIP no provedor (gerenciado pela equipe Zivlo)
Histórico
A página /calls mostra:
- Fila de chamadas pendentes (tocando agora)
- Ativas (em andamento, em outros agentes)
- Histórico com filtros (status, agente, intervalo de data)