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

# Aggiungere regole con gli hook

> Usa gli hook per verificare le tue regole prima che la tua app Base44 salvi dati, permetta a qualcuno di registrarsi, esegua un'integrazione o passi un messaggio a uno dei suoi agenti in-app.

Gli hook sono un tipo di workflow e li trovi insieme agli altri workflow nella pagina **Workflows** della tua app. Ti permettono di decidere cosa succede prima che la tua app compia certe azioni, come salvare un record o permettere a qualcuno di registrarsi. Un hook verifica le tue regole, poi consente o blocca l'azione. Usa gli hook per mantenere corretti i tuoi dati, controllare chi entra nella tua app e dare ai tuoi agenti in-app le informazioni giuste, senza scrivere codice.

> [!WARNING]
>
> **Cosa ti serve per usare gli hook:**
>
> * **Distribuzione:** gli hook vengono distribuiti gradualmente, quindi potresti non vederli ancora.
> * **Piano:** ti serve un [piano Builder](https://base44.com/pricing) o superiore per usare gli hook.

![La pagina Workflows con un hook Before data is saved attivo, Require Delivery Address, sopra un workflow normale](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-in-list.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=0e76770e28c780882b3a38e650d812c3)

Un hook nella pagina Workflows

> [card] Per cosa posso usare gli hook?
>
> Alcuni esempi di regole che puoi creare con gli hook:
>
> * **Proteggere le modifiche ai dati:** permetti solo ai manager di cambiare un importo approvato, oppure impedisci a chiunque di completare un'attività senza responsabile.
> * **Controllare chi si unisce:** permetti di registrarsi solo a chi ha l'email della tua azienda, e assegna il ruolo giusto mentre si unisce.
> * **Controllare l'uso delle integrazioni:** permetti solo ai membri paganti di usare le integrazioni integrate, come le azioni AI.
> * **Dare contesto agli agenti:** controlla il primo messaggio di una conversazione con un agente in-app e aggiungi dettagli che l'agente usa nelle sue risposte.

***

## Come funzionano gli hook

Un hook è un tipo di workflow che si esegue subito prima di un'azione nella tua app. La tua app attende la sua risposta, poi lascia procedere l'azione o la ferma.

* **La sua risposta:** ogni hook restituisce **Allowed** o **Blocked**. Alcuni restituiscono anche altri dettagli, come il ruolo di una nuova persona o il contesto per un agente in-app.
* **Quando blocca:** la persona vede il messaggio che hai impostato nella tua regola, oppure un messaggio generico se non ne hai impostato uno.
* **Informazioni esterne:** la maggior parte degli hook può chiamare una funzione backend, per esempio per consultare una directory interna. L'hook **Before data is saved** può solo verificare condizioni e calcoli, così il salvataggio resta veloce.
* **Modifiche dal codice:** l'hook **Before data is saved** si esegue anche quando una funzione backend modifica i dati, non solo le pagine della tua app.

> [!WARNING]
>
> Se un hook non va a buon fine o impiega troppo tempo, la tua app blocca l'azione. Prima di affidarti a un nuovo hook, [controlla la sua logica e le prime esecuzioni](#checking-a-hook), così un errore in una regola non impedisce alle persone di usare la tua app.

***

## Scegliere un hook

Ogni hook si esegue prima di un'azione diversa nella tua app. Quando descrivi una regola alla chat AI, sceglie l'hook giusto per te. Conoscerli però ti aiuta a descrivere ciò che vuoi.

| Hook | Quando si esegue | Se non va a buon fine o impiega troppo tempo |
| - | - | - |
| **Before data is saved** | Ogni volta che un record viene creato o aggiornato | Il record non viene salvato |
| **Before signup** | Ogni volta che una nuova persona si registra | La registrazione viene bloccata |
| **Before first access** | La prima volta che una persona che ha effettuato l'accesso apre la tua app | Non può aprire la tua app |
| **Before integration use** | Ogni volta che qualcuno usa un'integrazione integrata, incluse le azioni AI | La richiesta viene bloccata |
| **Before a conversation starts** | Al primo messaggio di ogni conversazione con un agente in-app | La conversazione non inizia |
| **Before each user message** | A ogni messaggio inviato a un agente in-app | Il messaggio non arriva all'agente |

Gli hook di registrazione e primo accesso possono anche impostare il ruolo della persona o altri dettagli. L'hook della conversazione aggiunge informazioni che l'agente usa per tutta la conversazione. L'hook del messaggio aggiunge informazioni solo per quella risposta.

> [!NOTE]
>
> Alcuni hook appaiono solo quando la tua app ne ha bisogno. Vedi gli hook di registrazione e primo accesso solo se la tua app richiede l'accesso. Vedi gli hook della conversazione e del messaggio solo se la tua app ha un [agente in-app](https://docs.base44.com/it/Building-your-app/AI-agents-for-apps.md).

***

## Creare un hook

Crei un hook come qualsiasi workflow, descrivendo ciò che vuoi nella chat AI. L'AI crea l'hook, fa le domande di cui ha bisogno e lo aggiunge al tuo elenco **Workflows**.

### Descrivere la tua regola

Descrivi la tua regola con parole semplici, e l'AI sceglie l'hook giusto per te. Per esempio:

```text theme={null}
Prima che un'attività venga salvata come completata, controlla che abbia un responsabile. Se non ce l'ha, blocca il salvataggio e mostra "Aggiungi un responsabile prima di completare questa attività."
```

```text theme={null}
Permetti di registrarsi solo alle persone con un'email @northwind.com. Assegna loro il ruolo Member.
```

**Per creare un hook dalla chat AI:**

1. Vai all'editor della tua app.
2. Descrivi la regola nella chat AI, poi inviala.
3. Rispondi alle eventuali domande dell'AI.

### Scegliere prima l'azione

Parti dalla pagina **Workflows** quando sai quale azione vuoi verificare, come il salvataggio di un record. Quando scegli l'azione, la chat AI si apre con un prompt già avviato da completare.

**Per creare un hook dalla pagina Workflows:**

1. Vai all'editor della tua app.
2. Clicca **Dashboard**.
3. Clicca **Workflows**.
4. Clicca **Create workflow**.
5. Clicca **Add starting point**.
6. In **Hooks**, scegli l'azione da verificare, come **Before data is saved**.
7. Aggiungi la tua regola al prompt nella chat AI, poi invialo.
8. Rispondi alle eventuali domande dell'AI.

![Il menu Add starting point scorso fino alla sezione Hooks, con Before data is saved evidenziato](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hooks-menu.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=b610ec9221998e03fa99200f7f8f348c)

Scegliere un hook come punto di partenza

***

## Controllare un hook

Prima di affidarti a un hook, controlla che faccia ciò che intendevi. Puoi leggere la sua logica e testarlo con dati reali. Per rivedere le sue esecuzioni, vedi [monitorare le esecuzioni](https://docs.base44.com/it/Building-your-app/managing-workflows.md#monitoring-runs). Per disattivarlo o archiviarlo, vedi [gestire i workflow](https://docs.base44.com/it/Building-your-app/managing-workflows.md#changing-a-workflow).

### Leggere la logica di un hook

Apri un hook dal tuo elenco di workflow per vederlo come diagramma, dall'azione che verifica attraverso ogni condizione fino al risultato. Clicca un passaggio per vederne i dettagli. Un passaggio di condizione mostra cosa verifica. Un passaggio di risultato mostra la sua decisione, **Allowed** o **Blocked**, e il messaggio che vedono le persone.

![Un diagramma di hook con il passaggio Block order selezionato, che mostra il suo messaggio e la decisione Blocked nel pannello dei dettagli](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-diagram.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=a3dbe0bc71f2cd8b13909ebd048cfc59)

Leggere la logica di un hook

### Testare un hook

Testa un hook per vedere come risponde ai dati di una delle sue esecuzioni precedenti, usando le regole attuali. L'hook deve essere eseguito almeno una volta prima che tu possa testarlo. Quando il test inizia, il diagramma dell'hook si apre sull'esecuzione di test, così puoi vedere se ha consentito o bloccato l'azione. Nella scheda **Activity**, le esecuzioni di test sono contrassegnate come **Test**.

> [!WARNING]
>
> Il test non esegue l'azione che l'hook protegge, come il salvataggio del record. Le funzioni backend chiamate dall'hook vengono invece eseguite, quindi possono modificare dati reali o contattare servizi esterni.

**Per testare un hook:**

1. Vai all'editor della tua app.
2. Clicca **Dashboard**.
3. Clicca **Workflows**.
4. Clicca l'hook per aprirlo.
5. Clicca **Run now** nel pannello dei dettagli.
6. Nella finestra, scegli un'esecuzione precedente da usare come dati di test.
7. Clicca **Run test**.

![La finestra Test hook with previous data con un'esecuzione precedente selezionata e il pulsante Run test evidenziato](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-test-dialog.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=75872758b2837c1a3513f76eec332907)

Testare un hook con dati precedenti

> [!NOTE]
>
> Questa pagina è stata tradotta con l'AI. Per le informazioni più accurate e aggiornate, consulta la [versione inglese](https://docs.base44.com/index.md).


## Related topics

- [Usare gli artifact con il tuo Superagent](https://docs.base44.com/it/superagents/artifacts.md)
- [Gestire i workflow](https://docs.base44.com/it/Building-your-app/managing-workflows.md)
- [Connettere GitHub alla tua app](https://docs.base44.com/it/Integrations/github-connector.md)
- [Automazioni](https://docs.base44.com/it/developers/backend/resources/backend-functions/automations.md)
- [Configurare un agente IA per la tua app](https://docs.base44.com/it/Building-your-app/AI-agents-for-apps.md)


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