> ## 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.

# Criando automações para seu aplicativo

> Execute trabalho de backend automaticamente, em um cronograma ou quando os dados mudam.

Use automações quando quiser tirar trabalho das suas mãos, como enviar e-mails de resumo, gerar relatórios, sincronizar ou limpar dados ou executar tarefas de manutenção recorrentes.

Ao [criar um aplicativo](https://base44.com/ai-app-builder) na Base44, as automações ajudam você a executar funções de backend automaticamente, em um cronograma, quando os dados mudam ou quando uma integração conectada envia um evento por meio de um conector. Você cria e gerencia automações usando o chat de IA no painel do seu aplicativo.

<Warning>
  **Workflows está substituindo automações.** Está sendo lançado gradualmente, então alguns aplicativos agora mostram **Workflows** em vez de **Automations**. Se seu aplicativo mostra Workflows, veja [Criando workflows](/Building-your-app/Creating-workflows).
</Warning>

<Frame>
  <img src="https://mintcdn.com/base44/sWCbn4HS6uyy2P5X/images/automations.avif?fit=max&auto=format&n=sWCbn4HS6uyy2P5X&q=85&s=c4f7406cca80b7c0cd7be06b37e42cc6" alt="Automations" width="900" height="495" data-path="images/automations.avif" />
</Frame>

<Card title="Para que posso usar automações?" color="#FF5500" icon="clock">
  Você pode usar automações para qualquer trabalho de backend que queira que aconteça automaticamente. Exemplos comuns incluem:

  * Enviar e-mails ou mensagens, como e-mails de boas-vindas diários ou boletins semanais.
  * Gerar relatórios ou resumos, por exemplo um relatório diário de receita.
  * Verificar condições e alertar apenas quando algo muda, como estoque baixo.
  * Reagir a alterações nos seus dados, como enviar aos administradores uma mensagem quando um novo produto é adicionado.
  * Agendar publicações nas redes sociais.
  * Executar tarefas recorrentes de manutenção ou limpeza, como arquivar registros antigos ou atualizar caches.
  * Fazer backup dos dados do seu aplicativo (por exemplo, no Google Drive) todas as semanas.
  * Enviar notificações a ferramentas externas quando algo acontece, por exemplo publicar atualizações de reservas de salão em um canal Slack quando os eventos do calendário mudam.
</Card>

***

## Como as automações funcionam

Quando você cria uma automação, escolhe como ela começa. Ela pode rodar em um cronograma definido por você, em resposta a um evento de dados como um registro sendo criado, atualizado ou excluído, quando um usuário do aplicativo inicia uma conversa com um agente no aplicativo ou quando uma integração conectada envia um evento usando um conector. Cada automação executa uma função de backend no seu aplicativo e registra a execução para que você possa ver o que aconteceu.

Cada automação tem logs para que você possa sempre ver quando foi executada, se teve sucesso e quaisquer erros que ocorreram. Isso mantém tudo transparente e fácil de depurar.

<Warning>
  **Importante:**

  * Você deve ter um **plano Builder** ou superior para usar automações.
  * Cada vez que uma automação é executada, ela usa **1 crédito de integração**.
  * Cada execução de automação pode durar no máximo 3 minutos. Se demorar mais, a execução falha. Por exemplo, se sua automação envia 1.000 e-mails mas só consegue enviar 600 dentro de 3 minutos, apenas os primeiros 600 são enviados e o restante não é processado.
  * O intervalo mínimo entre execuções de automação é de 5 minutos.
</Warning>

***

## Tipos de automações

Existem 4 tipos de automações que você pode criar. Ao descrever o que deseja no chat de IA, é útil saber qual tipo se encaixa no seu caso de uso.

### Automações agendadas

Automações agendadas rodam em um horário ou intervalo definido por você. Use estas para tarefas recorrentes como resumos diários, relatórios semanais ou trabalhos de manutenção regulares.

Exemplos de prompts:

* `Envie-me um resumo diário de todos os novos pedidos para o meu e-mail todas as manhãs às 8:00.`
* `Arquive registros de viagens que foram concluídos há mais de 30 dias, todo domingo à meia-noite.`

### Automações de evento de dados

Automações de evento de dados rodam em resposta a mudanças nos dados do seu aplicativo, como um registro sendo criado, atualizado ou excluído. Use estas para reagir à atividade em tempo real.

Exemplos de prompts:

* `Envie uma notificação push sempre que eu adicionar um novo WishlistPlace e escreva qualquer função de backend necessária para mim.`
* `Envie um e-mail ao administrador sempre que uma nova reserva for criada.`

### Automações de agente no aplicativo

Automações de agente no aplicativo rodam quando um usuário do aplicativo inicia uma nova conversa com um agente no aplicativo. Use estas para ficar por dentro de quem está entrando em contato, por exemplo, para ser notificado quando um cliente inicia um chat, adicionar automaticamente aos seus contatos ou enviar a si mesmo um resumo no final do dia.

Exemplos de prompts:

* `Envie-me um e-mail sempre que alguém iniciar uma nova conversa com meu agente.`
* `Adicione a pessoa à minha lista de Contatos quando ela iniciar um chat com meu agente.`

### Automações de conector

Automações de conector rodam quando uma integração conectada envia um evento, como um novo e-mail chegando no Gmail ou um evento de calendário sendo atualizado no Google Calendar. Use estas para manter seu aplicativo sincronizado com ferramentas externas.

Exemplos de prompts:

* `Quando um novo e-mail chegar no Gmail com o assunto "Book appointment", analise-o e adicione uma nova reserva ao meu aplicativo.`
* `Quando um evento do Google Calendar for cancelado, atualize a reserva no meu aplicativo e publique uma mensagem no canal Slack #salon-general.`

<Note>
  Automações de conector estão atualmente disponíveis para Gmail, Google Calendar, Google Drive, Microsoft Outlook e Microsoft OneDrive.
</Note>

***

## Criando uma automação

Quando você clica em **New Automation**, a Base44 mostra sugestões com base no contexto do seu aplicativo. Você pode escolher uma delas ou clicar em **Create from scratch** para escolher seu tipo de automação e descrever o que deseja no chat de IA.

### Usando uma sugestão

Cada sugestão inclui uma breve descrição do que faz. Clicar em uma envia um prompt pré-preenchido para o chat de IA, onde você pode revisar e ajustá-lo antes que a IA o configure.

**Para criar uma automação a partir de uma sugestão:**

1. Clique em **Dashboard** no editor do seu aplicativo.
2. Clique em **Automations**.
3. Clique em **New Automation**.
4. Navegue pelas sugestões em **Suggested for you**.
5. Clique em uma sugestão para enviá-la ao chat de IA como um prompt pré-preenchido.
6. Revise o prompt, faça quaisquer alterações e envie-o.
7. A IA configura a automação e a adiciona à sua lista **Automations**.

<Frame caption="Choosing a suggested automation in Base44">
  <img src="https://mintcdn.com/base44/9GrSQ19BU_PixKoO/images/automationsuggestions.png?fit=max&auto=format&n=9GrSQ19BU_PixKoO&q=85&s=7c055a3e7d1f74b349e4a652a3ba488d" alt="Automationsuggestions" width="1078" height="665" data-path="images/automationsuggestions.png" />
</Frame>

***

### Criando do zero

Se nenhuma das sugestões se encaixa no que você precisa, crie sua automação do zero. Você escolhe o tipo de gatilho primeiro, depois descreve o que deseja no chat de IA.

**Para criar uma automação do zero:**

1. Clique em **Dashboard** no editor do seu aplicativo.
2. Clique em **Automations**.
3. Clique em **New Automation**.
4. Clique em **Create from scratch**.
5. Selecione o tipo de gatilho: **Scheduled**, **Data event**, **In-app agent** ou **Connector**.
6. No chat de IA, descreva a automação que deseja. Por exemplo: `Configure lembretes de e-mail recorrentes para o meu e-mail name@email.com para minhas tarefas na minha lista de tarefas todo domingo às 17:00.`
7. A IA cria a automação e a adiciona à sua lista **Automations**.

<Tip>
  Se você precisa de uma nova função de backend para sua automação, apenas mencione no seu prompt e a IA a escreverá para você.
</Tip>

***

## Gerenciando automações

Depois de começar a usar automações, você pode controlar quando elas rodam, alterar suas configurações, dispará-las sob demanda ou limpar automações que você não precisa mais. Você pode pausar automações sem excluí-las, e pode duplicar uma automação existente quando quiser uma configuração semelhante com pequenas alterações.

<Note>
  Quando você desativa uma automação, a Base44 para de agendar execuções futuras, mas os logs existentes permanecem disponíveis. Você pode reativar a automação a qualquer momento.
</Note>

### Ativando ou desativando uma automação

Pause uma automação a qualquer momento se quiser interrompê-la e ative-a novamente quando precisar.

**Para ativar ou desativar uma automação:**

1. Clique em **Dashboard** no editor do seu aplicativo.
2. Clique em **Automations**.
3. Clique no botão à esquerda do nome da automação para ativá-la ou desativá-la.

<Frame caption="Turning an automation on and off">
  <img src="https://mintcdn.com/base44/FqrO4aN4hBhcbFuM/turnautomationoff.png?fit=max&auto=format&n=FqrO4aN4hBhcbFuM&q=85&s=594fa3712b07d29f40f18c31bef07c3c" alt="Turning an automation on and off" width="1286" height="614" data-path="turnautomationoff.png" />
</Frame>

<Note>
  **Pausa automática para automações com falha:** Se uma automação agendada falha repetidamente, a Base44 a pausa automaticamente e notifica você para que possa investigar e corrigir o problema antes de reativá-la.
</Note>

***

### Editando uma automação

Faça alterações em uma automação a qualquer momento. As alterações afetam apenas execuções futuras.

**Para editar uma automação:**

1. Clique em **Dashboard** no editor do seu aplicativo.
2. Clique em **Automations**.
3. Clique no ícone **More Actions** <Icon icon="ellipsis" /> na automação.
4. Clique em **Edit automation**.
5. Atualize os detalhes da automação.
6. Clique em **Save**.

<Frame caption="Editing an automation in your app">
  <img src="https://mintcdn.com/base44/aSMFXtSXQCb3elTY/images/editautomation.png?fit=max&auto=format&n=aSMFXtSXQCb3elTY&q=85&s=7754aa17e7e32a1a5aa9bc623ab6c3a5" alt="Editing an automation in your app" width="2324" height="1162" data-path="images/editautomation.png" />
</Frame>

***

### Duplicando uma automação

Crie novas automações duplicando as existentes e editando a nova automação.

**Para duplicar uma automação:**

1. Clique em **Dashboard** no editor do seu aplicativo.
2. Clique em **Automations**.
3. Clique no ícone **More Actions** <Icon icon="ellipsis" /> na automação.
4. Clique em **Duplicate**.
5. Atualize os detalhes da nova automação se necessário e clique em **Save**.

<Frame caption="Duplicating an automation in your app">
  <img src="https://mintcdn.com/base44/aSMFXtSXQCb3elTY/images/duplicateaut.png?fit=max&auto=format&n=aSMFXtSXQCb3elTY&q=85&s=5e8cee320481fcfd70d592548a4d6c35" alt="Duplicating an automation in your app" width="2324" height="1162" data-path="images/duplicateaut.png" />
</Frame>

***

### Executando uma automação imediatamente

Execute uma automação imediatamente quando quiser disparar sua função de backend sob demanda. Isso ajuda você a testar alterações, confirmar que sua configuração funciona ou lidar com algo urgente entre execuções agendadas.

<Note>
  Run now dispara a função de backend uma vez, além de qualquer cronograma ou evento de dados que você configurou. A execução aparece nos logs da automação.
</Note>

**Para executar uma automação:**

1. Clique em **Dashboard** no editor do seu aplicativo.
2. Clique em **Automations**.
3. Clique no ícone **More Actions** <Icon icon="ellipsis" iconType="regular" /> na automação.
4. Selecione **Run now**.

<Frame caption="Running an automation immediately">
  <img src="https://mintcdn.com/base44/rGcCOplgSQIZW5QD/images/runnowaut.png?fit=max&auto=format&n=rGcCOplgSQIZW5QD&q=85&s=52d7d0d6e64e87599be8e1dfab0c0507" alt="Running an automation immediately" width="2324" height="1162" data-path="images/runnowaut.png" />
</Frame>

***

### Arquivando uma automação

Se você não precisa mais de uma automação, pode movê-la para o Arquivo para manter sua lista ativa limpa.

**Para arquivar uma automação:**

1. Clique em **Dashboard** no editor do seu aplicativo.
2. Clique em **Automations**.
3. Encontre a automação relevante na lista.
4. Clique no ícone **More Actions** <Icon icon="ellipsis" /> na automação.
5. Clique em **Archive**.

<Frame caption="Archiving an automation">
  <img src="https://mintcdn.com/base44/IIK5Nw53Dsz4qhFW/images/archiveaut.png?fit=max&auto=format&n=IIK5Nw53Dsz4qhFW&q=85&s=065d803d1fb9060756805401f504f83b" alt="Archiving an automation" width="2324" height="1162" data-path="images/archiveaut.png" />
</Frame>

***

## Monitorando execuções e usando logs

Cada automação mantém seu próprio log para que você possa ver quando foi executada, quanto tempo levou e se teve sucesso. Quando algo dá errado, os logs ajudam você a entender o que falhou e onde procurar no seu código de backend, sem adivinhar.

<Tip>
  Use os logs para confirmar que novas automações estão sendo executadas no horário certo depois que você as configurar pela primeira vez.
</Tip>

**Para visualizar logs de uma automação:**

1. Clique em **Dashboard** no editor do seu aplicativo.
2. Clique em **Automations**.
3. Clique na automação que deseja inspecionar.
4. Clique na aba **Logs**.
5. Revise a lista de execuções, incluindo o timestamp, duração e status de cada execução.

<Frame caption="Viewing the logs of an automation">
  <img src="https://mintcdn.com/base44/FqrO4aN4hBhcbFuM/ss.png?fit=max&auto=format&n=FqrO4aN4hBhcbFuM&q=85&s=2d44eb7084a126876576a7f50671ce83" alt="Viewing the logs of an automation" className="mx-auto" style={{ width:"83%" }} width="691" height="451" data-path="ss.png" />
</Frame>

***

## Automações e créditos de integração

Cada execução de automação usa pelo menos 1 crédito de integração, além de créditos adicionais para quaisquer integrações integradas chamadas dentro dela. Por exemplo, uma automação que chama invokeLLM e envia um e-mail custa 1 crédito da execução da automação mais créditos para cada ação que ela dispara. [Veja o detalhamento completo de créditos.](/Account-and-billing/Credits#integration-credit-examples)

Automações que rodam com frequência ou encadeiam várias ações podem drenar 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 fazem uma automação disparar para que não rode desnecessariamente.
* **Consolide automações redundantes.** Se várias automações executam tarefas sobrepostas, combine-as em fluxos de trabalho menores e mais inteligentes.
* **Resolva automações com falha prontamente.** Automações que dão erro ainda podem consumir créditos em cada nova tentativa. Verifique seus logs regularmente e corrija ou desative automações problemáticas assim que as detectar.
* **Revise a frequência das tarefas agendadas.** Considere se automações recorrentes, como relatórios ou lembretes diários, precisam rodar tão frequentemente quanto configurado.
* **Minimize chamadas invokeLLM.** Cada chamada invokeLLM dentro de uma automação é uma cobrança de crédito separada. Chame o LLM apenas quando o resultado não pode ser predeterminado.
* **Teste em um ambiente controlado primeiro.** Execute automações manualmente em um pequeno conjunto de dados e verifique os logs de execução para estimar o custo de crédito por execução antes de ativá-las em escala.
* **Use o modo Discuss ao projetar automações.** O modo Discuss custa aproximadamente 0.3 créditos de mensagem e permite planejar a lógica da automação antes de aplicar alterações, reduzindo tentativas e erros.

***

## Perguntas frequentes

Clique em uma pergunta abaixo para saber mais.

<AccordionGroup>
  <Accordion title="Posso adicionar condições para controlar quando uma automação dispara?">
    Sim. Peça ao chat de IA para adicionar condições de gatilho a qualquer automação. Por exemplo:

    ```text theme={null}
    Only run this automation when the order status is "pending".
    ```

    A automação então dispara apenas quando o evento de gatilho também corresponde às condições que você descreve. As condições são mostradas na seção **Advanced** do painel de automação uma vez definidas e só podem ser alteradas pedindo ao chat de IA — não podem ser editadas manualmente.

    <img src="https://mintcdn.com/base44/OG-PUGcI5ba5I9px/images/advanced-conditions.png?fit=max&auto=format&n=OG-PUGcI5ba5I9px&q=85&s=b2ff9cda7e38487667bd5f3847372c50" alt="Trigger conditions in the Advanced section of the automation panel" width="1074" height="749" data-path="images/advanced-conditions.png" />
  </Accordion>

  <Accordion title="Como investigo uma execução de automação com falha?">
    Quando uma automação falha, você vê um rótulo **Failed** na coluna **Last run** e uma opção **Fix with AI** na mesma linha.

    <img src="https://mintcdn.com/base44/kuqIWwAAwM4Jrcht/images/failed-2.png?fit=max&auto=format&n=kuqIWwAAwM4Jrcht&q=85&s=695e3a0d7a75b5c6b61bb476a6993c11" alt="Failed 2" width="1289" height="603" data-path="images/failed-2.png" />

    **Para corrigir uma execução com falha:**

    1. Clique em **Dashboard** no editor do seu aplicativo.
    2. Clique em **Automations**.
    3. Clique em **Fix with AI** na automação com falha.
    4. No chat de IA, revise a explicação do que deu errado e como afeta sua automação. Aceite a correção sugerida para que a IA possa atualizar seu código ou configuração de automação.
    5. Quando a IA terminar de aplicar a correção, use a ação **Run now** em **Automations** e verifique os logs para confirmar que a automação teve sucesso.

    <Tip>
      Para mais detalhes sobre o que aconteceu, abra a automação, vá para a aba **Logs** e revise a entrada de execução com falha. Você também pode pedir à IA no seu painel para explicar quaisquer mensagens de erro que apareçam.
    </Tip>
  </Accordion>

  <Accordion title="Quais eventos de conector posso usar em automações de conector?">
    Os eventos disponíveis dependem de qual conector você está usando. Aqui está uma lista completa:

    | Conector           | Evento       | Descrição                                                                             |
    | ------------------ | ------------ | ------------------------------------------------------------------------------------- |
    | Gmail              | mailbox      | Novos e-mails chegando na sua caixa de correio                                        |
    | Google Calendar    | events       | Qualquer alteração de evento de calendário, incluindo criado, atualizado e excluído   |
    | Google Drive       | changes      | Qualquer alteração no drive, incluindo arquivos adicionados, modificados ou excluídos |
    | Google Drive       | file         | Qualquer alteração em um arquivo específico (requer um ID de arquivo)                 |
    | Google Drive       | file.update  | Conteúdo ou propriedades do arquivo alterados (requer um ID de arquivo)               |
    | Google Drive       | file.trash   | Arquivo movido para a lixeira (requer um ID de arquivo)                               |
    | Google Drive       | file.untrash | Arquivo restaurado da lixeira (requer um ID de arquivo)                               |
    | Google Drive       | file.delete  | Arquivo excluído permanentemente (requer um ID de arquivo)                            |
    | Microsoft Outlook  | created      | Um novo e-mail, evento de calendário ou contato é criado                              |
    | Microsoft Outlook  | updated      | Um e-mail ou evento de calendário é atualizado                                        |
    | Microsoft Outlook  | deleted      | Um e-mail ou evento de calendário é excluído                                          |
    | Microsoft OneDrive | updated      | Qualquer alteração de arquivo ou pasta, incluindo criado, modificado e excluído       |

    Certifique-se de que o conector está conectado e configurado em **Integrations** no painel do seu aplicativo antes de criar uma automação de conector.
  </Accordion>
</AccordionGroup>

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>
