Saltar al contenido principal
Los hooks son un tipo de workflow, y los encuentras con tus otros workflows en la página Flujos de trabajo de tu app. Te permiten decidir qué pasa antes de que tu app realice ciertas acciones, como guardar un registro o dejar que alguien se registre. Un hook comprueba tus reglas y luego permite o bloquea la acción. Usa hooks para mantener tus datos correctos, controlar quién entra en tu app y dar a tus agentes en la app la información adecuada, sin escribir código tú mismo.
Lo que necesitas para usar hooks:
  • Lanzamiento: Los hooks se están lanzando de forma gradual, así que puede que aún no los veas.
  • Plan: Necesitas un plan Builder o superior para usar hooks.
La página Workflows con un hook Before data is saved activo, Require Delivery Address, encima de un workflow normal

Un hook en la página Workflows

¿Para qué puedo usar los hooks?

Algunos ejemplos de reglas que puedes crear con hooks:
  • Proteger cambios en los datos: Deja que solo los gerentes cambien un importe aprobado, o no dejes que nadie complete una tarea sin responsable.
  • Controlar quién se une: Deja que solo las personas con el correo de tu empresa se registren, y dales el rol adecuado al unirse.
  • Controlar el uso de integraciones: Deja que solo los miembros de pago usen las integraciones integradas, como las acciones de IA.
  • Dar contexto a los agentes: Revisa el primer mensaje de una conversación con un agente en la app y añade detalles que el agente usa en sus respuestas.

Cómo funcionan los hooks

Un hook es un tipo de workflow que se ejecuta justo antes de una acción en tu app. Tu app espera su respuesta y luego deja que la acción continúe o la detiene.
  • Su respuesta: Cada hook devuelve Permitido o Bloqueado. Algunos también devuelven detalles extra, como el rol de una persona nueva o contexto para un agente en la app.
  • Cuando bloquea: La persona ve el mensaje que definiste en tu regla, o un mensaje general si no definiste ninguno.
  • Información externa: La mayoría de los hooks pueden llamar a una función de backend, por ejemplo para consultar un directorio interno. El hook Antes de guardar datos solo puede comprobar condiciones y cálculos, para que guardar siga siendo rápido.
  • Cambios desde código: El hook Antes de guardar datos también se ejecuta cuando una función de backend cambia datos, no solo las páginas de tu app.
Si un hook falla o tarda demasiado, tu app bloquea la acción. Antes de confiar en un hook nuevo, revisa su lógica y sus primeras ejecuciones. Así un error en una regla no impide que la gente use tu app.

Elegir un hook

Cada hook se ejecuta antes de una acción distinta en tu app. Cuando describes una regla al chat de IA, elige el adecuado por ti, pero conocerlos te ayuda a describir lo que quieres. Los hooks de registro y de primer acceso también pueden definir el rol de la persona u otros detalles. El hook de conversación añade información que el agente usa durante toda la conversación. El hook de mensaje añade información solo para esa respuesta.
Algunos hooks solo aparecen cuando tu app los necesita. Solo ves los hooks de registro y de primer acceso si tu app requiere iniciar sesión. Los hooks de conversación y de mensaje solo aparecen si tu app tiene un agente en la app.

Crear un hook

Creas un hook igual que cualquier workflow, describiendo lo que quieres en el chat de IA. La IA construye el hook, hace las preguntas que necesite y lo añade a tu lista de Flujos de trabajo.

Describir tu regla

Describe tu regla con palabras sencillas, y la IA elige el hook adecuado por ti. Por ejemplo:
Para crear un hook desde el chat de IA:
  1. Ve al editor de la app.
  2. Describe la regla en el chat de IA y envíala.
  3. Responde a las preguntas de seguimiento que haga la IA.

Elegir primero la acción

Empieza en la página Flujos de trabajo cuando sepas qué acción quieres comprobar, como guardar un registro. Cuando eliges la acción, el chat de IA se abre con un prompt empezado para que lo termines. Para crear un hook desde la página Workflows:
  1. Ve al editor de la app.
  2. Haz clic en Panel.
  3. Haz clic en Flujos de trabajo.
  4. Haz clic en Crear flujo de trabajo.
  5. Haz clic en Añadir punto de inicio.
  6. En Hooks, elige la acción que quieres comprobar, como Antes de guardar datos.
  7. Añade tu regla al prompt del chat de IA y envíalo.
  8. Responde a las preguntas de seguimiento que haga la IA.
El menú Add starting point desplazado hasta la sección Hooks, con Before data is saved resaltado

Elegir un hook como punto de partida


Revisar un hook

Antes de confiar en un hook, comprueba que hace lo que querías. Puedes leer su lógica y probarlo con datos reales. Para revisar sus ejecuciones, consulta monitorear ejecuciones. Para desactivarlo o archivarlo, consulta gestionar workflows.

Leer la lógica de un hook

Abre un hook desde tu lista de workflows para verlo como un diagrama, desde la acción que comprueba, pasando por cada condición, hasta el resultado. Haz clic en un paso para ver sus detalles. Un paso de condición muestra lo que comprueba. Un paso de resultado muestra su decisión, Permitido o Bloqueado, y el mensaje que ve la gente.
El diagrama de un hook con el paso Block order seleccionado, que muestra su mensaje y la decisión Blocked en el panel de detalles

Leer la lógica de un hook

Probar un hook

Prueba un hook para ver cómo responde a los datos de una de sus ejecuciones anteriores, usando sus reglas actuales. El hook necesita ejecutarse al menos una vez antes de que puedas probarlo. Cuando empieza la prueba, el diagrama del hook se abre en la ejecución de prueba, para que veas si permitió o bloqueó la acción. En la pestaña Actividad, las ejecuciones de prueba se etiquetan como Prueba.
Probar un hook no ejecuta la acción que protege, como guardar el registro. Las funciones de backend que llama el hook sí se ejecutan, así que pueden cambiar datos reales o contactar con servicios externos.
Para probar un hook:
  1. Ve al editor de la app.
  2. Haz clic en Panel.
  3. Haz clic en Flujos de trabajo.
  4. Haz clic en el hook para abrirlo.
  5. Haz clic en Ejecutar ahora en el panel de detalles.
  6. En el cuadro de diálogo, elige una ejecución anterior para usarla como datos de prueba.
  7. Haz clic en Ejecutar prueba.
La ventana Test hook with previous data con una ejecución anterior seleccionada y el botón Run test resaltado

Probar un hook con datos anteriores

Esta página fue traducida con IA. Para obtener la información más precisa y actualizada, consulta la versión en inglés.