Envie dados extraídos de documentos para qualquer aplicativo via Webhook
Zapier e Make cobrem bem a maioria dos casos de uso simples de automação. Mas quando o destino é um aplicativo personalizado, um banco de dados interno ou um sistema que não está em nenhum marketplace de aplicativos, você precisa de uma conexão direta. É para isso que servem os webhooks do Parseur.
Toda vez que o Parseur processa um documento, ele envia uma requisição HTTP POST para uma URL sob seu controle, com os campos extraídos em formato JSON. Sua aplicação recebe dados limpos e estruturados em tempo real e os trata da maneira que seu sistema exigir. Sem plataforma intermediária, sem mapeamento por interface de terceiros, sem cobrança por tarefa.
Uma pesquisa Parseur e QuestionPro feita em 2025 mostrou que funcionários gastam mais de 9 horas por semana movendo dados de documentos para outras ferramentas, a um custo médio de $28.500 por colaborador por ano. Para times de desenvolvimento que desejam automatizar documentos dentro de seus próprios produtos, o webhook é o caminho de menor latência entre o documento processado e o sistema de produção.
Pontos Principais
O Parseur envia JSON estruturado para qualquer endpoint HTTP via webhook toda vez que um documento é processado. Não precisa de plataforma intermediária.
São suportados quatro tipos de evento: Documento Processado, Tabelas Achatadas, Item de Tabela Processado e Exportação Falhou. Cada um foca em um caso de uso diferente.
Você pode adicionar cabeçalhos HTTP personalizados de autenticação, como tokens ou segredos, para proteger seu endpoint de webhook.
Webhooks funcionam para qualquer destino: apps personalizados, bancos de dados internos, ERPs, automações próprias como n8n e microserviços.
Use Zapier ou Make quando o destino for um app mainstream. Use webhooks quando não for.
Webhook vs Zapier vs Make: quando usar cada um
Todas as três opções servem para enviar dados do Parseur para outros sistemas. A escolha certa depende do seu destino:
Use Zapier ou Make quando o destino for um app popular já disponível nessas plataformas (Google Sheets, HubSpot, Salesforce, Slack, Airtable, e milhares de outros). A configuração é mais rápida e não requer código.
Use webhook quando o destino for um aplicativo próprio, um sistema interno proprietário, uma ferramenta self-hosted como n8n ou um banco de dados que plataformas no-code não suportam. O webhook dá controle total: você escreve o endpoint receptor, decide o que acontece com os dados e não fica limitado ao modelo de dados ou limites de uso da plataforma.
Para equipes que desenvolvem automação de documentos dentro dos próprios produtos ou ferramentas internas, o webhook é o padrão.
Eventos de webhook suportados pelo Parseur
O Parseur dispara diferentes eventos de acordo com sua necessidade:
Evento
Quando dispara
Ideal para
Documento Processado
Quando um documento é totalmente extraído
Uso geral: um payload por documento com todos os campos
Tabelas Achatadas
Quando documento com tabelas é processado
Saída tipo planilha, onde as linhas da tabela são achatadas
Item de Tabela Processado
Uma vez por linha em um campo de tabela
Inserir cada item como registro individual no banco
Exportação Falhou
Quando falhar a tentativa de entrega do webhook
Monitoramento de erros e alertas Slack/email
O evento "Item de Tabela Processado" é especialmente útil para itens de faturas ou listas de pedidos, onde é ideal que cada linha crie um registro separado em vez de processar o array inteiro de uma só vez.
O que o payload JSON contém
Quando um documento é processado, o Parseur envia um objeto JSON para seu endpoint. O payload inclui:
Os campos extraídos como pares chave-valor (usando os nomes que você definiu no template)
Linhas de tabelas como arrays de objetos, um objeto por linha
Metadados do documento: ID do documento, ID da caixa de entrada, timestamp do processamento e nome do arquivo original
A estrutura reflete seu template. Um campo chamado invoice_number no template do Parseur chega como invoice_number no JSON. Campos de tabela chegam como arrays, cada linha contendo os valores das colunas definidas.
Passo a passo: Como configurar webhooks no Parseur
Passo 1: Envie um documento e defina seu template de extração
Arraste e solte um documento em sua caixa de entrada, ou encaminhe um e-mail para o endereço do Parseur. Configure uma regra de encaminhamento automático para gerenciar documentos automaticamente em escala.
Quando o documento aparecer no Parseur, destaque os campos que deseja extrair e nomeie cada um. A IA do Parseur aplica esse template a todos os documentos futuros do mesmo tipo.
Defina os campos que você deseja no seu payload JSON
Passo 2: Crie seu webhook
Abra Exportar, depois Webhook, e então Novo Webhook. Cole sua URL de endpoint e escolha o evento de disparo.
Se estiver testando primeiro, use o webhook.site para obter uma URL pública temporária que registra todas as requisições, permitindo inspecionar o payload JSON exato antes de conectar ao endpoint de produção.
Use webhook.site para inspecionar o payload antes de usar o endpoint real
Cole a URL no campo URL de destino do Parseur.
Adicione a URL do endpoint e escolha o evento de disparo
Passo 3: Adicione cabeçalhos de autenticação (recomendado)
Em endpoints de produção, adicione um cabeçalho HTTP personalizado com token de autorização ou segredo compartilhado. Seu endpoint receptor valida esse header antes de processar o payload. Isso previne requisições não autorizadas ao seu sistema.
Passo 5: Teste a integração
Reprocese um documento na sua caixa de entrada Parseur para acionar a entrega do webhook. Verifique os logs do endpoint ou do webhook.site para confirmar se o payload chegou e está estruturado conforme o esperado.
Verifique a estrutura do payload JSON nos logs do endpoint
Após o teste, seu endpoint receberá automaticamente o JSON a cada documento processado pelo Parseur.
Equipes usam o webhook do Parseur para conectar extração de documentos a sistemas que plataformas no-code não alcançam:
Bancos de dados personalizados: Envie itens de fatura/linhas direto para PostgreSQL ou MySQL. Cada evento "Item de Tabela Processado" insere uma linha, preservando o schema limpo e evitando importações em lote.
ERPs internos: Direcione dados extraídos de pedidos diretamente para um ERP por REST API, sem construir pipeline de importação de arquivos.
Microserviços: Dispare um serviço downstream ao processar um documento, por exemplo gatilhando uma validação ou notificando logística quando chega novo pedido.
n8n self-hosted: Use o Parseur como camada de extração de documentos em um fluxo n8n rodando em sua infraestrutura. Veja o guia de integração n8n para saber tudo.
CRMs e roteamento de leads: Encaminhe dados de emails de lead direto para endpoint inbound do CRM, sem passar pelo Zapier.
Ferramentas gratuitas para tipos de documentos relacionados
Se quiser inspecionar o JSON gerado por tipos de documentos específicos antes de construir sua integração, estes conversores gratuitos mostram a estrutura no navegador:
Parseur é um software poderoso de extração de dados que permite extrair texto de e-mails, PDFs e outros documentos para automatizar seus fluxos de trabalho.
Todos os recursos do Parseur.
O que é Webhook?
Um webhook é usado para trocar dados entre aplicativos e servidores usando suas APIs. Um webhook é um evento de notificação (via HTTP POST) que é acionado toda vez que um novo documento é processado pelo Parseur e envia os dados extraídos em JSON.
Perguntas comuns sobre o uso de webhooks do Parseur para enviar dados extraídos de documentos para aplicações e APIs personalizadas.
Um webhook do Parseur é uma requisição HTTP POST que o Parseur envia para uma URL especificada toda vez que um documento é processado. A requisição contém os campos extraídos em formato JSON. Sua aplicação recebe os dados em tempo real e pode processá-los, armazená-los ou redirecioná-los conforme necessário.
O payload JSON contém os campos extraídos do seu documento como pares chave-valor, junto com metadados como ID do documento, ID da caixa de entrada, e data/hora do processamento. Dados de tabelas são incluídos como um array de objetos, com cada linha como uma entrada separada. A estrutura exata depende dos campos do seu modelo. Veja a referência completa do payload na documentação do Parseur.
O Parseur faz novas tentativas de entrega automaticamente em caso de falha. Se seu endpoint estiver temporariamente indisponível, a entrega será tentada novamente. Você também pode usar o evento Exportação Falhou para acionar um alerta quando uma tentativa de envio falhar, permitindo que sua equipe responda rapidamente.
Sim. Instâncias self-hosted do n8n se conectam ao Parseur via nós genéricos de webhook. Sua instância do n8n precisa ser publicamente acessível para que o Parseur possa alcançar o endpoint do webhook. O conector nativo do Parseur também está disponível no n8n Cloud.
Sim. O evento "Item de Tabela Processado" dispara um webhook separado para cada linha em um campo de tabela. Isso é útil caso você queira inserir cada item de uma nota fiscal ou fatura como um registro independente no banco de dados, ao invés de receber todas as linhas em um único array.
O Parseur suporta quatro tipos de eventos de webhook. "Documento Processado" dispara com o payload JSON completo quando um documento é extraído. "Tabelas Achatadas" envia dados de tabelas em um formato onde cada linha da tabela é um objeto separado. "Item de Tabela Processado" dispara separadamente para cada linha em um campo de tabela. "Exportação Falhou" dispara quando uma tentativa de entrega falha, útil para monitoramento de erros e alertas.
Sim. O Parseur permite adicionar cabeçalhos HTTP personalizados à requisição do webhook, incluindo um header de Authorization com token ou segredo compartilhado. Seu endpoint de recebimento pode validar cada requisição antes de processá-la. Essa é a abordagem recomendada para webhooks que escrevem em bancos de dados de produção ou disparam fluxos sensíveis.
Use um webhook ao conectar a um aplicativo personalizado, sistema interno proprietário ou banco de dados que não esteja disponível nas bibliotecas do Zapier ou Make. Webhooks dão total controle sobre como os dados são recebidos e manipulados. Se o destino for um app popular como Google Sheets, HubSpot ou Slack, Zapier ou Make são mais rápidos de configurar.
Sim. Ferramentas como webhook.site fornecem uma URL pública temporária que registra cada requisição recebida, permitindo inspecionar a estrutura do payload JSON antes de ligar ao seu sistema real. Reprocese um documento no Parseur após configurar o webhook para disparar uma entrega de teste.
Sim. O Parseur oferece uma API REST que permite enviar documentos programaticamente, recuperar resultados extraídos e gerenciar caixas de entrada. Webhooks são baseados em push (o Parseur chama seu endpoint), enquanto a API é baseada em pull (você consulta o endpoint do Parseur). A maioria das integrações em tempo real usa webhooks; a API é útil para fluxos em lote ou quando você deseja consultar resultados periodicamente.
