Histórico de execuções
O histórico é o registro completo de todas as vezes que um robô foi executado — manualmente ou por agendamento. Ele permite acompanhar o status de cada execução, verificar quanto tempo levou e diagnosticar falhas com logs e screenshots.
Acessando o histórico
Pelo Designer
- Abra o Designer do robô desejado.
- No menu lateral, clique em Histórico.
Pelo Roberty Studio
- Acesse a seção Robôs no menu lateral do Studio.
- Localize o robô desejado.
- Clique em Configurações (⚙️) e selecione Histórico completo de execuções.
O que o histórico exibe
A tela de histórico apresenta uma tabela com cada execução registrada. Para cada linha você vê:
| Coluna | Descrição |
|---|---|
| Modo | Se foi uma execução Manual (disparada manualmente ou via webhook/WhatsApp) ou Agendada |
| Data de execução | Horário de início e fim, com a duração total (ex.: 2h 15m 30s) |
| Dispositivo | Qual máquina executou o robô (exibido para execuções em outros dispositivos) |
| Status | ✅ Sucesso, ❌ Falha ou 🔄 Em execução |
| Tempo relativo | Quanto tempo faz desde a execução (ex.: "há 2 horas") |
Filtrando o histórico
Use os filtros no topo da tela para encontrar execuções específicas:
- Dispositivo — filtre por qual máquina executou o robô
- Período — selecione um intervalo de datas (limite de 31 dias por consulta)
Clique em Buscar para aplicar os filtros.
Visualizando os logs de saída
Para cada execução concluída, você pode ver os logs gerados durante a execução — mensagens do sistema, erros encontrados e qualquer informação registrada pelo robô.
- Localize a execução desejada na tabela.
- Clique em Logs de saída.
Os logs mostram em detalhes o que aconteceu passo a passo — útil para identificar onde o robô falhou e por quê.
Visualizando o screenshot de erro
Quando uma execução em outro dispositivo falha, o Roberty captura automaticamente um screenshot da tela no momento do erro. Esse recurso é especialmente útil para identificar o que estava na tela quando o problema ocorreu.
- Localize a execução com falha na tabela.
- Clique em Screenshot (disponível apenas para execuções remotas com falha).
Execuções em diferentes dispositivos
Se o histórico tiver execuções em mais de um dispositivo, a tela exibe duas abas:
- Neste dispositivo — execuções ocorridas localmente (na máquina onde você está)
- Em outros dispositivos — execuções ocorridas remotamente, com a coluna de dispositivo visível
Dicas para diagnóstico de falhas
Combine histórico com snapshots. Se uma execução que funcionava ontem falha hoje, compare a data do problema com os snapshots disponíveis. Pode ter havido uma mudança no fluxo ou no ambiente.
Logs são o seu melhor recurso. Antes de qualquer investigação, abra os logs da execução com falha. Na maioria dos casos, a mensagem de erro indica exatamente qual ação e qual campo causou o problema.
Use filtros por período. Se você suspeita que o problema começou após uma data específica, filtre o histórico por esse período para identificar a primeira execução com falha.
Próximos passos
- Snapshots — restaure versões anteriores do robô
- Sub-rotinas de exceção — configure um tratamento global para erros