Webhook

Un webhook es una devolución de llamada HTTP que envía automáticamente datos de una aplicación a otra cuando ocurre un evento específico. A diferencia de las [API](/glossary/api) donde se realiza polling para obtener actualizaciones, los webhooks envían datos en tiempo real a medida que ocurren los eventos. La aplicación receptora escucha en un endpoint URL especificado y procesa los datos entrantes inmediatamente al llegar. Los webhooks siguen un modelo publicador-suscriptor: la aplicación origen envía una solicitud HTTP POST a una URL pre-registrada cada vez que ocurre un evento desencadenante, y el suscriptor procesa la carga sin necesidad de solicitarla.

Los webhooks eliminan la necesidad de transferencias manuales de datos o polling constante entre sistemas. Para los editores digitales, esto significa que los clientes potenciales capturados, las transacciones de ventas y la actividad de los espectadores pueden fluir automáticamente a CRMs, plataformas de correo electrónico o bases de datos internas en el momento en que suceden. Esto reduce los retrasos de minutos u horas a milisegundos, elimina el trabajo manual de exportación-importación y garantiza que tus sistemas empresariales siempre tengan datos actualizados. Sin webhooks, los equipos deben revisar paneles manualmente o construir procesos por lotes que van por detrás de los eventos en tiempo real.

La función [automatización e integraciones](/features/automation-and-integrations) de FlipLink admite webhooks que se activan cuando ocurren eventos clave. Puedes configurar endpoints de webhooks para recibir datos cuando se captura un nuevo cliente potencial, se visualiza un documento o se completa una venta a través de Stripe. Cada webhook envía una carga útil JSON estructurada con los detalles del evento a tu URL especificada. Esto te permite conectar FlipLink a prácticamente cualquier sistema, incluidas herramientas como Zapier, Make o backends personalizados. Combinados con la [integración de Google Sheets](/features/automation-and-integrations), los webhooks ofrecen a los editores una forma flexible de automatizar todo su flujo de trabajo de publicación sin escribir código.

Cuando ocurre un evento desencadenante, FlipLink envía una solicitud HTTP POST a tu endpoint URL registrado. El cuerpo de la solicitud contiene una carga JSON estructurada así: - **Tipo de evento** — una cadena que identifica el evento (ej. `lead.captured`, `document.viewed`, `sale.completed`) - **Marca de tiempo** — fecha y hora del evento en formato ISO 8601 - **Datos de la carga** — los campos específicos del evento como nombre del contacto, correo electrónico, título del documento o monto de la transacción Tu endpoint debe devolver un código de estado HTTP 200 para confirmar la recepción. Si el endpoint devuelve un error o se agota el tiempo, FlipLink reintenta la entrega para garantizar que no se pierdan eventos. Todas las cargas de webhooks se envían por [HTTPS](/glossary/https), por lo que los datos están cifrados en tránsito. Para los desarrolladores que construyen integraciones personalizadas, la estructura JSON consistente facilita analizar y enrutar los eventos al manejador correcto en tu aplicación.

1. **Prepara tu endpoint.** Configura una URL HTTPS en tu servidor, Zapier, Make o cualquier servicio que pueda recibir solicitudes POST. El endpoint debe ser accesible públicamente y devolver una respuesta 200. 2. **Navega a integraciones.** En tu panel de FlipLink, ve a la configuración de [automatización e integraciones](/features/automation-and-integrations) de tu publicación. 3. **Agrega la URL del webhook.** Pega la URL de tu endpoint en el campo de configuración del webhook. 4. **Selecciona los eventos desencadenantes.** Elige qué eventos deben activar el webhook — captura de leads, visualización de documentos, finalización de ventas u otros según tus necesidades de flujo de trabajo. 5. **Envía un evento de prueba.** Usa la función de prueba para enviar una carga de ejemplo a tu endpoint. Verifica que tu sistema reciba y procese los datos correctamente. 6. **Ponlo en producción.** Guarda tu configuración. A partir de este punto, cada evento coincidente en tu [flipbook](/glossary/flipbook) activará un POST en tiempo real hacia tu endpoint. 7. **Monitorea la entrega.** Revisa los logs de tu endpoint periódicamente para confirmar que los webhooks están llegando. Si notas brechas, verifica que tu endpoint esté devolviendo respuestas 200 y que tu servidor no tenga reglas de firewall que bloqueen las solicitudes de FlipLink.

| Aspecto | Webhook | API Polling | |---------|---------|-------------| | **Entrega de datos** | Push automático cuando ocurren eventos | Pull según un calendario definido | | **Latencia** | Casi instantánea (milisegundos) | Depende del intervalo de polling (segundos a minutos) | | **Carga del servidor** | Mínima — las solicitudes ocurren solo cuando se producen eventos | Mayor — las solicitudes ocurren en cada intervalo aunque nada haya cambiado | | **Implementación** | Registrar una URL y manejar solicitudes POST entrantes | Construir un trabajo programado que llame al endpoint API repetidamente | | **Ideal para** | Notificaciones en tiempo real, sincronización CRM, alertas instantáneas | Procesamiento por lotes, reportes periódicos, capturas de datos | | **Riesgo** | La caída del endpoint puede perder eventos sin lógica de reintento | Sin eventos perdidos si el polling se recupera, pero conocimiento retrasado | Para la mayoría de los editores de FlipLink, los webhooks son la mejor opción para eventos de captura de leads y ventas donde la velocidad importa. El polling de API funciona mejor para exportaciones periódicas de analytics o paneles que se actualizan a intervalos fijos. Muchos equipos usan ambos: webhooks para el enrutamiento de leads en tiempo real y la [REST API](/glossary/rest-api) para extracciones nocturnas de analytics.