---
title: "Aguardar um evento"
description: "Continue um workflow após o recebimento de uma mensagem ou um evento de aplicação, e configure caminhos de timeout quando o evento esperado não chegar."
canonical: "https://bird.com/pt-br/documentacao/guides/automations/waits"
---

# Aguardar um evento

Uma espera pausa uma execução existente até que um evento esperado corresponda ou seu timeout expire. Escolha o tipo de espera de acordo com quem produz o evento.

> Automations is in Early access. Your workspace permissions determine which actions you can perform.

## Aguardar o recebimento de uma mensagem

1. Adicione **Wait for event** após o caminho de sucesso de uma etapa de envio.
2. Selecione a ação anterior cuja mensagem você deseja monitorar.
3. Escolha os tipos de evento suportados e defina um timeout.
4. Conecte **Matched** à etapa que trata o recebimento.
5. Conecte **If time runs out**, o caminho de timeout, à etapa que trata o recebimento ausente.

A espera monitora a mensagem criada por aquela ação nesta execução. Uma mensagem de outra execução não a satisfaz. Um recebimento que chega antes de a execução alcançar a espera ainda pode ser utilizado.

O envio deve ter sucesso no caminho que leva à espera. Um caminho de falha não pode aguardar uma mensagem que o envio nunca aceitou. Envios de e-mail e WhatsApp monitorados devem ter apenas um destinatário.

Para continuar esta execução quando o cliente responder a uma mensagem SMS ou WhatsApp, use [Aguardar resposta](/docs/guides/automations/wait-for-reply). Para iniciar um fluxo de trabalho separado para uma mensagem recebida, use um [gatilho de evento Bird](/docs/guides/automations/triggers).

## Aguardar um evento de aplicação

Use **Wait for application event** para um evento como confirmação de pagamento ou cancelamento de consulta associado a um item de negócio específico.

1. Configure a chave de negócio do workflow em [Run overlap](/docs/guides/automations/run-settings), como um ID de fatura.
2. Adicione **Wait for application event** e especifique o nome do evento e os campos de dados de entrada.
3. Defina o timeout e qualquer condição que o evento deva satisfazer.
4. Conecte os caminhos de correspondência e de timeout.
5. Siga [Enviar um evento de acompanhamento](/docs/guides/automations/application-events#continue-a-run-that-is-waiting-for-an-event) para enviar o nome do evento, os dados e `subject_key` para a URL de eventos da automação.

O nome do evento e a chave devem corresponder exatamente aos valores configurados. Um nome correspondente com a chave errada não pode retomar a execução pretendida. Uma condição pode comparar os dados do evento de entrada com os dados iniciais da execução.

Um evento processado após o início da execução, mas antes de ela alcançar a espera, pode ser retido. Um evento processado antes de existir uma execução correspondente não é salvo para uma execução futura. A aceitação na fila não prova que uma espera foi retomada; inspecione **Runs**.

## Planejar o caminho de timeout

A duração da espera começa quando a execução alcança a espera. O [limite de 30 dias](/docs/guides/automations/schedules-and-delays#run-time-limit) da execução pode encerrá-la antes. Um timeout significa que nenhum evento qualificado resolveu a espera até o prazo; não prova que o evento de negócio nunca aconteceu.

Escolha uma ação de timeout adequada a essa incerteza, como registrar o resultado de uma revisão ou pedir a uma equipe que investigue. Visualize ambos os caminhos antes de publicar.

Pausar a automação interrompe novas execuções, enquanto esperas existentes podem continuar. Cancele a execução separadamente quando o trabalho subsequente precisar parar. Se o mesmo evento de aplicação se qualifica para cancelamento e para uma espera naquela execução, o cancelamento tem precedência.

## Próximos passos

- [Controlar execuções sobrepostas e cancelamento](/docs/guides/automations/run-settings).
- [Visualizar e verificar um workflow](/docs/guides/automations/preview).
- [Inspecionar execuções](/docs/guides/automations/runs).
- [Explorar os guias de Automações](/docs/guides/automations).

## Related resources

- [Preview your first automation](/docs/get-started/automations) (docs)
