Sincronização e recuperação da coleta
Como a coleta do Google Meet e do PABX Onvox roda, o que acontece quando ela para, o que é recuperado sozinho depois e como desbloquear uma conta.
Sincronização e recuperação da coleta
A coleta automática traz reuniões do Google Meet e ligações do PABX Onvox para a Onvox AI sem ninguém precisar subir arquivo. Esta página explica o que acontece quando essa coleta para por um tempo — e o que volta sozinho depois.
Em três linhas:
- A coleta roda a cada 5 minutos. No modo Total diário, ela olha tudo desde a data em que a integração foi conectada — então o que ficou para trás durante uma parada é recuperado sozinho quando ela volta. Nos modos por dia (Quantidade e Amostragem), só o dia corrente é recuperado.
- Instabilidade do Google ou falha de rede não exige ação: a conta tenta de novo sozinha, num cronograma crescente.
- Só um problema de autorização (senha trocada, acesso revogado) exige que o usuário reconecte a conta.
Como a coleta roda
Existem dois modos de coleta, configurados por empresa, e eles se comportam de forma diferente numa parada.
| Modo (nome na tela) | Quando roda | O que coleta |
|---|---|---|
| Total diário | a cada 5 minutos, o dia todo | tudo o que é elegível desde a data de conexão, sem repetir o que já foi analisado |
| Quantidade (por pessoa/dia) | a cada 5 minutos, o dia todo | até N conversas por pessoa, entre as do dia corrente |
| Amostragem (sorteio diário) | uma vez por dia, a partir do horário configurado | um sorteio de N por pessoa entre as conversas do dia corrente |
Nos dois modos, nada é analisado duas vezes: cada reunião e cada ligação é reconhecida pelo identificador de origem, e o que já virou análise é pulado.
Reunião do Google Meet sem transcrição não vira análise. É uma regra da coleta, não um defeito: a análise é feita sobre a transcrição que o Google gera. Se uma reunião não aparece, a primeira coisa a conferir é se a transcrição estava ligada nela.
O estado de cada conta Google
Cada conta Google conectada tem um estado, visível no painel de saúde das contas:
| Estado | O que significa | Precisa fazer algo? |
|---|---|---|
| Coletando normalmente | a última coleta deu certo | não |
| Instabilidade do Google: tentando de novo | o Google ficou indisponível, respondeu com limite de requisições ou a conexão até ele falhou | não — a conta tenta sozinha |
| Precisa de ação | o Google recusou o acesso da conta | sim — o usuário precisa reconectar |
| Aguardando o primeiro ciclo | a conta acabou de ser conectada | não |
"Tentando de novo" se resolve sozinho
Quando o problema é do lado do Google — serviço fora, limite de requisições, falha de rede no caminho —, a conta não é bloqueada. Ela tenta de novo neste cronograma:
15 min (5 vezes) → 1 h → 3 h → 10 h → recomeçaNesse estado não há alarme, porque não há o que fazer: assim que o Google volta, a coleta volta, e as reuniões do período são recuperadas no mesmo ciclo.
"Precisa de ação" exige reconectar
Quando o Google recusa a conta — o usuário trocou a senha, revogou o acesso, ou a conta foi excluída —, tentar de novo não resolve. A conta para, e o admin da empresa recebe o alerta no painel.
A solução é o usuário reconectar a conta dele — e ele é avisado para isso (veja Como desbloquear). Reconectar já limpa o bloqueio sozinho.
A recuperação automática da janela perdida
Esta é a parte que mais importa numa parada: o que aconteceu enquanto a coleta estava parada volta, ou se perde?
| Modo | O que é recuperado quando a coleta volta |
|---|---|
| Total diário — Google Meet | Tudo. A coleta pede ao Google todas as reuniões desde a data de conexão da conta (ou dos últimos 30 dias, se não houver data) e analisa as que ainda não tinham virado análise |
| Total diário — PABX Onvox | Tudo, até um limite. A cada ciclo, a coleta varre as gravações desde a data de conexão (ou dos últimos 30 dias). O limite é de cerca de 30 mil gravações nessa janela: acima disso, as mais antigas ficam de fora |
| Quantidade (por pessoa/dia) | Só o dia corrente. Uma parada dentro do dia é recuperada; uma que atravessa a meia-noite perde as conversas dos dias anteriores |
| Amostragem (sorteio diário) | Só o dia corrente. O sorteio fica pendente do horário configurado até o fim do dia: se a plataforma estava fora no horário, ou se o sorteio falhou, ele roda assim que der, no mesmo dia. Dias anteriores não são refeitos |
Na prática, no Total diário uma parada de horas ou de poucos dias não perde nada: no primeiro ciclo depois de a conta voltar, as reuniões e ligações do período aparecem de uma vez. Nos modos por dia, o que se recupera é o dia corrente.
A recuperação consome crédito normalmente. As conversas represadas durante a parada são analisadas de uma vez quando a coleta volta, e cada uma consome crédito como qualquer outra. Numa parada longa, espere um volume maior que o normal no dia da volta.
Como desbloquear
O próprio usuário
Quando a conta Google de alguém fica em Precisa de ação, o dono da conta é avisado: aparece um aviso no topo das telas dele, e o card Conectar meu Google Meet, em Configurações, passa a mostrar Precisa reconectar com o botão Reconectar agora.
Reconectar é autorizar de novo no Google. Isso já limpa o bloqueio, e a próxima coleta recupera o período parado. Na maioria dos casos o usuário resolve sozinho, sem depender do admin nem do suporte.
Em "Tentando de novo" não há esse aviso: o sistema volta sozinho, e reconectar não acelera nada. O card mostra só uma linha informando a instabilidade.
Admin da empresa
- Vá em Configurações → Gerenciar integrações.
- Em Conexões individuais dos usuários, o painel de saúde mostra o estado de cada conta Google da sua empresa, o motivo e o log de cada uma.
- Numa conta parada, clique em Tentar de novo agora.
O que o botão faz: libera a conta e zera o estado dela. A próxima coleta, em até 5 minutos, tenta de novo e recupera o que ficou para trás. Não é preciso reconectar.
Se a conta voltar a Precisa de ação logo depois, o problema é de autorização: peça ao usuário para reconectar.
Super admin (suporte)
- Vá em Configurações → Depuração do sistema.
- Em Contas conectadas (integrações), as empresas com problema mostram o selo ⚠ N erros na própria linha.
- Clique no selo. A lista das contas bloqueadas daquela empresa abre ali mesmo, com o login, o motivo e desde quando.
- Clique em Desbloquear e sincronizar na conta.
É a mesma ação do admin da empresa, disponível para qualquer tenant. O mesmo bloqueio também aparece no topo da página, em Bloqueios e avisos ativos — as duas telas mostram a mesma lista.
Quando o bloqueio é da empresa inteira (processamento pausado, por exemplo por falta de crédito), o botão é Retomar: ele libera o processamento das análises daquela empresa.
Quando é preciso reconectar
Reconectar só é necessário quando a conta fica em Precisa de ação. Os casos mais comuns:
- o usuário trocou a senha da conta Google;
- o acesso da Onvox AI foi revogado nas permissões da conta Google;
- a conta foi desativada ou excluída pelo administrador do Google Workspace.
Nos outros casos — Google fora do ar, limite de requisições, falha de rede —, não reconecte: a conta se recupera sozinha, e reconectar não acelera nada.
Limites conhecidos
- Quantidade e Amostragem não recuperam dias anteriores. Os dois modos trabalham só com as conversas do dia corrente. A amostragem, em compensação, não perde o dia por uma falha momentânea: ela fica pendente do horário configurado até o fim do dia e roda assim que puder.
- PABX Onvox: cerca de 30 mil gravações por janela. Numa parada muito longa num PABX de alto volume, as gravações mais antigas do período podem ficar de fora.
- Janela máxima de 30 dias quando a integração não tem data de conexão registrada.
- Reunião sem transcrição não vira análise, em nenhum modo.
Veja também: Coleta do Google Meet · Coleta do PABX · Permissionamento.