Sub-rotinas de exceção
Uma sub-rotina de exceção é uma sub-rotina especial que o robô executa automaticamente quando ocorre um erro durante a execução principal. Em vez de simplesmente parar com falha, o robô "cai em um tratamento de erro" e executa o conjunto de ações que você definiu — como enviar uma notificação, registrar o problema ou tentar uma ação de recuperação.
Como funciona
Quando o robô encontra um erro não tratado durante a execução:
- A execução do fluxo principal é interrompida.
- O robô chama automaticamente a sub-rotina de exceção configurada.
- Após a sub-rotina concluir, o robô encerra a execução com o status de erro.
É o mesmo conceito de um bloco try/catch na programação: o fluxo principal é o try, e a sub-rotina de exceção é o catch.
Casos de uso comuns
- Enviar uma mensagem de WhatsApp ou e-mail quando o robô falha
- Tirar um screenshot da tela no momento do erro para facilitar o diagnóstico
- Registrar o erro em uma planilha ou banco de dados
- Notificar a equipe responsável antes de encerrar
Pré-requisito
Antes de configurar, você precisa ter criado a sub-rotina que será usada como tratadora de erro. Se ainda não criou, consulte a documentação de sub-rotinas no Catálogo de Ações.
Configurando a sub-rotina de exceção
- Abra o Designer do robô desejado.
- Clique no ícone de engrenagem (⚙️) para abrir as configurações.
- Localize a opção Sub-rotina de exceção.
- Selecione na lista a sub-rotina que deve ser chamada em caso de erro.
- Salve a configuração.
A partir desse momento, qualquer erro não tratado no fluxo principal acionará essa sub-rotina.
Construindo uma boa sub-rotina de exceção
A sub-rotina de exceção é construída no Designer da mesma forma que qualquer outra sub-rotina. Algumas boas práticas:
Inclua uma identificação do robô. Como a sub-rotina pode ser reutilizada em vários robôs, adicione ações que identifiquem de qual robô veio o erro (ex.: parâmetro com o nome do robô).
Mantenha-a simples e rápida. A sub-rotina de exceção não deve ser complexa. Seu objetivo é notificar e registrar — não resolver o problema.
Evite ações que também podem falhar. Se a sub-rotina de exceção gerar um erro, a execução encerrará sem o tratamento esperado. Prefira ações estáveis e bem testadas.
Use parâmetros para informações dinâmicas. Credenciais de e-mail, números de WhatsApp e outros dados de contato para notificação devem vir de parâmetros do robô, não de valores fixos no fluxo.
Desativando a sub-rotina de exceção
Para remover o tratamento de exceção, acesse as configurações do robô, localize o campo Sub-rotina de exceção e remova a seleção.
Próximos passos
- Parâmetros do robô — use variáveis seguras na sub-rotina de exceção
- Histórico — revise os erros ocorridos nas execuções anteriores
- Snapshots — restaure versões anteriores do robô se necessário