Trigger Form

Descripcion

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 estandar (cuando el formulario se envia desde el frontend) o via invocacion 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 informacion del formulario configurado.

Configuracion

Parametros

Parametro	Tipo	Requerido	Descripcion
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 automaticamente para recibir envios 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 basico

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

Notas

• La URL del webhook se genera automaticamente 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 (verificacion por codigo), donde los datos llegan via invocacion directa con _request.source = 'form_otp'.
• Soporta formatos legacy con estructura { params: { result: [...] } }.
• Solo tiene conexion de salida, actua como nodo de inicio.

Nodos Relacionados

• Webhook (trigger generico por peticion HTTP)
• Start (trigger basico)
• decision (para validar campos del formulario)