Envía los datos de los documentos analizados a cualquier app mediante Webhook
Zapier y Make resuelven la mayoría de los casos de uso de automatización. Pero cuando tu destino es una aplicación personalizada, una base de datos interna o un sistema que no está en ningún marketplace de apps, necesitas una conexión directa. Para eso sirven los webhooks de Parseur.
Cada vez que Parseur procesa un documento, envía una solicitud HTTP POST a una URL que tú controlas, con los campos extraídos en un payload JSON. Tu aplicación recibe datos limpios y estructurados en tiempo real y los maneja como tu sistema lo requiera. Sin plataformas intermedias, sin mapeo a través de interfaces de terceros ni costes por tarea procesada.
Una encuesta de Parseur y QuestionPro de 2025 encontró que los empleados dedican más de 9 horas a la semana transfiriendo datos de documentos a otras herramientas, con un costo promedio de 28.500 $ por empleado al año. Para equipos de desarrollo que integran automatización documental en sus propios productos, los webhooks son el camino de menor latencia del documento analizado al sistema en vivo.
Resumen de puntos clave
Parseur envía JSON estructurado a cualquier endpoint HTTP mediante webhook cada vez que se procesa un documento. Sin necesidad de una plataforma intermedia.
Se admiten cuatro tipos de eventos: Documento procesado, Tablas aplanadas, Elemento de tabla procesado y Exportación fallida. Cada uno cubre un caso de uso diferente.
Las cabeceras HTTP personalizadas te permiten añadir tokens de autenticación o secretos compartidos para proteger tu endpoint de webhook.
Los webhooks funcionan para cualquier destino: aplicaciones personalizadas, bases de datos internas, ERP, herramientas de automatización autoalojadas como n8n y microservicios.
Usa Zapier o Make si tu destino es una app popular. Usa webhooks cuando no lo sea.
Webhook vs Zapier vs Make: cuándo usar cada uno
Los tres métodos permiten enviar los datos de Parseur a otros sistemas. La opción correcta depende de tu destino:
Usa Zapier o Make cuando el destino es una aplicación popular ya incluida en su catálogo (Google Sheets, HubSpot, Salesforce, Slack, Airtable y miles más). Es más rápido de configurar y no requiere programación.
Usa un webhook cuando el destino es una app personalizada, un sistema interno propietario, una herramienta autoalojada como n8n o una base de datos que las plataformas no-code no cubren. Los webhooks te dan control total: tú escribes el endpoint receptor, decides cómo se gestionan los datos y no dependes del modelo ni de los límites de ninguna plataforma.
Para equipos que crean funciones de automatización documental para sus propios productos o herramientas internas, los webhooks son el estándar de integración.
Eventos de webhook soportados por Parseur
Parseur dispara diferentes eventos según lo que necesites:
Evento
Cuándo se dispara
Mejor para
Documento procesado
Cuando un documento ha sido extraído completamente
Uso general: un payload por documento con todos los campos
Tablas aplanadas
Cuando se procesa un documento con tablas
Salida tipo hoja de cálculo con filas de tabla aplanadas
Elemento de tabla procesado
Una vez por cada fila en un campo de tabla
Insertar cada línea como un registro de base de datos individual
Exportación fallida
Cuando falla la entrega de un webhook
Monitoreo de errores y alertas por Slack/email
El evento "Elemento de tabla procesado" es especialmente útil para líneas de factura o tablas de pedidos, cuando quieres que cada fila cree un registro distinto en vez de procesar el array completo de una vez.
¿Qué contiene el JSON enviado por el webhook?
Cuando se procesa un documento, Parseur envía un objeto JSON a tu endpoint. El payload incluye:
Tus campos extraídos como pares clave-valor (con los nombres de campo que definiste en tu plantilla)
Filas de tabla como arrays de objetos, un objeto por fila
Metadatos del documento: ID del documento, ID del buzón, timestamp de procesamiento y nombre del archivo original
La estructura refleja exactamente tu plantilla. Un campo llamado invoice_number en tu plantilla de Parseur llega como invoice_number en el JSON. Los campos de tabla llegan como arrays, y cada fila contiene los valores de columna definidos por ti.
Para ver el esquema completo del payload y los tipos de campos, revisa la documentación de webhooks.
Paso a paso: cómo configurar webhooks en Parseur
Paso 1: Sube un documento y define tu plantilla de extracción
Arrastra y suelta un documento en tu buzón, o reenvía un email a la dirección de tu buzón Parseur. Configura una regla de reenvío automático para manejar los documentos entrantes de manera escalable.
Cuando tu documento aparezca en Parseur, resalta los campos que quieres extraer y nómbralos. La IA de Parseur aplicará esa plantilla a todos los documentos similares en el futuro.
Define los campos que quieres en tu payload JSON
Paso 2: Crea tu webhook
Ve a Exportar, luego a Webhook, y después haz clic en Nuevo Webhook. Pega la URL de tu endpoint y elige el evento que lo disparará.
Si primero estás probando la integración, utiliza webhook.site para obtener una URL pública temporal que registra cada solicitud recibida. Así puedes inspeccionar el JSON antes de conectarlo a tu sistema real.
Utiliza webhook.site para inspeccionar el payload antes de conectar tu endpoint real
Pega la URL en Parseur en el campo de URL de destino.
Agrega la URL de tu endpoint y elige el evento disparador
Paso 3: Añade cabeceras de autenticación (recomendado)
Para endpoints de producción, agrega una cabecera HTTP personalizada con un token de autenticación o un secreto compartido. Tu endpoint receptor validará la cabecera antes de procesar el payload. Esto previene solicitudes no autorizadas a tu sistema.
Paso 5: Prueba la integración
Reprocesa un documento en tu buzón de Parseur para disparar la entrega del webhook. Revisa los logs de tu endpoint o de webhook.site para confirmar que el payload llegó y que la estructura sea la correcta.
Verifica la estructura del JSON en los logs de tu endpoint
Una vez que la prueba sea exitosa, tu endpoint recibirá un payload JSON automáticamente por cada documento procesado en Parseur.
Los equipos usan los webhooks de Parseur para conectar el análisis de documentos con sistemas a los que las plataformas no-code no llegan:
Bases de datos personalizadas: Envía líneas de factura directamente a PostgreSQL o MySQL. Cada evento de "Elemento de tabla procesado" inserta una fila, manteniendo el esquema limpio sin importaciones batch.
ERP internos: Dirige los datos extraídos de órdenes de compra directamente al ERP a través de su API REST, sin necesitar canalizaciones de importación de archivos.
Microservicios: Dispara un servicio downstream cuando se procese un documento, por ejemplo, para iniciar un paso de validación o notificar a un servicio de fulfilment cuando llegue un nuevo pedido.
n8n autoalojado: Usa Parseur como la capa de extracción documental en un flujo de trabajo n8n corriendo en tu propia infraestructura. Consulta la guía de integración con n8n para la configuración completa.
CRM y gestión de leads: Envía los datos de emails de leads directamente al endpoint API de un CRM, sin pasar por Zapier.
Herramientas gratuitas para tipos de documentos relacionados
¿Quieres inspeccionar la salida JSON de tipos de documento específicos antes de programar tu integración? Estos conversores gratuitos te muestran la estructura en el navegador:
Parseur es un potente software de procesamiento de documentos que te permite extraer datos de correos electrónicos, archivos PDF y documentos, y automatizar tu flujo de trabajo.
Todas las características de Parseur.
¿Qué es Webhook?
Un webhook se utiliza para intercambiar datos entre aplicaciones y servidores usando su API. Un webhook es un evento de notificación (vía HTTP POST) que se activa cada vez que Parseur analiza un nuevo documento y enviará los datos analizados como JSON.
Preguntas comunes sobre el uso de los webhooks de Parseur para enviar datos de documentos analizados a aplicaciones y APIs personalizadas.
Un webhook de Parseur es una solicitud HTTP POST que Parseur envía a una URL que especifiques cada vez que se procesa un documento. La solicitud contiene los campos extraídos como un payload JSON. Tu aplicación recibe los datos en tiempo real y puede procesarlos, almacenarlos o encaminarlos según lo necesites.
El payload JSON contiene los campos extraídos de tu documento como pares clave-valor, junto con metadatos como el ID del documento, el ID del buzón y la marca de tiempo de procesamiento. Los datos de tablas se incluyen como un array de objetos, donde cada fila es una entrada separada. La estructura exacta dependerá de los campos de tu plantilla. Consulta la referencia completa del payload en la documentación de Parseur.
Parseur reintenta automáticamente los envíos de webhook fallidos. Si tu endpoint no está disponible temporalmente, el envío se volverá a intentar. También puedes usar el evento "Exportación fallida" para activar una alerta cuando un intento de entrega falla, para que tu equipo pueda responder rápidamente.
Sí. Las instancias autoalojadas de n8n se conectan a Parseur a través de nodos de webhook genéricos. Tu instancia de n8n debe ser accesible públicamente para que Parseur pueda alcanzar el endpoint. El conector nativo de Parseur también está disponible para n8n Cloud.
Sí. El evento "Elemento de tabla procesado" dispara una llamada de webhook separada por cada fila en un campo de tabla. Esto es útil si quieres insertar cada línea de una factura como un registro de base de datos independiente, en lugar de recibir todas las filas en un solo array.
Parseur admite cuatro eventos disparadores de webhooks. "Documento procesado" se dispara con el payload completo en JSON cuando se extrae un documento. "Tablas aplanadas" envía los datos de las tablas en un formato donde cada fila de la tabla es un objeto separado. "Elemento de tabla procesado" se dispara por separado para cada fila de un campo de tabla. "Exportación fallida" se dispara cuando falla un intento de entrega, útil para monitoreo de errores y alertas.
Sí. Parseur permite añadir cabeceras HTTP personalizadas a la solicitud del webhook, incluida una cabecera Authorization con un token o un secreto compartido. Tu endpoint receptor puede entonces validar cada solicitud antes de procesarla. Este es el enfoque recomendado para webhooks que escriben en bases de datos de producción o desencadenan flujos sensibles.
Usa un webhook cuando te conectes a una aplicación personalizada, un sistema interno propietario o una base de datos que no esté disponible en las bibliotecas de apps de Zapier o Make. Los webhooks te dan el control total sobre cómo se reciben y procesan los datos. Si tu destino es una app popular como Google Sheets, HubSpot o Slack, Zapier o Make son más rápidos de configurar.
Sí. Herramientas como webhook.site te dan una URL pública temporal que registra cada solicitud entrante, para que puedas inspeccionar la estructura del payload JSON antes de conectarlo a tu sistema real. Reprocesa un documento en Parseur luego de configurar tu webhook para hacer una prueba de entrega.
Sí. Parseur dispone de una API REST que te permite subir documentos de forma programática, recuperar los resultados analizados y gestionar buzones. Los webhooks son push-based (Parseur llama a tu endpoint), mientras que la API es pull-based (tú llamas al endpoint de Parseur). La mayoría de integraciones en tiempo real usan webhooks; la API resulta útil para flujos batch o cuando prefieres hacer polling.
