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

# Adicionando regras com hooks

> Use hooks para verificar suas próprias regras antes que seu app da Base44 salve dados, permita um cadastro, execute uma integração ou passe uma mensagem a um agente no app.

Hooks são um tipo de workflow, e você os encontra com seus outros workflows na página **Fluxos de trabalho** do seu app. Eles permitem decidir o que acontece antes de o seu app executar certas ações, como salvar um registro ou permitir que alguém se cadastre. Um hook verifica suas regras e depois permite ou bloqueia a ação. Use hooks para manter seus dados corretos, controlar quem entra no seu app e dar as informações certas aos seus agentes no app. Tudo isso sem escrever código.

> [!WARNING]
>
> **O que você precisa para usar hooks:**
>
> * **Lançamento:** Os hooks estão sendo lançados gradualmente, então talvez você ainda não os veja.
> * **Plano:** Você precisa de um [plano Builder](https://base44.com/pricing) ou superior para usar hooks.

![A página Workflows com um hook Before data is saved ativo, Require Delivery Address, acima de um workflow comum](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-in-list.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=0e76770e28c780882b3a38e650d812c3)

Um hook na página Fluxos de trabalho

> [card] Para que posso usar hooks?
>
> Alguns exemplos de regras que você pode criar com hooks:
>
> * **Proteger alterações de dados:** Só deixe gerentes alterarem um valor aprovado, ou não deixe ninguém concluir uma tarefa sem responsável.
> * **Controlar quem entra:** Só deixe pessoas com o e-mail da sua empresa se cadastrarem, e dê a elas a função certa quando entrarem.
> * **Controlar o uso de integrações:** Só deixe membros pagantes usarem integrações nativas, como ações de IA.
> * **Dar contexto aos agentes:** Verifique a primeira mensagem de uma conversa com um agente no app e adicione detalhes que o agente usa nas respostas.

***

## Como os hooks funcionam

Um hook é um tipo de workflow que roda logo antes de uma ação no seu app. Seu app espera a resposta dele e depois deixa a ação seguir ou a interrompe.

* **A resposta:** Todo hook retorna **Permitido** ou **Bloqueado**. Alguns também retornam detalhes extras, como a função de uma pessoa nova ou contexto para um agente no app.
* **Quando bloqueia:** A pessoa vê a mensagem que você definiu na sua regra, ou uma mensagem geral se você não definiu uma.
* **Informações externas:** A maioria dos hooks pode chamar uma função de backend, por exemplo para consultar um diretório interno. O hook **Antes de salvar dados** só pode verificar condições e cálculos, para que salvar continue rápido.
* **Alterações vindas do código:** O hook **Antes de salvar dados** também roda quando uma função de backend altera dados, e não só nas páginas do seu app.

> [!WARNING]
>
> Se um hook falhar ou demorar demais, seu app bloqueia a ação. Antes de confiar em um novo hook, [confira a lógica e as primeiras execuções dele](#checking-a-hook). Assim, um erro em uma regra não impede as pessoas de usar seu app.

***

## Escolhendo um hook

Cada hook roda antes de uma ação diferente no seu app. Quando você descreve uma regra no chat de IA, ele escolhe o hook certo para você. Mesmo assim, conhecê-los ajuda a descrever o que você quer.

| Hook | Roda | Se falhar ou demorar demais |
| - | - | - |
| **Antes de salvar dados** | Toda vez que um registro é criado ou atualizado | O registro não é salvo |
| **Antes do cadastro** | Toda vez que alguém novo se cadastra | O cadastro é bloqueado |
| **Antes do primeiro acesso** | Na primeira vez que uma pessoa com login abre seu app | A pessoa não consegue abrir seu app |
| **Antes de usar uma integração** | Toda vez que alguém usa uma integração nativa, incluindo ações de IA | A solicitação é bloqueada |
| **Antes de iniciar uma conversa** | Na primeira mensagem de cada conversa com um agente no app | A conversa não começa |
| **Antes de cada mensagem do usuário** | Em cada mensagem enviada a um agente no app | A mensagem não chega ao agente |

Os hooks de cadastro e de primeiro acesso também podem definir a função da pessoa ou outros detalhes. O hook de conversa adiciona informações que o agente usa na conversa inteira. O hook de mensagem adiciona informações só para aquela resposta.

> [!NOTE]
>
> Alguns hooks só aparecem quando seu app precisa deles. Você só vê os hooks de cadastro e de primeiro acesso se seu app exige login. Os hooks de conversa e de mensagem só aparecem se seu app tem um [agente no app](https://docs.base44.com/pt-BR/Building-your-app/AI-agents-for-apps.md).

***

## Criando um hook

Você cria um hook do mesmo jeito que qualquer workflow: descrevendo o que você quer no chat de IA. A IA cria o hook, faz as perguntas de que precisa e o adiciona à sua lista de **Fluxos de trabalho**.

### Descrevendo sua regra

Descreva sua regra em palavras simples, e a IA escolhe o hook certo para você. Por exemplo:

```text theme={null}
Antes de uma tarefa ser salva como concluída, verifique se ela tem um responsável. Se não tiver, bloqueie o salvamento e mostre "Adicione um responsável antes de concluir esta tarefa."
```

```text theme={null}
Só deixe pessoas com um e-mail @northwind.com se cadastrarem. Dê a elas a função Member.
```

**Para criar um hook pelo chat de IA:**

1. Vá até o editor do seu app.
2. Descreva a regra no chat de IA e envie.
3. Responda às perguntas que a IA fizer.

### Escolhendo a ação primeiro

Comece pela página **Fluxos de trabalho** quando você já sabe qual ação quer verificar, como salvar um registro. Quando você escolhe a ação, o chat de IA abre com um prompt iniciado para você completar.

**Para criar um hook pela página Fluxos de trabalho:**

1. Vá até o editor do seu app.
2. Clique em **Painel**.
3. Clique em **Fluxos de trabalho**.
4. Clique em **Criar fluxo de trabalho**.
5. Clique em **Adicionar ponto de partida**.
6. Em **Hooks**, escolha a ação a verificar, como **Antes de salvar dados**.
7. Adicione sua regra ao prompt no chat de IA e envie.
8. Responda às perguntas que a IA fizer.

![O menu Add starting point rolado até a seção Hooks, com Before data is saved destacado](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hooks-menu.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=b610ec9221998e03fa99200f7f8f348c)

Escolhendo um hook como ponto de partida

***

## Conferindo um hook

Antes de confiar em um hook, confira se ele faz o que você quis. Você pode ler a lógica dele e testá-lo com dados reais. Para revisar as execuções, veja [como monitorar execuções](https://docs.base44.com/pt-BR/Building-your-app/managing-workflows.md#monitoring-runs). Para desativá-lo ou arquivá-lo, veja [como gerenciar workflows](https://docs.base44.com/pt-BR/Building-your-app/managing-workflows.md#changing-a-workflow).

### Lendo a lógica de um hook

Abra um hook na sua lista de workflows para vê-lo como um diagrama. O diagrama vai da ação que ele verifica, passa por cada condição e chega ao resultado. Clique em uma etapa para ver os detalhes dela. Uma etapa de condição mostra o que ela verifica. Uma etapa de resultado mostra a decisão, **Permitido** ou **Bloqueado**, e a mensagem que as pessoas veem.

![Um diagrama de hook com a etapa Block order selecionada, mostrando a mensagem dela e a decisão Blocked no painel de detalhes](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-diagram.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=a3dbe0bc71f2cd8b13909ebd048cfc59)

Lendo a lógica de um hook

### Testando um hook

Teste um hook para ver como ele responde aos dados de uma das execuções anteriores, usando as regras atuais. O hook precisa rodar pelo menos uma vez antes de você poder testá-lo. Quando o teste começa, o diagrama do hook abre na execução de teste. Assim, você vê se ele permitiu ou bloqueou a ação. Na aba **Atividade**, as execuções de teste aparecem com o rótulo **Teste**.

> [!WARNING]
>
> O teste não executa a ação que o hook protege, como salvar o registro. As funções de backend que o hook chama rodam de verdade, então podem alterar dados reais ou contatar serviços externos.

**Para testar um hook:**

1. Vá até o editor do seu app.
2. Clique em **Painel**.
3. Clique em **Fluxos de trabalho**.
4. Clique no hook para abri-lo.
5. Clique em **Executar agora** no painel de detalhes.
6. Na caixa de diálogo, escolha uma execução anterior para usar como dados de teste.
7. Clique em **Executar teste**.

![A janela Test hook with previous data com uma execução anterior selecionada e o botão Run test destacado](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-test-dialog.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=75872758b2837c1a3513f76eec332907)

Testando um hook com dados anteriores

> [!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

- [Criando workflows para seu aplicativo](https://docs.base44.com/pt-BR/Building-your-app/Creating-workflows.md)
- [Gerenciando workflows](https://docs.base44.com/pt-BR/Building-your-app/managing-workflows.md)
- [Adicionando componentes ao seu app](https://docs.base44.com/pt-BR/Building-your-app/Components-library.md)
- [Como criar um Superagent](https://docs.base44.com/pt-BR/superagents/creating-a-superagent.md)
- [Adicionando e usando pacotes npm](https://docs.base44.com/pt-BR/Building-your-app/NPM-packages.md)


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