Passer au contenu principal
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.
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 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

Un hook sur la page Flux de travail

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

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 :
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é

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. Pour le désactiver ou l’archiver, consultez gérer les flux de travail.

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

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

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

Cette page a été traduite par IA. Pour les informations les plus précises et à jour, consultez la version anglaise.