> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciando workflows

> Ative ou desative os workflows e hooks do seu app da Base44, edite, renomeie, execute e arquive-os, revise cada execução e mantenha o uso de créditos de integração sob controle.

Depois de [criar um workflow](https://docs.base44.com/pt-BR/Building-your-app/Creating-workflows.md), você o gerencia na página **Fluxos de trabalho** do painel do seu app. Ative ou desative, mude o que ele faz, execute sob demanda, revise cada execução e acompanhe os créditos que ele usa.

Os [hooks](https://docs.base44.com/pt-BR/Building-your-app/creating-hooks.md), os workflows que verificam suas regras antes de uma ação no seu app, funcionam da mesma forma. Quando algo é diferente para um hook, a seção avisa.

***

## Alterando um workflow

Depois que você começa a usar workflows, pode controlar quando eles rodam, mudar o que fazem, renomeá-los, dispará-los sob demanda ou limpar workflows de que não precisa mais. Cada workflow mostra um status **Ativo** ou **Inativo**, e você pode desativar um para pausá-lo e reativá-lo sempre que precisar.

### Ativando ou desativando um workflow

Desative um workflow quando quiser impedi-lo de rodar e ative-o novamente quando precisar. Desativar impede que novas execuções comecem, mas o histórico de execuções permanece disponível.

Desativar um [hook](https://docs.base44.com/pt-BR/Building-your-app/creating-hooks.md) desativa a regra dele. Assim, a ação que ele protege segue sem nenhuma verificação até você reativá-lo. Quando você desativa um hook, seu app pede confirmação, então clique em **Desativar** na caixa de diálogo.

**Para ativar ou desativar um workflow:**

1. Clique em **Painel** no editor do seu aplicativo.
2. Clique em **Fluxos de trabalho**.
3. Clique no ícone **Mais ações**  no workflow.
4. Clique em **Desativar** ou **Ativar**.

Você também pode abrir um workflow e usar a alternância **Ativo** no painel de detalhes.

![Menu do workflow com a opção Deactivate destacada](https://mintcdn.com/base44/PZ7PRS_0Vw5N4HxF/images/deactivateworkflow.png?fit=max\&auto=format\&n=PZ7PRS_0Vw5N4HxF\&q=85\&s=942750c997392bee69281fafda0d77ab)

Desativando um workflow pelo menu More actions.

### Editando um workflow

Para mudar o que um workflow faz, edite-o a partir do diagrama ou simplesmente descreva a mudança no chat de IA. Cada opção de edição abre o chat de IA com um prompt pré-preenchido e a IA faz a mudança para você, então não há nada para editar manualmente.

> [accordion] Editando uma etapa
>
> Clique no ícone **Editar** de uma etapa para mudar o que ela faz ou substituí-la por uma etapa diferente.
>
> ![Um workflow com um gatilho agendado e uma ação de envio de lembretes diários, e o menu de edição aberto em Change what this step does e Replace this step](https://mintcdn.com/base44/I1QI0alPKQovwbjh/images/editing-a-step.png?fit=max\&auto=format\&n=I1QI0alPKQovwbjh\&q=85\&s=1ffb17c143ef9e8f24f56015cb89cf03)
>
> Editando uma etapa.

> [accordion] Editando o gatilho
>
> * Clique no ícone **Editar** do gatilho para mudar quais eventos disparam o workflow.
> * Clique no ícone **Substituir gatilho** para trocar por um gatilho diferente, como um gatilho agendado, de conector, de agente no aplicativo ou de entidade.
>
> ![O seletor de gatilhos aberto ao lado de um workflow, oferecendo as opções agendadas One time, Recurring e On an interval, depois conectores, agentes e entidades](https://mintcdn.com/base44/w9eKWfEl5T_oHhSR/images/edit-workflow-trigger.png?fit=max\&auto=format\&n=w9eKWfEl5T_oHhSR\&q=85\&s=a307584af41041059fd1771dbee4406d)
>
> Substituindo o gatilho de um workflow.

> [accordion] Adicionando uma etapa
>
> Clique no botão de adicionar abaixo de uma etapa e escolha **Ação** ou **Condição**.
>
> ![O controle de adição abaixo de uma ação do workflow, com uma dica Add a step after this e um menu oferecendo Action ou Condition](https://mintcdn.com/base44/I1QI0alPKQovwbjh/images/adding-a-step-workflow.png?fit=max\&auto=format\&n=I1QI0alPKQovwbjh\&q=85\&s=af4a3ab487ca56da3a2828ba72f87096)
>
> Adicionando uma etapa a um workflow.

> [!NOTE]
>
> Alterar as etapas de um workflow cria uma nova versão. Execuções já em andamento terminam na versão em que começaram, e novas execuções usam a versão mais recente.

### Renomeando um workflow

Dê a um workflow um nome mais claro a qualquer momento. Renomear não cria uma nova versão.

**Para renomear um workflow:**

1. Clique em **Painel** no editor do seu aplicativo.
2. Clique em **Fluxos de trabalho**.
3. Clique no ícone **Mais ações**  no workflow.
4. Clique em **Renomear** e insira o novo nome.

![A lista Workflows com 3 workflows ativos e um menu aberto no primeiro, com Rename acima de Deactivate e Archive](https://mintcdn.com/base44/1snwrMHc8GN-cqaS/images/renameworkflow.png?fit=max\&auto=format\&n=1snwrMHc8GN-cqaS\&q=85\&s=ab9e40010d4ef4eb6a680e829bf6a764)

Renomeando um workflow pelo menu More actions.

### Executando um workflow imediatamente

Execute um workflow imediatamente quando quiser iniciá-lo sob demanda. Isso ajuda você a testar mudanças, confirmar que sua configuração funciona ou lidar com algo urgente entre execuções agendadas.

Em um hook, **Executar agora** testa o hook com dados de uma execução anterior. [Saiba como funciona o teste de um hook](https://docs.base44.com/pt-BR/Building-your-app/creating-hooks.md#testing-a-hook).

> [!WARNING]
>
> **O que Executar agora faz:**
>
> * Executa ações reais usando sua configuração atual, como enviar e-mails reais ou atualizar registros reais.
> * É uma execução manual única que não afeta seu cronograma ou gatilho, e aparece no histórico de execuções rotulada como um teste.
> * Quando existem execuções anteriores, você também pode reproduzir o workflow usando os dados de uma execução anterior.

**Para executar um workflow:**

1. Clique em **Painel** no editor do seu aplicativo.
2. Clique em **Fluxos de trabalho**.
3. Clique no workflow para abri-lo.
4. Clique em **Executar agora** no painel de detalhes.
5. Na caixa de confirmação, clique em **Executar agora** novamente.

![Painel lateral do workflow com Run now destacado acima do histórico de execuções](https://mintcdn.com/base44/1snwrMHc8GN-cqaS/images/runnowworkflow.png?fit=max\&auto=format\&n=1snwrMHc8GN-cqaS\&q=85\&s=24b22abea53f715b43638bc84f42f3b7)

Executando um workflow sob demanda com Run now.

### Cancelando uma execução

Se um workflow está rodando e você precisa pará-lo, pode cancelar a execução enquanto ela ainda está em andamento. A execução cancelada aparece como **Cancelado** no histórico de execuções.

**Para cancelar uma execução:**

1. Clique em **Painel** no editor do seu aplicativo.
2. Clique em **Fluxos de trabalho**.
3. Clique no workflow para abri-lo.
4. Clique na execução em andamento e depois clique em **Cancelar execução**.

### Arquivando um workflow

Se você não precisa mais de um workflow, pode arquivá-lo para manter sua lista ativa organizada.

Arquivar um [hook](https://docs.base44.com/pt-BR/Building-your-app/creating-hooks.md) também desativa a regra dele, então seu app pede confirmação antes de arquivá-lo.

**Para arquivar um workflow:**

1. Clique em **Painel** no editor do seu aplicativo.
2. Clique em **Fluxos de trabalho**.
3. Clique no ícone **Mais ações**  no workflow.
4. Clique em **Arquivar**.

![A lista Workflows com um menu aberto no primeiro workflow e Archive destacado, abaixo de Rename e Deactivate](https://mintcdn.com/base44/NYgUQIX5TN3t0K3a/images/archiveworkflow.png?fit=max\&auto=format\&n=NYgUQIX5TN3t0K3a\&q=85\&s=01d21d2aae7bb866e3e5c70f70588a13)

Arquivando um workflow pelo menu More actions.

> [!TIP]
>
> Para ver ou restaurar workflows arquivados, clique no ícone **Mais ações**  ao lado de **Criar fluxo de trabalho**, depois clique em **Ver arquivo**.

***

## Monitorando execuções

Cada workflow registra cada execução para que você possa acompanhá-la em tempo real e revisá-la depois. Revise as execuções de um único workflow no painel de detalhes dele, ou veja execuções de todos os seus workflows na aba **Atividade**.

> [!TIP]
>
> Enquanto um workflow roda, cada etapa no diagrama mostra uma marca de verificação verde quando é concluída com sucesso, para que você possa confirmar rapidamente que funciona e ver exatamente onde ele para se uma etapa falha.

### Visualizando as execuções de um workflow

Quando você abre um workflow, o painel de detalhes mostra sua **Taxa de sucesso**, **Tempo médio** e um **Histórico de execuções** de cada execução. Quando algo dá errado, a execução mostra a etapa exata que falhou e o erro, para que você saiba onde procurar sem adivinhar.

O painel de detalhes de um [hook](https://docs.base44.com/pt-BR/Building-your-app/creating-hooks.md) mostra só o **Histórico de execuções**. Quando você abre uma das execuções, ela mostra se o hook permitiu ou bloqueou a ação. Uma execução de hook com falha conta como bloqueada.

**Para ver as execuções de um workflow:**

1. Clique em **Painel** no editor do seu aplicativo.
2. Clique em **Fluxos de trabalho**.
3. Clique no workflow que deseja inspecionar.
4. No painel de detalhes, revise **Histórico de execuções**, onde cada execução mostra seu horário e status, como **Concluído**.
5. Clique em uma execução para abrir seu **Registro de execução**, incluindo o horário de início, de término e o tempo de execução.

![Uma execução de workflow concluída mostrada em verde no canvas, ao lado de um painel de log com a descrição, horários de início e fim e um tempo de execução de 1,5 segundo](https://mintcdn.com/base44/2miaRY-R6HMQU8Ti/images/viewrunsworkflow.png?fit=max\&auto=format\&n=2miaRY-R6HMQU8Ti\&q=85\&s=cab18e8ee3074c3cccef1a83e80c84f7)

O painel de detalhes de um workflow com seu histórico de execuções.

### Usando a aba Activity

A aba **Atividade** em **Fluxos de trabalho** no painel do seu aplicativo reúne as execuções de todos os seus workflows em um só lugar. As execuções de [hooks](https://docs.base44.com/pt-BR/Building-your-app/creating-hooks.md) aparecem rotuladas como hooks.

> [!TIP]
>
> Execuções que você inicia com **Executar agora** são rotuladas como **TEST**, para que você possa distingui-las das execuções disparadas automaticamente.

**Para ver a atividade de todos os workflows:**

1. Clique em **Painel** no editor do seu aplicativo.
2. Clique em **Fluxos de trabalho**.
3. Clique na aba **Atividade**.
4. Revise a lista de execuções, onde cada uma mostra seu workflow, status, horário de início e tempo de execução. Filtre por status (**Running**, **Concluído**, **Falhou** ou **Cancelado**) ou por intervalo de tempo.
5. Clique em **Ver** em uma execução para abri-la no diagrama do workflow junto com seu log de execução.

![A aba Activity com busca e filtros de status acima de uma tabela de 3 execuções de workflow concluídas, cada uma com status, horário de início e tempo de execução](https://mintcdn.com/base44/2miaRY-R6HMQU8Ti/images/workflowactivity.png?fit=max\&auto=format\&n=2miaRY-R6HMQU8Ti\&q=85\&s=f6e8b12bfc1065e10436ade1e0dd7c7f)

A aba Activity, mostrando execuções de todos os seus workflows.

***

## Workflows e créditos de integração

Workflows são cobrados pelas etapas que rodam. Cada etapa que roda usa crédito de integração, cerca de [1 crédito a cada 10 etapas](https://docs.base44.com/pt-BR/Account-and-billing/Credits.md#workflows), e as cobranças se somam em todas as etapas de uma única execução. Uma etapa que chama uma função de backend também usa crédito pela execução dessa função, cerca de [1 crédito a cada 100 execuções](https://docs.base44.com/pt-BR/Account-and-billing/Credits.md#funções-de-backend). Integrações nativas que uma etapa usa, como enviar um e-mail ou chamar um modelo de IA, também podem usar créditos, como acontece em outras partes do seu aplicativo.

Um workflow com várias etapas, portanto, custa mais por execução do que um de etapa única, então fique de olho na frequência com que seus workflows rodam e no que cada etapa faz. Se você ficar sem créditos de integração enquanto uma execução está em andamento, essa execução é cancelada. [Saiba mais sobre créditos.](https://docs.base44.com/pt-BR/Account-and-billing/Credits.md)

> [card] Dicas para gerenciar o uso de créditos
>
> Workflows que rodam com frequência ou encadeiam várias ações podem esgotar seu saldo de créditos rapidamente. Aqui estão algumas maneiras de manter o uso sob controle:
>
> * **Adicione condições de gatilho específicas:** Estreite os critérios que iniciam um workflow para que ele não rode desnecessariamente.
> * **Use condições para pular etapas desnecessárias:** Ramifique o workflow para que etapas caras rodem apenas quando forem realmente necessárias.
> * **Consolide workflows redundantes:** Se vários workflows realizam tarefas sobrepostas, combine-os em menos workflows, mais inteligentes.
> * **Resolva workflows com falha rapidamente:** Workflows com erro ainda podem consumir créditos a cada nova tentativa. Verifique seu histórico de execuções regularmente e corrija ou desative workflows problemáticos assim que os identificar.
> * **Revise a frequência de workflows agendados:** Considere se workflows recorrentes, como relatórios ou lembretes diários, precisam rodar com a frequência configurada.
> * **Seja econômico com chamadas de IA:** Se uma etapa chama um modelo de IA, isso também usa créditos, então chame-o apenas quando realmente precisar do resultado.
> * **Teste primeiro com um conjunto de dados pequeno:** Execute um workflow manualmente e verifique o histórico de execuções para estimar o custo de créditos por execução antes de ativá-lo em escala.

***

## Perguntas frequentes

Clique em uma pergunta abaixo para saber mais.

> [accordion] Posso adicionar condições para controlar quando uma etapa roda?
>
> Sim. Peça ao chat de IA para adicionar condições a qualquer workflow ou etapa. Por exemplo:
>
> ```text theme={null}
> Depois da espera, só envie o lembrete quando a tarefa ainda estiver incompleta.
> ```
>
> O workflow então segue caminhos diferentes com base nas condições que você descreve, para que etapas diferentes rodem dependendo dos seus dados. Uma condição pode ter vários caminhos, além de um caminho geral para tudo o que não corresponder, e o diagrama mostra cada caminho separadamente.

> [accordion] O que acontece quando um workflow falha?
>
> Abra o workflow e verifique seu **Histórico de execuções** para encontrar a etapa que falhou. Peça à IA no seu painel para explicar o erro e sugerir uma correção, depois use **Executar agora** para confirmar que o workflow teve sucesso.
>
> Se um workflow continua falhando, a Base44 o desativa automaticamente e envia um e-mail para você, para que possa corrigi-lo antes de reativá-lo. Um workflow agendado é desativado após 5 falhas consecutivas, porque ele roda da mesma forma toda vez, então falhas repetidas geralmente significam que algo está errado. Workflows com qualquer outro gatilho são desativados após 50 falhas consecutivas, porque seus dados de entrada variam e uma falha ocasional é mais esperada. Corrigir o workflow e reativá-lo zera a contagem.

> [accordion] Por que o Run now me pede para escolher uma execução anterior?
>
> Depende de como o workflow começa. Um workflow agendado pode rodar sob demanda a qualquer momento, porque não precisa de nenhuma entrada. Um workflow que começa a partir de um gatilho de entidade, conector ou agente no aplicativo precisa dos dados do gatilho para rodar, como a tarefa específica que foi criada, então **Executar agora** reproduz os dados de uma execução anterior. Isso significa que o workflow tem que rodar pelo menos uma vez antes que você possa executá-lo sob demanda.
>
> Se você vir **No previous runs**, dispare o workflow de verdade uma vez, por exemplo criando uma tarefa para o workflow de follow-up de tarefa, e depois use **Executar agora** para reproduzir essa execução.

> [accordion] Posso gerenciar workflows pelo chat de IA?
>
> Sim. Peça à IA para ativar, desativar, arquivar ou restaurar um workflow, e ela faz a mudança para você sem abrir os menus do painel.
>
> ![Chat de IA confirmando que um workflow está pausado](https://mintcdn.com/base44/I1QI0alPKQovwbjh/images/ai-chat-manage-workflow.png?fit=max\&auto=format\&n=I1QI0alPKQovwbjh\&q=85\&s=6f28125c2cedba6774dc865a99762aec)
>
> Gerenciando um workflow pelo chat de IA.

> [accordion] Quantos workflows a página Workflows mostra?
>
> A página Workflows lista todos os seus workflows, paginando até 1.000.

> [accordion] Para onde foram as automações do meu app?
>
> Em novembro de 2026, a Base44 transformou as automações de todos os apps em workflows. Se seu app tinha automações, você as encontra na página **Fluxos de trabalho** do painel do seu app. Cada uma agora é um workflow com o mesmo gatilho e cronograma. Links antigos para a página de automações também abrem **Fluxos de trabalho**.
>
> As automações que você arquivou continuam arquivadas. Para vê-las, clique no ícone **Mais ações**  no topo da página e depois em **Ver arquivo**.
>
> Se um workflow não conseguiu ser ativado depois da mudança, um banner no topo da página **Fluxos de trabalho** avisa você, e o workflow mostra um ícone de aviso. Corrija o gatilho dele, por exemplo reconectando uma integração, e depois [ative o workflow](#turning-a-workflow-on-or-off). Você também pode pedir ao chat de IA para corrigi-lo.
>
> As execuções de antes da mudança não aparecem no histórico de execuções do workflow.

> [!NOTE]
>
> Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](https://docs.base44.com/index.md).


## Related topics

- [Configurando workflows](https://docs.base44.com/pt-BR/superagents/setting-up-workflows.md)
- [Gerenciando os apps do seu workspace](https://docs.base44.com/pt-BR/documentation/using-your-workspaces/managing-your-workspace-apps.md)
- [Gerenciando conexões MCP](https://docs.base44.com/pt-BR/documentation/account-and-billing/setting-up-a-custom-mcp.md)
- [Gerenciando skills](https://docs.base44.com/pt-BR/documentation/using-your-workspaces/adding-workspace-skills.md)
- [Configurando o PayPal](https://docs.base44.com/pt-BR/Setting-up-your-app/setting-up-paypal.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.