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

# Ajouter des règles avec les hooks

> Utilisez les hooks pour vérifier vos propres règles avant que votre application Base44 enregistre des données, accepte une inscription, exécute une intégration ou transmette un message à l'un de ses agents intégrés.

Les hooks sont un type de flux de travail. Vous les trouvez avec vos autres flux de travail sur la page **Flux de travail** de votre application. Ils vous permettent de décider de ce qui se passe avant certaines actions de votre application, comme l'enregistrement d'un enregistrement ou une inscription. Un hook vérifie vos règles, puis autorise ou bloque l'action. Utilisez les hooks pour garder des données correctes, contrôler qui accède à votre application et donner les bonnes informations à vos agents intégrés, sans écrire de code.

> [!WARNING]
>
> **Ce dont vous avez besoin pour utiliser les hooks :**
>
> * **Déploiement :** les hooks sont déployés progressivement. Il est donc possible que vous ne les voyiez pas encore.
> * **Forfait :** vous avez besoin d'un [forfait Builder](https://base44.com/pricing) ou supérieur pour utiliser les hooks.

![La page Flux de travail avec un hook actif Before data is saved, Require Delivery Address, au-dessus d'un flux de travail classique](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 sur la page Flux de travail

> [card] À quoi puis-je utiliser les hooks ?
>
> Voici quelques exemples de règles que vous pouvez créer avec les hooks :
>
> * **Protéger les modifications de données :** laissez uniquement les managers modifier un montant approuvé, ou empêchez de terminer une tâche sans responsable.
> * **Contrôler qui rejoint l'application :** laissez uniquement les personnes ayant l'e-mail de votre entreprise s'inscrire, et attribuez-leur le bon rôle à leur arrivée.
> * **Contrôler l'utilisation des intégrations :** laissez uniquement les membres payants utiliser les intégrations intégrées, comme les actions IA.
> * **Donner du contexte aux agents :** vérifiez le premier message d'une conversation avec un agent intégré à l'application, et ajoutez des détails que l'agent utilise dans ses réponses.

***

## Comment fonctionnent les hooks

Un hook est un type de flux de travail qui s'exécute juste avant une action dans votre application. Votre application attend sa réponse, puis laisse l'action se poursuivre ou l'arrête.

* **Sa réponse :** chaque hook renvoie **Autorisé** ou **Bloqué**. Certains renvoient aussi des détails supplémentaires, comme le rôle d'une nouvelle personne ou du contexte pour un agent intégré.
* **Quand il bloque :** la personne voit le message que vous avez défini dans votre règle. Si vous n'en avez pas défini, elle voit un message général.
* **Informations externes :** la plupart des hooks peuvent appeler une fonction backend, par exemple pour consulter un annuaire interne. Le hook **Avant de sauvegarder les données** peut seulement vérifier des conditions et des calculs, pour que l'enregistrement reste rapide.
* **Modifications depuis le code :** le hook **Avant de sauvegarder les données** s'exécute aussi quand une fonction backend modifie des données, et pas seulement depuis les pages de votre application.

> [!WARNING]
>
> Si un hook échoue ou prend trop de temps, votre application bloque l'action. Avant de vous fier à un nouveau hook, [vérifiez sa logique et ses premières exécutions](#checking-a-hook). Ainsi, une erreur dans une règle n'empêche personne d'utiliser votre application.

***

## Choisir un hook

Chaque hook s'exécute avant une action différente de votre application. Quand vous décrivez une règle au chat IA, il choisit le bon hook pour vous. Les connaître vous aide toutefois à décrire ce que vous voulez.

| Hook | S'exécute | S'il échoue ou prend trop de temps |
| - | - | - |
| **Avant de sauvegarder les données** | À chaque création ou mise à jour d'un enregistrement | L'enregistrement n'est pas sauvegardé |
| **Avant l’inscription** | À chaque inscription d'une nouvelle personne | L'inscription est bloquée |
| **Avant le premier accès** | La première fois qu'une personne connectée ouvre votre application | Elle ne peut pas ouvrir votre application |
| **Avant l’utilisation d’une intégration** | À chaque utilisation d'une intégration intégrée, y compris les actions IA | La requête est bloquée |
| **Avant de commencer une conversation** | Au premier message de chaque conversation avec un agent intégré | La conversation ne démarre pas |
| **Avant chaque message utilisateur** | À chaque message envoyé à un agent intégré | Le message n'atteint pas l'agent |

Les hooks d'inscription et de premier accès peuvent aussi définir le rôle de la personne ou d'autres détails. Le hook de conversation ajoute des informations que l'agent utilise pendant toute la conversation. Le hook de message ajoute des informations pour cette réponse uniquement.

> [!NOTE]
>
> Certains hooks n'apparaissent que si votre application en a besoin. Vous voyez les hooks d'inscription et de premier accès uniquement si votre application exige une connexion. Vous voyez les hooks de conversation et de message uniquement si votre application a un [agent intégré à l'application](https://docs.base44.com/fr/Building-your-app/AI-agents-for-apps.md).

***

## Créer un hook

Vous créez un hook comme n'importe quel flux de travail, en décrivant ce que vous voulez dans le chat IA. L'IA construit le hook, pose les questions nécessaires et l'ajoute à votre liste **Flux de travail**.

### Décrire votre règle

Décrivez votre règle avec des mots simples, et l'IA choisit le bon hook pour vous. Par exemple :

```text theme={null}
Avant qu'une tâche soit enregistrée comme terminée, vérifie qu'elle a un responsable. Si ce n'est pas le cas, bloque l'enregistrement et affiche « Ajoutez un responsable avant de terminer cette tâche. »
```

```text theme={null}
Laisse uniquement les personnes avec un e-mail @northwind.com s'inscrire. Attribue-leur le rôle Member.
```

**Pour créer un hook depuis le chat IA :**

1. Accédez à votre éditeur d'application.
2. Décrivez la règle dans le chat IA, puis envoyez-la.
3. Répondez aux questions de suivi de l'IA.

### Choisir d'abord l'action

Commencez sur la page **Flux de travail** quand vous savez quelle action vous voulez vérifier, comme l'enregistrement d'un enregistrement. Quand vous choisissez l'action, le chat IA s'ouvre avec un prompt déjà commencé, que vous complétez.

**Pour créer un hook depuis la page Flux de travail :**

1. Accédez à votre éditeur d'application.
2. Cliquez sur **Tableau de bord**.
3. Cliquez sur **Flux de travail**.
4. Cliquez sur **Créer un flux de travail**.
5. Cliquez sur **Ajouter un point de départ**.
6. Sous **Hooks**, choisissez l'action à vérifier, comme **Avant de sauvegarder les données**.
7. Ajoutez votre règle au prompt dans le chat IA, puis envoyez-le.
8. Répondez aux questions de suivi de l'IA.

![Le menu Add starting point défilé jusqu'à la section Hooks, avec Before data is saved encadré](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hooks-menu.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=b610ec9221998e03fa99200f7f8f348c)

Choisir un hook comme point de départ

***

## Vérifier un hook

Avant de vous fier à un hook, vérifiez qu'il fait ce que vous vouliez. Vous pouvez lire sa logique et le tester avec des données réelles. Pour consulter ses exécutions, consultez [surveiller les exécutions](https://docs.base44.com/fr/Building-your-app/managing-workflows.md#monitoring-runs). Pour le désactiver ou l'archiver, consultez [gérer les flux de travail](https://docs.base44.com/fr/Building-your-app/managing-workflows.md#changing-a-workflow).

### Lire la logique d'un hook

Ouvrez un hook depuis votre liste de flux de travail pour le voir sous forme de diagramme. Le diagramme va de l'action vérifiée jusqu'au résultat, en passant par chaque condition. Cliquez sur une étape pour voir ses détails. Une étape de condition montre ce qu'elle vérifie. Une étape de résultat montre sa décision, **Autorisé** ou **Bloqué**, et le message que les personnes voient.

![Un diagramme de hook avec l'étape Block order sélectionnée, montrant son message et la décision Blocked dans le panneau de détails](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-diagram.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=a3dbe0bc71f2cd8b13909ebd048cfc59)

Lire la logique d'un hook

### Tester un hook

Testez un hook pour voir comment il réagit aux données d'une de ses exécutions précédentes, avec ses règles actuelles. Le hook doit s'exécuter au moins une fois avant que vous puissiez le tester. Quand le test démarre, le diagramme du hook s'ouvre sur l'exécution de test. Vous voyez ainsi s'il a autorisé ou bloqué l'action. Dans l'onglet **Activité**, les exécutions de test portent l'étiquette **Test**.

> [!WARNING]
>
> Le test n'exécute pas l'action protégée par le hook, comme l'enregistrement des données. Les fonctions backend appelées par le hook s'exécutent bien. Elles peuvent donc modifier des données réelles ou contacter des services externes.

**Pour tester un hook :**

1. Accédez à votre éditeur d'application.
2. Cliquez sur **Tableau de bord**.
3. Cliquez sur **Flux de travail**.
4. Cliquez sur le hook pour l'ouvrir.
5. Cliquez sur **Exécuter maintenant** dans le panneau de détails.
6. Dans la boîte de dialogue, choisissez une exécution précédente comme données de test.
7. Cliquez sur **Lancer le test**.

![La fenêtre Test hook with previous data avec une exécution précédente sélectionnée et le bouton Run test encadré](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-test-dialog.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=75872758b2837c1a3513f76eec332907)

Tester un hook avec des données précédentes

> [!NOTE]
>
> Cette page a été traduite par IA. Pour les informations les plus précises et à jour, consultez la [version anglaise](https://docs.base44.com/index.md).


## Related topics

- [Créer des entités](https://docs.base44.com/fr/developers/skills/base44-cli/references/entities-create.md)
- [Gérer les applications et les Superagents dans votre espace de travail enterprise](https://docs.base44.com/fr/Enterprise/Enterprise-SSO-and-app-visibility.md)
- [Gérer les flux de travail](https://docs.base44.com/fr/Building-your-app/managing-workflows.md)
- [Gérer les compétences](https://docs.base44.com/fr/documentation/using-your-workspaces/adding-workspace-skills.md)
- [Gérer les autorisations de données](https://docs.base44.com/fr/Setting-up-your-app/Managing-security-settings.md)


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