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

# Execuções e erros dos Flows

> Veja cada vez que um flow rodou, entenda os estados e corrija o que falhou.

## Para que serve

A aba **Execuções** mostra cada vez que um flow rodou, o caminho que fez e onde parou. É onde você descobre por que algo não saiu.

Aparece se a agência liberou o módulo Flows para a organização.

## Quem pode

Quem tem acesso a Flows vê as execuções. **Retomar** e **Reexecutar** são só do Dono e do Admin: a tela diz "Só Dono e Admin retomam ou reexecutam."

## Onde clicar

**Flows › Execuções**. Filtros: **Ao vivo**, **Todas**, **Falhas**, **Aguardando**, **Testes**; busca por contato, telefone ou ID; **Todos os flows**; período (**Hoje**, **7 dias**, **30 dias**, **Tudo**). Em **Meus flows**, o botão **Ver** do alerta de falhas leva às falhas.

## Passo a passo

**1. Comece pelas falhas**

Clique em **Falhas** e escolha uma execução na lista.

**2. Leia o detalhe**

Veja **Início**, **Duração**, **Contato** e o **Caminho percorrido**, bloco a bloco. **A execução falhou** traz o motivo; **Ver bloco** leva ao bloco com problema.

**3. Corrija e retome**

Use **Abrir no editor**, corrija o bloco e volte. Em **Antes de retomar**, escolha **Retomar do bloco com falha** (mantém o que já foi feito) ou **Reexecutar do início…** (abre confirmação com a prévia).

## O que acontece depois

Estados de uma execução: **Rodando**, **Aguardando** ("Retoma" no horário), **Concluída**, **Falhou**, **Cancelada**, **Parou: o contato respondeu**, **Tirado do fluxo**, **Tirado pelo flow X** e **Tirado por outro flow**. Cada passo mostra **Concluído**, **Erro**, **Pulado**, **Simulado** ou **Aguardando**.

Na reexecução, **Pular o que já foi feito (recomendado)** evita repetir efeitos. Passos com resultado incerto pedem uma escolha: **Tentar de novo** ou **Já foi feito**.

A saúde de um flow aparece como **ok**, **atenção** ou **falhando**, conforme a proporção de falhas no período.

## Erros comuns

* **Este bloco ("tipo") ainda não é executado pelo motor.** A execução parou aqui. Troque o bloco.
* **O motor não reconhece o tipo de ação.** Troque o bloco.
* **O módulo usado neste bloco está desligado nesta organização.** Peça à agência para ligar.
* **Não deu para conferir a lista de bloqueio.** O contato não tem telefone ou a leitura falhou.
* **Este bloco não conseguiu terminar.** Confira a configuração do bloco e tente de novo.
* **Não enviado: fora das 24 h, sem modelo.** No WhatsApp Oficial, escolha um modelo aprovado. Outras causas: **o cliente não escreveu nas últimas 24 h**, **um campo do modelo não tem valor nem padrão**, **a Meta recusou ou pausou o modelo**. O alerta mostra **Escolher modelo**.
* **Não foi possível retomar. Nada foi repetido.**
* **Não foi possível reexecutar.**
* **Webhook com erro 401.** Falta o cabeçalho `X-Webhook-Secret` correto.
* **Não deu para ler as execuções.** Tente de novo.

## Próximo passo

* [Editor de Flows](https://docs.stchat.app/subcontas/editor-de-flows.md)
* [Como criar um flow por receita](https://docs.stchat.app/subcontas/criar-flow-por-receita.md)
* [Flows: visão geral](https://docs.stchat.app/subcontas/flows.md)


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