Webhooks

Un webhook es la forma más rápida de llevar una respuesta del formulario a tu propio sistema. Nunca tienes que preguntar «¿hay algo nuevo?»: Gatherino llama a tu endpoint en cuanto llega una respuesta.

Dato útil: el editor y la cuenta de Gatherino están disponibles en inglés o checo. Los formularios que rellenan quienes responden pueden mostrarse en 18 idiomas, incluido el español.

Usos habituales

Escribir en tu propio sistema

Un pedido que va directo a tu tienda, un lead a tu CRM o una solicitud a una base de datos interna.

Conectar herramientas de automatización

Apunta el webhook a cualquier servicio que acepte webhooks entrantes, normalmente Zapier, Make o n8n.

Notificaciones personalizadas

Un mensaje a un chat interno, una pasarela SMS o tu propio panel.

Cómo configurarlo

  1. 1

    Prepara un endpoint

    Una URL en tu servidor que acepte una petición HTTPS POST con un cuerpo en JSON.

  2. 2

    Añade la URL al formulario

    Introduce la URL del webhook en la configuración del formulario o usa un paso de webhook dentro de una automatización.

  3. 3

    Procesa los datos

    El cuerpo contiene la respuesta, con los valores de los campos. Las claves son los ID de los campos del formulario; obtén sus etiquetas desde el detalle del formulario a través de la API.

  4. 4

    Pruébalo

    Envía una respuesta de prueba y comprueba que tu sistema ha recibido y procesado la petición.

Ejemplo de receptor (Node.js)

Un receptor mínimo que guarda el envío en tu sistema:

app.post('/gatherino-hook', express.json(), (req, res) => {
  const submission = req.body;
  // submission.data holds the form field values
  saveToDatabase(submission);
  res.sendStatus(200);   // respond fast, do the work in the background
});

Seguridad: los webhooks solo llegan a direcciones HTTPS públicas. Las llamadas a rangos de IP internos y privados están bloqueadas, de modo que un webhook no pueda usarse para sondear tu red interna. Protege tu endpoint con un token secreto en la URL y valida que el contenido tenga el formato esperado.

Preguntas frecuentes

¿En qué formato están los datos?

JSON que describe el envío: identificador, marca de tiempo, estado y un objeto con los valores de los campos.

¿Qué pasa si mi servidor se cae temporalmente?

Acepta la petición rápidamente y deja el procesamiento en segundo plano. Siempre puedes recuperar los datos más tarde a través de la API REST.

¿Puedo tener más de un webhook?

Sí: además del webhook a nivel de formulario, puedes añadir pasos de webhook dentro de las automatizaciones, con condiciones.

¿Funciona con Zapier o Make?

Sí, basta con pegar en el formulario la URL de webhook entrante que generan esos servicios.

Relacionados

Prueba Gatherino gratis

Plan gratuito: 3 formularios y 100 respuestas al mes. Sin tarjeta de crédito. Datos alojados en la UE.

Empieza gratis →