Saltearse al contenido
Nappai Documentation

Typeform Webhook

Este componente actúa como un buzón digital inteligente que está siempre atento a las respuestas que los usuarios envían desde un formulario de Typeform. En lugar de tener que revisar manualmente cada respuesta o depender de actualizaciones manuales, Nappai capturará los datos automáticamente en el momento exacto en que se complete un formulario. Una vez recibida la información, la prepara y la organiza para que puedas usarla inmediatamente en tus flujos de trabajo, análisis con IA o bases de datos.

¿Cómo funciona?

Cuando un usuario final llena y envía un formulario en Typeform, la plataforma envía una notificación instantánea a este componente. Él verificará internamente que la notificación sea legítima y segura, luego extraerá todos los campos y respuestas del formulario, y finalmente transformará esa información cruda en un mensaje estructurado y fácil de leer. Este resultado se entrega automáticamente al siguiente paso de tu flujo, permitiendo que otros nodos (como un asistente de IA, un generador de correos o un sistema de almacenamiento) actúen sobre ella sin intervención manual.

Conexión y Credenciales

Para que este componente pueda comunicarse de forma segura y fiable con Typeform, es necesario tener configurada previamente una credencial en Nappai. Sigue estos pasos:

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo Typeform API y guarda los datos solicitados (token de integración).
  3. Regresa a tu flujo de trabajo y, dentro de este nodo, selecciona la credencial que acabas de crear en el campo de entrada Credential.

Nota: No es necesario escribir claves o tokens manualmente en los campos de configuración de este nodo. Solo selecciona la credencial ya guardada desde el menú desplegable.

Entradas

Los siguientes campos están disponibles para configurar este componente:

  • Webhook Secret: Es la clave de autenticación que valida que las notificaciones entrantes provienen realmente de Typeform. Se requiere para activar la verificación de seguridad del nodo.

    • Visible en: Modo de uso estándar

  • Form ID: El identificador único de tu formulario en la plataforma Typeform. Determina exactamente qué formulario debe ser monitoreado y qué tipo de respuestas se recibirán.

    • Visible en: Modo de uso estándar

  • Webhook URL: La dirección web generada automáticamente por el sistema para recibir las notificaciones. No requiere configuración manual, ya que se actualiza dinámicamente al activar el nodo.

    • Visible en: Modo de uso estándar

Salidas

Este componente produce principalmente:

  • Response Form: Contiene el resultado final procesado con las respuestas del formulario, ya estructurado y listo para ser consumido. Es la salida principal que conectarás a otros nodos para análisis, almacenamiento o respuestas automáticas.
  • Además, el sistema expone metadatos internos adicionales (como timestamps de recepción o identificadores de sesión) que pueden ser útiles en flujos avanzados de automatización.

Ejemplo de Respuesta JSONjson

{ “form_id”: “abc123xyz”, “submitted_at”: “2024-05-20T14:30:00Z”, “form_response”: { “nombre”: “Carlos Pérez”, “correo”: “carlos@empresa.com”, “mensaje”: “Necesito automatizar la generación de reportes mensuales”, “prioridad”: “Alta” }, “message”: “Formulario recibido: Nombre: Carlos Pérez | Correo: carlos@empresa.com | Mensaje: Necesito automatizar la generación de reportes mensuales | Prioridad: Alta” }

Conectividad

Por su naturaleza como receptor de eventos en tiempo real, este componente funciona principalmente como fuente de entrada en tus flujos de automatización. Las conexiones más comunes y recomendadas son:

  • Nodos de Análisis de IA o Asistentes: Para que la IA procese el texto, extraiga intenciones, clasifique leads o genere respuestas sugeridas.
  • Nodos de Almacenamiento o Bases de Datos: Para guardar permanentemente las respuestas del formulario y mantener un historial actualizado.
  • Nodos de Notificación o Disparadores: Para enviar correos de confirmación al usuario, alertar a un equipo por Slack/email, o activar otro paso del flujo de trabajo.

Nota: Al ser un componente pasivo que “escucha” eventos, no se conecta normalmente a la entrada de otros nodos para recibir datos, sino que actúa como el punto de inicio o proveedor de información en el flujo.

Ejemplo de Uso

Imagina que utilizas Typeform para captar solicitudes de soporte técnico de tus clientes. Al configurar este nodo en tu dashboard:

  1. El sistema empezará a escuchar automáticamente cualquier nuevo envío en el formulario vinculado.
  2. Cuando un cliente complete el formulario, los datos llegarán instantáneamente a este componente.
  3. Podrás conectar la salida Response Form a un nodo de “Procesamiento con IA” para que extraiga automáticamente los campos críticos y determine la prioridad del caso.
  4. El flujo continuará de forma autónoma, enviando una respuesta de confirmación al cliente y guardando el ticket en tu base de datos, sin que tengas que intervención manualmente.

Consejos y Mejores Prácticas

  • Asegúrate de copiar el Form ID exactamente como aparece en la URL de tu formulario en Typeform para evitar errores de conexión o respuestas vacías.
  • Si estás probando tu flujo en entorno de desarrollo, el sistema mostrará registros detallados en la consola para ayudarte a verificar que todo funciona correctamente; este comportamiento es normal y se optimiza en producción.
  • Mantén el nodo siempre activo en tu dashboard si necesitas capturar respuestas en tiempo real; de lo contrario, las notificaciones podrán ser ignoradas o retrasadas.
  • Conecta la salida a nodos que estén preparados para recibir texto o estructuras de datos para obtener mejores resultados con la automatización.

Consideraciones de Seguridad

Este componente utiliza una validación interna mediante la clave Webhook Secret para garantizar que solo se procesen respuestas legítimas de Typeform, bloqueando peticiones no autorizadas o falsas. Asegúrate de no compartir esta clave públicamente ni exponerla en código visible. Al trabajar en entornos de desarrollo, ten en cuenta que los logs de depuración pueden ser más detallados durante las pruebas; esto es una característica de seguridad y control, no un error del sistema.