Trigger Form

Descripción

El modulo FormTrigger es un trigger especializado que inicia el workflow cuando un usuario envia un formulario. Extiende la funcionalidad del Webhook agregando metadata especifica del formulario (ID, nombre, campos). Los datos pueden llegar de dos formas: via webhook estándar (cuando el formulario se envia desde el frontend) o via invocación directa (por ejemplo, en flujos OTP). El modulo extrae el payload del formulario y lo pasa al siguiente nodo junto con la metadata del request y la información del formulario configurado.

Configuración

Parámetros

Parámetro	Tipo	Requerido	Descripción
form_id	form_trigger_selector	Si	Selecciona el formulario que activara este workflow. Puedes crear uno nuevo si no existe.
url_webhook	webhook_generator	No	URL generada automáticamente para recibir envíos del formulario.

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "campo_formulario_1": "valor1",
    "campo_formulario_2": "valor2",
    "_request": {
      "method": "POST",
      "timestamp": "2026-03-23T10:00:00.000Z",
      "source": "form",
      "isDev": false
    },
    "_form": {
      "form_id": "123",
      "form_name": "Formulario de contacto",
      "form_fields": ["nombre", "email", "mensaje"]
    }
  }
}

Ejemplo de Uso

Caso básico

{
  "label": "Trigger Form",
  "form_id": "mi_formulario_contacto",
  "url_webhook": {}
}

Notas

• La URL del webhook se genera automáticamente al guardar el workflow.
• Los datos del formulario se expanden en el nivel raiz del data.
• La metadata del formulario esta disponible en data._form para uso en nodos posteriores.
• Compatible con flujos OTP (verificación por código), donde los datos llegan via invocación directa con _request.source = 'form_otp'.
• Soporta formatos legacy con estructura { params: { result: [...] } }.
• Solo tiene conexión de salida, actua como nodo de inicio.

Nodos Relacionados

• Webhook (trigger genérico por petición HTTP)
• Start (trigger básico)
• decision (para validar campos del formulario)