O Registro de atividades guarda, em ordem, o que a equipe faz de importante na conta: quem convidou quem, quem mudou o papel de uma pessoa, quem criou ou revogou uma chave de API, quem conectou ou desconectou um número e assim por diante. Serve para responder "quem fez isso e quando?" sem depender da memória de ninguém.
A tela fica em Configurações › Registro de atividades. Só o Administrador vê o registro. O Operador que abrir a tela encontra um aviso explicando isso.
O que fica registrado
- Equipe: convite enviado, aceito ou cancelado; pessoa removida ou que saiu; papel alterado (com o papel de antes e o de depois).
- Conversas: qual pessoa (ou chave de API) abriu qual conversa e quando. Veja Quem abriu cada conversa.
- Chaves de API: criada (com as permissões marcadas, inclusive os endereços IP permitidos), revogada e com os endereços permitidos alterados.
- Canais: número de WhatsApp ou conta do Instagram conectado, desconectado ou renomeado.
- Webhooks: criado, alterado (inclusive desativado ou com a chave de assinatura trocada) e removido.
- Segurança: verificação em duas etapas ativada ou desativada (inclusive quando um Administrador zera a de alguém ou quando a pessoa usa um código de recuperação) e exigência da verificação para a equipe ligada ou desligada.
- Exportação de dados: cada pedido de exportação, pelo painel ou pela API.
- Conta e plano: exclusão da conta pedida ou cancelada (a confirmação deixa a conta em somente leitura até a data da exclusão); assinatura iniciada ou cancelada (inclusive o cancelamento com estorno da garantia de 7 dias); teste grátis iniciado; negócio ou conexão extra contratado ou cancelado.
Cada linha mostra o dia e a hora, quem fez (a pessoa, a chave de API ou o próprio BotoZap, como no link de conexão que o seu cliente usa), sobre o que foi e o endereço IP de onde veio. Ver detalhes mostra o antes e o depois da mudança.
O registro nunca guarda senhas, chaves, tokens nem o texto das conversas. Das chaves de API aparecem só o nome, o começo da chave e as permissões.
Filtrar
Use os campos de Filtros e clique em Filtrar:
- De e Até: o período, pelo horário de Brasília.
- Quem: uma pessoa da equipe ou uma chave de API.
- O que aconteceu: um tipo de ação, como Papel alterado.
- Sobre o quê: o tipo de item, como Chave de API ou Webhook.
Para voltar a ver tudo, clique em Limpar. A lista mostra 50 eventos por vez; use Mais antigas e Mais recentes para navegar.
Exportar para planilha
Clique em Exportar CSV. O arquivo respeita os filtros que você aplicou e abre direto no Excel ou no Google Planilhas. Cada exportação traz até 10 mil eventos; se a sua busca tiver mais, estreite o período.
Por quanto tempo fica guardado
O registro é guardado por 12 meses. Depois disso, cada evento é apagado automaticamente. Quando a conta é excluída, o registro é apagado junto. Ninguém consegue editar nem apagar um evento antes disso: o registro só cresce.
Quem abriu cada conversa
Sempre que alguém abre uma conversa no painel, ou lê uma conversa pela API (ou por um assistente de IA conectado), o registro anota quem foi e quando. Vale para todos os planos. Se a mesma pessoa abrir a mesma conversa várias vezes, o registro guarda uma vez a cada 30 minutos, para a lista não ficar cheia de repetição.
Para ver só as aberturas de uma conversa, abra a conversa, clique no menu ··· e escolha Quem abriu (só o Administrador vê essa opção). O registro abre filtrado nessa conversa. Para ver tudo o que uma pessoa abriu, use o filtro Quem junto com O que aconteceu › Conversa aberta. Cada linha tem o link Abrir a conversa.
O registro guarda só quem abriu e quando: o nome e o telefone do contato não ficam nele, nem o texto das mensagens.
Pela API
Quem integra o BotoZap consulta o mesmo registro por GET /v1/team_events, com os mesmos filtros. A chave de API precisa da permissão Ler equipe e vale enquanto quem a criou for Administrador. Veja a referência da API.
Problemas comuns
Não vejo o Registro de atividades. Só o Administrador abre essa tela. Peça a um Administrador para mudar o seu papel em Membros se você precisa dela.
Uma ação minha não aparece. O registro anota a ação depois que ela termina com sucesso. Se a ação deu erro na tela, ela não entra.
O evento mostra "Link de conexão" em vez de uma pessoa. Foi o seu cliente quem conectou o canal pelo link de setup que você enviou, sem entrar no painel. Veja Links de setup.