El paso Wait for Webhook pausa un workflow hasta que recibe una solicitud webhook, ideal para procesos que requieren entrada externa antes de continuar.
Imagina que tu workflow necesita integrarse con un sistema externo, como una aplicación de terceros para verificación de identidad. Con Wait for Webhook, el workflow se detiene en este paso hasta que el sistema externo envía una respuesta webhook. Una vez recibida, la tarea se reanuda y actúa según los datos proporcionados.
Ejemplos
Verificación de identidad: Pausa el workflow hasta que un servicio de terceros confirme la identidad de un usuario.
Confirmación de pago: Espera un webhook de tu proveedor de pagos para confirmar una transacción antes de continuar.
Cumplimiento de pedidos: Pausa hasta que tu sistema de inventario envíe una actualización sobre la disponibilidad de stock.
Procesos de aprobación: Mantén el workflow en espera hasta que una herramienta de terceros envíe un estado de aprobación o rechazo.
Esta función asegura que tus workflows sean fluidos y estén sincronizados con sistemas externos, reduciendo la intervención manual y manteniendo la eficiencia.
Agregar Wait for Webhook a un workflow
Para agregar un paso Wait for Webhook a tu workflow:
Ve a Fin AI Agent > Workflows y añade un nuevo workflow o abre uno existente.
Luego haz clic en Añadir paso y selecciona Wait for Webhook.
Selecciona el bloque Wait for Webhook para configurarlo.
Activa el workflow.
Mejores prácticas para Wait for Webhook
Agrega un nombre claro al paso para facilitar la identificación de variables temporales creadas para el paso.
Configura correctamente la Solicitud de ejemplo incluyendo todos los campos que esperas recibir en la devolución de llamada webhook dentro del objeto de datos.
Asegúrate de que el webhook devuelva un cuerpo JSON que coincida con la estructura del paso. Si la estructura JSON se actualiza, no se recibirán datos. Los campos faltantes en la configuración también harán que esos campos sean inaccesibles en la tarea.
Haz clic en el botón "Copiar" para copiar la URL del webhook al portapapeles. En el sitio de terceros donde se activa el webhook, asegúrate de que se pase el
conversationIdcomo se espera.
Nota:
El endpoint webhook soporta idempotencia para reintentar solicitudes de forma segura y evitar que la misma operación se realice más de una vez. Al enviar una solicitud, incluye un encabezado "Idempotency-Key" con un valor único. Recomendamos usar UUIDs. Las claves de idempotencia expiran después de 24 horas.
El paso Wait for Webhook no esperará indefinidamente y tiene un límite incorporado de 7 días. Si no se recibe un webhook dentro de los 7 días posteriores a alcanzar el paso, este expirará. No es posible cambiar este límite.