Troubleshooting de vídeo

Antes de abrir ticket pro suporte da Kira, passe por aqui — 90% dos problemas têm diagnóstico simples e estão listados abaixo. Organizado por sintoma.

🔌 Antes da chamada começar

"Cliente disse que não recebeu o link"

Diagnóstico em ordem:

1. Verifique se o agendamento é online — /agenda → click no card → bloco "Vídeo" deve aparecer. Se não aparece, agendamento foi criado como presencial (ver Configurar agenda online)
2. Bot enviou? No detalhe do agendamento, bloco em ouro mostra timestamp "Link enviado em XX:XX". Se vazio, click "💬 Enviar agora" pra disparar manualmente
3. WhatsApp do cliente correto? Confira /clientes/[id] se o número tem DDD + país (ex: 5511999998888)
4. Cliente em lista de bloqueio do WhatsApp? Se você já mandou muita mensagem hoje pra ele e ele não respondeu, WhatsApp pode estar segurando. Tente Telegram alternativo

"Link existe mas cliente disse que não abre"

1. Link expirou? Token tem validade — se o agendamento já passou, link rejeita
2. Cliente clicou no link via app errado? Alguns Androids abrem WhatsApp como navegador interno (in-app browser) em vez do Chrome — vídeo pode falhar lá. Pedir pra copiar link e abrir no Chrome
3. Cliente bloqueou notificações de microfone/câmera? No primeiro click, navegador pede permissão. Se ele negou antes, fica salvo. Soluções:
   • Chrome: ícone cadeado na URL → "Permissões do site" → liberar mic + cam
   • Safari iOS: Configurações → Safari → permissões

🚪 Lobby (autorização)

"Cliente diz que ficou esperando autorização infinito"

1. Você (dono) está logado na Kontato? Lobby precisa que dono esteja com app aberto pra autorizar. Se você fechou aba ou logou off, autorização não chega
2. Push notification configurado? Se você está em outra aba/app, notificação push deveria chegar. Configurar em /configuracoes/push
3. Realtime caiu? Em casos raros, conexão Realtime do dono falha. Solução: recarregar /agenda no navegador

"Vejo notificação mas botão Autorizar não funciona"

1. Você é dono do negócio? Outros usuários (futuro multi-user) podem não ter permissão
2. Bug raro: tente recarregar /agenda antes de clicar Autorizar de novo

📹 Mídia — câmera e microfone

Tela preta no meu vídeo (cam não aparece)

Diagnóstico:

1. Permissão de câmera no navegador: ícone cadeado URL → confirmar mic+cam liberados
2. Outra aba/app está usando a câmera? Zoom, Teams, OBS, OutraSala Daily aberta — conflitam. Feche todos os outros usos antes de entrar
3. Click "Reconectar mídia" na engrenagem ⚙ da ControlBar → resolve 70% dos casos
4. Se não resolver, click "Recarregar chamada" → leave + join completo (~3s)
5. Se ainda não, troque o dispositivo via seletor de câmera — pode ser câmera USB com cabo solto

Cliente vê preto no meu vídeo, mas eu vejo OK

1. Sua câmera está de fato funcionando localmente — problema é na transmissão
2. Provável banda de upload baixa — Daily reduz qualidade automaticamente, pode chegar a 0
3. Verifique indicador de qualidade no header — se vermelho, é isso
4. Tente clicar Reconectar no banner (se aparecer) ou troque pra rede melhor (cabo de rede > WiFi)

Sem áudio (mic não captura)

1. Permissão: cadeado URL → liberar mic
2. Mic mutado no botão da ControlBar? Ícone tem barra cortada se mutado
3. Mic do sistema mutado? Windows: barra de tarefas → ícone som → mic → desmutar. Mac: System Preferences → Sound → Input
4. Mic correto selecionado? Engrenagem ⚙ → verificar device escolhido. Headset USB recém-plugado às vezes não vira default automático
5. Mic com cabo solto — testar headset com outro app antes (gravar áudio em qualquer app)

