Trigger: webhook externo
Inicia la automatización con el JSON enviado a una URL única generada para el webhook.
Que se logra
- Resultado: Permite que un sistema externo inicie un flujo con una URL propia de la automatización.
- Caso de uso: Un e-commerce: cuando su tienda confirma un pago, llama el webhook; Apex crea o actualiza el contacto y envía la confirmación por WhatsApp.
- Se combina con:
Flow Control,Acciones de contactosyMensajería de conversaciones.
Donde esta
- Ruta:
/[orgId]/automations/[automationId] - Acceso en UI:
Automation editor > Start node > Add Trigger - Componente(s):
WebhookConfig.tsx
Como funciona
- En el nodo
Start, agregar este trigger y abrir su configuración. - Definir los filtros disponibles y guardar con
Save Configuration. - Activar el interruptor del trigger y publicar el flujo con
Publish.
Campos y opciones
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
Generate Webhook URL |
acción | Sí | Crea la URL para la automatización. |
Copy |
acción | No | Copia la URL. |
Replace webhook URL |
acción | No | Invalida la URL anterior y genera otra. |
Reglas y validaciones
- El sistema externo debe enviar una petición
POSTcon cuerpo JSON. - Reemplazar la URL obliga a actualizar el sistema emisor.
Backend
- Servicios:
automations-webhooks(configuración),automation-run(inicio),automations-executions(ejecución). - Hooks relevantes:
automations-webhooks/hooks/create-replace-path.js;automation-run. - Efectos: una coincidencia inicia el flujo publicado con el registro o evento que produjo el trigger como datos iniciales.
Relaciones
- Requiere: una automatización publicada y el trigger activo.
- Dispara / afecta: los nodos conectados desde
Starty el historial de ejecuciones.
Notas
- El contenido JSON se convierte en los datos iniciales disponibles para los nodos del flujo.