Esse é o roteiro completo de uma chamada de vídeo na Kontato pelo lado do dono. Use esse artigo como referência pra primeira chamada e como manual de troubleshooting depois.
Pré-requisitos: add-on de vídeo ativo (ou trial 15min ainda disponível) + agenda configurada como online ou híbrido + agendamento criado. Se você não tem ainda, leia Como ativar e Configurar agenda online primeiro.
ANTES DA CHAMADA
1. Localizar o agendamento
5 a 15 minutos antes do horário marcado, vá em /agenda (ou pelo menu lateral). Localize o card do agendamento:
- Em agenda online, o card mostra ícone de vídeo (📹) na cor de fundo
- Status do card: "Confirmado" (azul) ou "Em curso" (verde) se já está rolando
- Em agendas híbridas, o ícone difere: 📹 (vídeo) ou 🏠 (presencial) por agendamento
💡 Se o cliente já confirmou pelo bot, o link já foi enviado pra ele no WhatsApp algumas horas antes. Não precisa enviar de novo. Se tiver dúvida, abra o detalhe e clique "Enviar agora".
2. Abrir o detalhe e iniciar
Clique no card do agendamento — abre o modal de detalhe. No bloco "Atendimento por videochamada":
- Link da sala (visível, pode copiar)
- 3 botões: Abrir (entra você), Copiar (link pra clipboard), Enviar (manda pelo WhatsApp pro cliente)
Clique em Abrir → vai pra /video/[id].
3. Pre-call test
Antes de entrar na sala, o sistema roda um teste rápido de câmera, microfone e qualidade de banda:
- Câmera: você se vê na pré-visualização. Se tiver mais de uma câmera, escolha no dropdown
- Microfone: barra de volume reage à sua voz. Se nada acontece, escolha outro mic no dropdown
- Banda: badge mostra "Boa", "Razoável" ou "Fraca"
- Permissões do navegador: se aparecer "Câmera bloqueada", clique no ícone de cadeado na URL e permita
Clique "Estou pronto" quando tudo estiver verde.
⚠️ Se sua banda está "Fraca", a chamada vai funcionar mas pode travar/borrar. Considere trocar pra rede com fio ou outra Wi-Fi antes de iniciar.
NA SALA — ANTES DO CLIENTE ENTRAR
4. O que você vê quando entra
Você está sozinho na sala. O que aparece:
-
Header:
- Countdown "Encerra em XX:XX" (vermelho se faltam menos de 2 min, amarelo abaixo de 5 min, verde acima de 5 min) + tempo decorrido "· 0:42"
- Botão Lobby (vai virar dourado quando alguém entrar esperando)
- Botão Fundos (escolhe fundo virtual)
- Botão Link cliente (copia/envia link)
- Botão Sun/Lua (alterna tema light/dark da sala — só você vê)
- Botão Encerrar (vermelho)
-
Centro: tile fullscreen seu (única pessoa na sala) ou mensagem "Aguardando participantes…"
-
PiP do self-view (canto inferior direito): janela pequena com seu vídeo. Você pode arrastar pra qualquer canto e redimensionar pelo canto inferior-direito
-
Barra de controles (auto-hide após 3s sem mouse, aparece em hover): mic, câmera, share tela, layout, hand raise, reactions, fullscreen, blur, chat, engrenagem (devices), gravar, sair
5. Cliente solicita entrada (lobby)
Quando o cliente abre o link no WhatsApp e passa pelo pre-call dele:
- Badge "Lobby" no header vira dourado: "1 esperando" (ou N se múltiplos)
- Toast efêmero desce do topo: "[Nome do cliente] está aguardando" (8s, clicável)
- Modal Lobby (clique no badge ou no toast): mostra lista de pessoas esperando com:
- Nome do cliente
- Tempo de espera ("esperando há 23s")
- Nome da agenda + horário do agendamento
- 2 botões grandes: ✓ Autorizar | ✗ Recusar
💡 O cliente espera no Lobby Kontato (tela própria com Realtime), não dentro da sala Daily. Esse tempo de espera não consome seus minutos de trial nem é cobrado.
6. Autorizar
Clique Autorizar. O cliente:
- Vê tela "Entrando…" por ~600ms (fade out do avatar)
- Entra direto na sala (não refaz pre-call test)
- Aparece como tile na grade
A partir desse momento, a cobrança começa (do "joined-meeting" do primeiro participante até o "leave-meeting" do último). Modalidade marcar-iniciada é chamada e a sessão fica oficialmente "Em curso".
DURANTE A CHAMADA
7. Layout e tiles
A grade adapta automaticamente ao número de participantes:
- 1 (só você): tile fullscreen
- 2 (você + cliente): split 50/50 horizontal (desktop) ou empilhado (mobile)
- 3: 2 em cima + 1 embaixo (desktop) / 3 empilhados (mobile)
- 4: grid 2×2
- 5+: layout Speaker (foco no falante + thumbs lateral)
- Quando alguém compartilha tela: layout especial automático (screen grande + thumbs)
Você pode trocar manualmente entre Grid e Speaker pelo dropdown de layout (atalho L).
8. Self-view PiP
Sua janela pequena no canto:
- Arrastar: clique e segure no header (com 6 pontinhos brancos) ou em qualquer parte e mova
- Redimensionar: pegue o canto inferior-direito
- Posição/tamanho persistidos: na próxima chamada, abre onde você deixou
9. Controles in-call (barra inferior)
Da esquerda pra direita:
| Botão | Atalho | O que faz |
|---|---|---|
| Mic + chevron | M | Toggle mic; chevron abre seletor de microfone/alto-falante |
| Câmera + chevron | V | Toggle câmera; chevron abre seletor de câmera |
| Compartilhar tela | S | Inicia/para screen share |
| Layout | L | Dropdown Grid/Speaker |
| Hand raise (✋) | H | Levanta a mão (broadcast pra todos) |
| Reactions | E | Popover com 5 emojis (👍 ❤️ 🎉 👏 😂) |
| Fullscreen | F | Tela cheia do navegador |
| Background blur | B | Toggle blur direto / popover de fundos |
| Chat | C | Painel de chat in-call |
| Engrenagem | — | Menu completo: trocar câmera/mic/alto-falante + Reconectar mídia + Recarregar chamada |
| REC | R | Iniciar/parar gravação (badge pulsante no header quando gravando) |
| Sair | — | Encerra chamada |
10. Gravação
Se gravacao_padrao=true na config global, gravação começa automaticamente quando você entra. Caso contrário, clique REC quando quiser começar.
- Badge REC pulsante no header: indicador visual de que está gravando
- Cliente NÃO vê o badge nem o botão (privacidade)
- Para parar: clique REC de novo (ou encerrar a chamada para automaticamente)
- Após encerrar: gravação fica disponível em ~30 segundos no detalhe do agendamento (ver artigo Gravação)
11. Fundos virtuais
Botão Fundos no header (ou B em popover) abre painel:
- Sem fundo — desliga
- Borrar leve / Borrar forte — 2 níveis de blur
- 12 imagens curadas — escritório, consultório, estúdio, etc.
12. Avisos de fim e extensão
Quando faltam 5 minutos pro hora_fim da agenda:
- Toast amarelo top-right: "A chamada termina em 5 minutos."
- Botões inline (só dono): +5 / +10 / +15 / +30 / Picker livre
Quando faltam 1 minuto: toast laranja, mais urgente.
Quando faltam 15 segundos: banner vermelho pulsante no topo, countdown.
Se você estende, o cliente vê os avisos novamente após o novo
hora_fimse aproximar. O cliente não vê o horário absoluto — só os avisos.
ENCERRAR
13. Encerrar a chamada
Clique Encerrar no canto superior direito ou na barra de controles.
- Você sai da sala
- Servidor recebe
POST /api/video/encerrar→ marcaencerrada_emna sessão, calcula duração, registra no billing (se add-on ativo) ou soma ao trial (se ainda em trial) - Se gravação estava ativa,
stopRoomRecordingé chamado no Daily REST (v0.27.32) — gravação é finalizada - Cliente é desconectado automaticamente quando o último participante sai
14. Pesquisa de qualidade
Após encerrar, você vai pra tela de PesquisaQualidade:
- 1-5 estrelas
- Campo opcional de comentário
- Você pode pular ("Avaliar depois")
Cliente também vê pesquisa do lado dele. Avaliações ≤ 2★ disparam tag automática video-com-problema no agendamento + notificação Telegram pro admin Kontato.
💡 Sessão menor que 30s pula avaliação automaticamente (não faz sentido avaliar uma chamada que não rolou).
PÓS-CHAMADA
15. Acessar a gravação
A gravação demora ~30 segundos pra ficar disponível depois do encerramento. Onde encontrar:
- No detalhe do agendamento (
/agenda→ clique no card): bloco "Gravação" com botões Assistir e Baixar - No histórico geral:
/configuracoes/video/historico— lista cronológica com filtros e busca
A gravação inclui:
- Vídeo MP4 (renderizado pelo Daily, com áudio mixado)
- Transcrição (se ativa) acessível no player com sync click-to-seek
- Resumo IA (3-5 bullets) gerado automático
- Timeline de sentimento (se ativa) sincronizada
Retenção padrão: 30 dias. Após esse prazo, vídeo expira mas transcrição e resumo continuam.
EDGE CASES (quando dá ruim)
Cliente não aparece no horário
- O bot já avisou 24h antes e 1h antes pelo WhatsApp
- Você espera no lobby até ele clicar no link
- Se ele não vem em 5-10min, entre em contato pelo WhatsApp (mensagem rápida "tô na chamada, aguardando você")
- Se não responder, encerre a chamada — cobra apenas o tempo que você ficou (mínimo 5s pra contar pra cobrança)
Você fica sozinho na sala (cliente saiu)
- Após 60 segundos sozinho com pelo menos 1 outra pessoa tendo entrado antes, o sistema encerra automaticamente e para a gravação
- Se ele cair e voltar em até 60s, sistema cancela o auto-encerramento
Conexão cair durante a chamada
- Auto-recovery silencioso: track-stopped local (câmera/mic) → restart automático; erro fatal → 1 tentativa de leave+join silencioso
- Banner topo "Conexão instável" se network=very-low por 5s+: clique Reconectar pra forçar reconexão
- Engrenagem na ControlBar → Reconectar mídia (manual, mais leve) ou Recarregar chamada (último recurso, leave+join completo)
Tile do cliente congelado (mas conexão "ok")
- Caso clássico que o auto-recovery não pega
- Use Reconectar mídia na engrenagem (toggle de mic + restart câmera)
- Se persistir, Recarregar chamada — você sai e volta em ~3s
Câmera/mic abriu em outro app
- O sistema detecta e tenta restart automático (track-stopped event)
- Se não pegou, vá na engrenagem → Reconectar mídia
Você fechou a aba sem clicar Encerrar
- Sistema chama
daily.leave()automaticamente no unmount encerrarSessaoé chamado vianavigator.sendBeaconantes do unloadstopRoomRecordingno Daily REST evita que a gravação fique órfã (v0.27.32)
Trial esgota DURANTE a chamada
- Toast laranja "1 minuto restante de trial" + banner vermelho 15s + leave automático ao zerar
- Você é levado pra
TrialEsgotadoViewcom CTA "Ativar add-on"
Próximos artigos
- Jornada do cliente — o que ele vê do outro lado
- Glossário de botões da sala — referência visual rápida
- Gravação — onde acessar, baixar, expirar
- Qualidade da conexão — adaptive bitrate, reconectar
- Troubleshooting — problemas comuns e soluções