Eco / microfonia

1. Você tá ouvindo seu próprio áudio voltar — geralmente é sem headset (alto-falante captura mic)
2. Solução: usar headset (mesmo um simples). Krisp ajuda com ruído de fundo mas não resolve eco fundamental
3. Cliente também sem headset? Eco pode vir do lado dele
4. 2 dispositivos do mesmo user (ex: laptop + celular na mesma sala) → causa eco severo. Saia de um deles

Mic captando voz do meu colega ao lado

Daily tem Krisp noise suppression ativo por default. Pra confirmar:

• Engrenagem ⚙ → "Krisp" deve estar ON
• Se ainda passa voz, o algoritmo não distingue 100% — aproxime mic da sua boca (headset boom mic > mic ambient)

🌐 Conexão

Vídeo travando, áudio cortando

Ver Qualidade de conexão e recovery — checklist completo.

Resumo rápido:

1. Indicador de rede (header) — verde/amarelo/vermelho
2. Banner laranja apareceu? Click "Reconectar"
3. Engrenagem → "Reconectar mídia" → "Recarregar chamada" (escalonado)
4. Trocar WiFi → 4G ou cabo de rede
5. Fechar abas Chrome pesadas

Caí da chamada e tentei voltar — não consigo entrar

1. Link de cliente expira ao fechar — pegue link novamente no detalhe do agendamento (dono envia de novo)
2. Servidor Daily bateu rate limit (raro) — esperar 30s e tentar de novo
3. Sessão Daily encerrou no servidor após daily.leave() — dono precisa abrir /v/[token] novamente

🎥 Gravação

"Gravação ficou Processando... infinito"

Causas históricas (corrigidas em v0.27.30):

1. gravacao_ativa=false no DB: quando dono iniciava gravação manualmente, flag não atualizava → cron de polling ignorava. Corrigido: endpoint marcar-gravando chamado pelo RecordingControl quando isRecording vira true
2. Bug no select do cron: relationship inválido no supabase-js retornava undefined silenciosamente. Corrigido: removido o relationship

Hoje, gravação aparece em ~30s após encerramento. Se demorar mais que 5 minutos, há problema técnico.

Endpoint manual de reprocessamento (recovery one-shot):

POST /api/video/sessao/{sessaoId}/reprocessar

(Requer auth de dono do negócio. Implementado em v0.27.32.)

Faz: (1) busca gravação no Daily REST; (2) regenera URL assinada; (3) salva no DB; (4) dispara transcrição + resumo IA em background.

Se nem isso resolver, abra ticket no suporte da Kira com o ID do agendamento.

Botão "Baixar MP4" some

1. Gravação expirou (>30 dias) — vídeo foi removido pra liberar storage. Texto da transcrição persiste
2. URL assinada da AWS S3 expirou (1h) — sistema deveria regenerar automaticamente. Se não regenerar, recarregue a página

Gravação tem áudio mas sem vídeo (ou vice-versa)

1. Cam estava desligada durante toda a chamada → gravação só áudio (correto, esperado)
2. Áudio do mic mutado o tempo todo → gravação só vídeo silencioso
3. Bug raro: gravação corrompida no Daily. Use endpoint reprocessar acima

📝 Transcrição e resumo IA

"Transcrição não apareceu mesmo após 30 minutos"

1. Toggle de transcrição automática está ON? /configuracoes/video → conferir
2. Chamada foi gravada? Transcrição depende de gravação (Whisper precisa do áudio)
3. Cron video-recordings-poll rodou? Cron roda a cada 30min — pode haver atraso de até 30min após a chamada
4. Áudio era inaudível? Whisper retorna vazio se áudio é só silêncio
5. OpenAI rate limited (raro) — esperar e cron tenta de novo

Transcrição com muitos erros

Ver Transcrição e resumo IA — edge cases — depende da qualidade do áudio. Headset bom melhora dramaticamente.

Resumo IA está incoerente

