Saltearse al contenido
Nappai Documentation

Google Forms Webhook

Este componente actúa como un “oído atento” para tus formularios de Google Forms. Su principal propósito es monitorear un formulario específico y detectar cuando alguien envía una nueva respuesta. Una vez detectada, la información se extrae, se organiza y se prepara para ser utilizada por el resto de tu flujo de trabajo en Nappai.

En lugar de revisar manualmente tus formularios, este nodo recoge los datos por ti, asegurando que cada respuesta quede registrada, estructurada y lista para ser procesada por otros componentes, como bases de datos, agentes de IA o sistemas de notificación.

¿Cómo funciona?

El componente opera mediante un proceso de sondeo (polling), lo que significa que revisa periódicamente el formulario de Google Forms para ver si hay respuestas nuevas pendientes.

Cuando el componente detecta una respuesta, realiza los siguientes pasos:

  1. Extracción: Recoge los datos crudos del formulario.
  2. Mapeo inteligente: Cruza los identificadores internos de las preguntas con sus títulos legibles para entender exactamente qué se preguntó y cómo se respondió.
  3. Estructuración: Organiza la información en un formato útil. Genera un resumen de texto fácil de leer (ideal para agentes de IA o visualización en el dashboard) y una estructura de datos completa con metadatos (como la fecha de envío y el ID de respuesta), útil para guardar en bases de datos o conectar con otras APIs.

El sistema es robusto y maneja errores de forma segura; si no hay datos o hay un problema en la estructura, el componente lo detectará sin interrumpir el flujo, permitiendo una integración confiable.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con la API de Google Forms y acceder a tus formularios de forma segura.

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo Google Forms. Para ello, necesitarás acceder a tu Google Cloud Console y obtener los identificadores de tu proyecto. Puedes encontrar instrucciones detalladas en la documentación de conexión a servicios de Google.
    • La credencial requiere configurar: Select Project, Client Id, Client Secret y Google Forms access.
  3. Una vez creada la credencial y guardados los campos requeridos, regresa a tu flujo de trabajo.
  4. En el campo Credential de este nodo, selecciona la credencial que acabas de crear.

Nota: No es necesario configurar claves de API o tokens manualmente dentro del componente; todo se gestiona a través de la credencial seleccionada.

Entradas

A continuación se detallan los campos disponibles para configurar este componente:

  • Form: Permite seleccionar el formulario específico de Google Forms que deseas monitorear. Al activar este campo, el sistema te mostrará una lista de tus formularios disponibles, actualizándose en tiempo real para que siempre veas las opciones correctas.

Salidas

El componente produce la siguiente salida principal para ser utilizada en pasos posteriores de tu flujo:

  • Data: Contiene la información procesada de las respuestas. Cada elemento en esta salida representa una respuesta individual enviada al formulario.
    • Incluye un texto resumen que muestra el título del formulario y las respuestas clave, fácil de leer para humanos o agentes de IA.
    • Incluye una estructura de datos completa con metadatos (como fecha y ID de respuesta) y las respuestas mapeadas a sus respectivas preguntas.

Ejemplo de Respuesta JSON

A continuación se muestra un ejemplo realista de lo que devuelve el componente Data. Este ejemplo te ayuda a identificar las variables que puedes mapear en los nodos siguientes: json { “text”: “Respuesta de Formulario de Registro de Clientes (+2 more)”, “event_data”: { “form_id”: “1FAlpQL…cHc”, “response_id”: “ABCDEF123456”, “created_at”: “2023-10-27T14:30:00Z”, “updated_at”: “2023-10-27T14:30:00Z”, “answers”: { “question_id_1”: “Juan Pérez”, “question_id_2”: “juan.ejemplo@email.com”, “question_id_3”: “Excelente”, “question_id_4”: “La interfaz es muy intuitiva y rápida.” } } }

Conectividad

Este nodo es un punto de entrada de datos. Lógicamente, su salida se conecta con componentes que necesitan consumir esa información, tales como:

  • Almacenamiento: Nodos de bases de datos o hojas de cálculo para archivar las respuestas.
  • Procesamiento de IA: Nodos de LLM o agentes para analizar el sentimiento de las respuestas, generar resúmenes o extraer texto clave.
  • Acciones: Flujos que disparen notificaciones o actualicen otros sistemas según el contenido de la respuesta.

Ejemplo de Uso

Escenario: Automatización de Retroalimentación de Clientes

  1. Configuras el componente Google Forms Webhook seleccionando tu formulario de “Encuesta de Satisfacción” y tu credencial de Google Forms.
  2. Conectas la salida Data a un nodo de Análisis con IA.
  3. La IA analiza automáticamente cada nueva respuesta para determinar si el cliente está satisfecho o insatisfecho.
  4. Según el resultado de la IA, el flujo redirige la respuesta:
    • Si es positiva, se guarda en una base de datos de casos de éxito.
    • Si es negativa, se envía una alerta al equipo de soporte vía otro canal.

En este flujo, el componente Google Forms Webhook es la pieza clave que detecta el evento (la respuesta del cliente) y prepara los datos para que la automatización ocurra sin intervención manual.

Consejos y Mejores Prácticas

  • Valida tu credencial: Asegúrate de que la credencial de Google Forms tenga los permisos correctos y que el proyecto en Google Cloud esté activo antes de monitorear el flujo.
  • Uso de datos estructurados: Utiliza el campo de datos estructurados cuando necesites integrar la respuesta con otras APIs o bases de datos externas. Usa el texto resumen cuando necesites una lectura rápida o un input para agentes de IA.
  • Manejo de listas: El componente puede procesar múltiples respuestas en una sola ejecución. Ten en cuenta que la salida puede ser una lista de elementos, lo que permite procesar varios envíos simultáneamente si tu flujo está configurado para ello.
  • Monitoreo continuo: Este componente está diseñado para trabajar en un flujo activo. Asegúrate de que el flujo esté ejecutándose correctamente para que el sondeo detecte las respuestas en tiempo cercano al real.

Consideraciones de Seguridad

  • Protección de Credenciales: Nunca compartas ni expongas tus credenciales de Google Forms. Asegúrate de que solo usuarios autorizados puedan editar o ver los flujos que contienen estas credenciales.
  • Integridad de Datos: El componente incluye validaciones internas para evitar errores si los datos entrantes no tienen el formato esperado, protegiendo tu flujo de fallos en cascada por respuestas mal formadas.n