RevGlanceDocumentação

Histórico de sincronização

Veja se uma fonte está em dia, o que cada sincronização mudou e se o webhook dela funciona.

Cada fonte que sincroniza tem o próprio histórico: como ela está agora e um registro de cada sincronização dos últimos 90 dias. Consulte-o quando um número parecer desatualizado ou um webhook não parecer funcionar.

Onde encontrar

  • Em Configurações › Fontes, abra o menu "…" de uma fonte e escolha Histórico de sincronização.
  • No status de sincronização, na parte inferior da página, escolha Histórico de sincronização abaixo da fonte.

Só as fontes que sincronizam têm um, então os dados de exemplo não têm.

Saúde da fonte

Este cartão mostra como a fonte está agora.

  • Status pode ser Atualizado, Sincronizando, Atrasado ou Falhou. Atrasado significa que a última sincronização tem mais de duas horas, ou que uma sincronização com falha aguarda a próxima tentativa. Falhou significa que a fonte tem um erro, mostrado abaixo destes campos. Uma sincronização com Leitura parcial também conta. O erro continua até uma sincronização posterior ler tudo.
  • Última sincronização é quando o RevGlance terminou de ler a fonte pela última vez. Uma sincronização interrompida por um erro não muda essa data.
  • Dados mais recentes é a data do último pagamento ou mudança de assinatura que o RevGlance tem desta fonte.
  • Webhook informa se as chamadas do provedor estão chegando. Veja Status do webhook.

Quando o teste termina, o cartão avisa, e as novas sincronizações aguardam até você comprar o RevGlance.

Por que Dados mais recentes pode ser mais antigo que Última sincronização

Última sincronização informa quando o RevGlance leu a fonte. Dados mais recentes informa quão recentes são os dados encontrados. Uma sincronização pode dar certo e não encontrar nada mais novo:

  • App Store: os relatórios da Apple chegam com cerca de um dia de atraso.
  • Google Play: o Google publica os relatórios em 3 a 7 dias.
  • Qualquer provedor: nada aconteceu. Um período tranquilo, sem pagamentos nem mudanças de assinatura, deixa a data como está.

O que inicia uma sincronização

Cada linha do Registro de sincronização diz o que a iniciou:

RótuloO que aconteceu
WebhookO provedor chamou o RevGlance para avisar que algo mudou.
AgendadaA sincronização normal: a cada hora enquanto alguém usa o negócio, uma vez por dia nos outros casos.
Iniciada manualmenteAlguém clicou em Sincronizar na fonte ou em Sincronizar agora, ou desativou o modo privado.
Primeira sincronizaçãoA fonte acabou de ser conectada.
De volta ao appAlguém voltou depois de 30 dias sem entrar, e a última sincronização da fonte tinha mais de uma hora.
Releitura completaO RevGlance leu de novo todo o histórico da fonte, o que fazemos quando uma regra de contagem muda. Você não pode iniciar uma por conta própria.

Só uma sincronização de cada fonte fica na fila por vez. Uma chamada de webhook que chega enquanto ela aguarda se junta a ela, então você pode ver menos linhas de Webhook do que chamadas.

Como ler o registro

A sincronização mais recente vem primeiro. Cada linha mostra quando ela começou, o que a iniciou e, para uma sincronização única, quanto tempo levou.

Contagens

Cada tipo de registro que uma sincronização mudou tem as próprias contagens: Pagamentos, Mudanças de assinatura, Clientes, Testes e Cancelamentos. Uma contagem zero não aparece.

  • 3 novos: registros que esta sincronização adicionou.
  • 2 atualizados: registros que o RevGlance já tinha e que esta sincronização mudou.
  • 4 removidos: registros que não existem mais depois desta sincronização.

Sem mudanças significa que a sincronização não encontrou nada a fazer. Sincronizações sem mudanças em sequência, iniciadas da mesma forma, se agrupam em uma linha, que informa quantas ela abrange e até quando elas voltam. Assim, uma sincronização por hora não esconde as que importam.