1. Transcrição muito ruim → resumo herda os erros
2. Chamada muito curta (menos de 2min) → resumo pode ser genérico
3. Conversa muito tangencial → resumo IA pode escolher tópicos errados como "principais"

Não há retry automático — resumo é gerado uma vez. Se quiser regenerar, endpoint reprocessar acima dispara tudo novamente.

🎭 Sentimento real-time

Timeline de sentimento vazia

1. Toggle estava ON antes da chamada? Sentimento é flag global por sessão (ver Sentimento real-time)
2. Cliente falou pouco? Sistema só processa chunks com áudio detectável acima de threshold — se cliente ficou calado, timeline fica vazia
3. Áudio do cliente estava ruim? Whisper falha → OpenRouter recebe texto pobre → classificação não acontece

Toast de sentimento não aparece

1. Você é o dono? Cliente NUNCA vê toast (RN-V02). Se você é dono e ainda assim não aparece, problema técnico
2. Sentimento não mudou de categoria — toast só aparece em mudança, não em cada chunk classificado igual ao anterior

🖥 Compartilhar tela

Botão "Compartilhar tela" cinza no iPhone/iPad

iOS Safari NÃO suporta screen share via WebRTC (limitação da Apple, não bug nosso). Solução: usar laptop pra apresentar.

Ver Compartilhar tela — limitação iOS.

Tela compartilhada não aparece pro cliente

1. Cliente recarregou a aba? Stream de tela é ao vivo — quem entra depois não vê o que já passou
2. Permissão: ao iniciar share, navegador abre seletor — você precisa selecionar tela/janela e clicar "Compartilhar"
3. Cancelou o seletor: nada começa a transmitir. Tente de novo

⭐ Pesquisa de qualidade

"Tela ficou preta após eu sair da chamada"

1. Provável erro JS na PesquisaQualidade — recarregue a aba
2. Se persistente, abra console do navegador (F12) e mande print pro suporte

Pesquisa de qualidade não apareceu

1. Sessão durou menos de 30s? Sistema pula pesquisa automaticamente (ver Pesquisa de qualidade)
2. Nada errado — comportamento esperado

💸 Trial e add-on

Cliente foi cortado abruptamente no meio da chamada

1. Trial 15min esgotou mid-call? Sistema encerra automaticamente quando bater 900s totais cumulativos do negócio (ver Como ativar vídeo)
2. Solução: ativar add-on em /configuracoes/video ANTES da próxima chamada — add-on não tem limite individual

Trial não está zerando após mês novo

Trial NÃO É MENSAL — é cumulativo lifetime. Os 15min são por negócio, pra sempre (até você ativar add-on). Não há reset.

🛠 Quando abrir ticket pro suporte da Kira

Se passou pelo checklist acima e ainda tem problema:

1. Botão "?" no AppHeader → conversa direta com a Kira (IA de suporte)
2. Inclua:
   • ID do agendamento (URL /agenda/[id] ou copiado do detalhe)
   • Sintoma exato ("vídeo travou às 14:32 e não voltou")
   • O que você já tentou ("Reconectar mídia, Recarregar chamada, mudei pro 4G")
   • Print de tela se relevante
3. Kira escala pra equipe humana se não souber responder

Tempo de resposta esperado

• Bug visual / dúvida: minutos (Kira responde direto)
• Bug técnico: horas (Kira escala, equipe responde)
• Incidente em produção: minutos (alerta automático Telegram)

🐛 Reportar bug novo

Se você encontrou comportamento que claramente não é o esperado e não está no checklist acima:

1. Abra chat com Kira (botão ?)
2. Comece com "Possível bug:"
3. Descreva passos pra reproduzir
4. Inclua versão do app (mostrada no rodapé do menu Configurações — ex: v0.28.x)
5. Print da tela ou vídeo se possível

Eu (a IA da Kira) vou registrar como suporte_pendencia com prefixo [Bug] e equipe será notificada via Telegram.

Próximos artigos

• Visão geral do vídeo atendimento — começo do tour
• Como ativar vídeo — trial vs add-on
• Qualidade de conexão — recovery detalhado