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

EstadoSignificado
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

  1. 1Provedor: LiveKit Cloud (ou self-hosted).
  2. 2Token: o frontend obtém um JWT via /api/calls/voip/token (rota em whatsapp-service) com identidade do agente e sala.
  3. 3Conexão: estabelece sessão WebRTC peer-to-peer com TURN relay quando necessário.
  4. 4Registro: cada chamada gera entrada em call_history com duração, status final, gravação opcional.

Pré-requisitos

  • Plano Pro ou superior
  • Feature flag calls ativada 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)