Quando uma sincronização tem problemas

  • Em andamento: a sincronização ainda está rodando. A página se atualiza sozinha.
  • Leitura parcial: ela terminou, mas parte do provedor não pôde ser lida. A linha mostra o erro. O que foi lido fica salvo e contado, e a próxima sincronização lê o mesmo trecho de novo.
  • Falhou: um erro a interrompeu. A linha mostra o erro, e o que foi lido antes de parar fica salvo e contado. Parou antes de terminar. significa que a sincronização foi cortada sem nenhum erro para mostrar.

O RevGlance tenta de novo por conta própria uma sincronização com falha, e cada tentativa tem a própria linha. Uma linha Falhou com uma linha sem erro acima dela significa que o problema passou, então não há nada a fazer. Se Status ainda indicar Falhou, o erro diz o que deu errado.

Números corrigidos

Aqui aparecem os números registrados que a sincronização corrigiu, com o valor antigo e o novo. Uma correção não é algo que um cliente fez.

  • Depois de uma Releitura completa: qualquer total que tenha mudado, como MRR, reembolsos ou taxas.
  • O MRR de uma assinatura: o valor registrado de uma assinatura foi corrigido.
  • Uma data de cancelamento: a data de um cancelamento no provedor difere da registrada.

Uma linha lista no máximo cinco e depois e mais 3.

Status do webhook

Proprietários e administradores veem o estado do webhook em Saúde da fonte. Ele pode indicar quatro coisas:

  • Última chamada recebida, com o horário: as chamadas estão chegando. Não há nada a fazer.
  • Configurado, mas nenhuma chamada chegou ainda. A fonte está pronta, mas o provedor ainda não chamou. Verifique se o webhook foi adicionado no provedor. As chamadas só vêm quando algo muda, então uma fonte tranquila pode ficar assim por um tempo.
  • Não configurado, então os novos dados aguardam a próxima sincronização agendada. Nenhum segredo está salvo. Os novos dados chegam com a sincronização de hora em hora ou diária até você adicionar o webhook.
  • As chamadas estão sendo recusadas, com o horário da última: o provedor alcança o RevGlance, mas as chamadas não passam na verificação e, por isso, não iniciam sincronização.

Em todos os estados, menos o primeiro, o cartão leva ao guia passo a passo do seu provedor.

Quando as chamadas são recusadas

O aviso aparece depois de 3 chamadas rejeitadas seguidas, então uma chamada isolada não o aciona. Webhook rejeitado também aparece na linha da fonte em Configurações › Fontes. O que verificar depende de como o provedor verifica as chamadas:

  • Stripe, Polar, Lemon Squeezy, Paddle, Recurly: copie de novo o segredo de assinatura do provedor e cole em Segredo de assinatura, no painel Webhook da fonte.
  • Gumroad, App Store, Google Play, Chargebee: confira se o ?token= da URL no provedor corresponde ao segredo salvo em Segredo de assinatura, ou salve um novo e atualize a URL.
  • Braintree, Shopify: não há segredo para colar. Verifique se o webhook foi adicionado na mesma conta do Braintree ou no mesmo app do Shopify com que a fonte se conecta.

As chamadas para uma fonte sem segredo salvo também são rejeitadas. Salvar o segredo resolve.

O aviso some na próxima chamada válida ou quando você salva um novo segredo. Se o segredo continuar errado, ele volta depois de mais 3 chamadas rejeitadas. Ele também some 7 dias depois da última chamada rejeitada.

Por quanto tempo fica guardado

Cada sincronização fica no registro por 90 dias e depois é excluída. Remover uma fonte também remove o histórico de sincronização dela.

Quem vê o quê

Todos no negócio podem abrir o histórico de sincronização de uma fonte e ler Saúde da fonte e o Registro de sincronização. Os visualizadores não veem o estado do webhook: nem o campo Webhook, nem o selo, nem o item de menu. Iniciar uma sincronização e salvar um segredo são ações de proprietários e administradores. Veja Equipe e funções.