IA - Analisador de Documentos em Zapier

Q: Where do I build the Analyzer?

In the PDF4me developer dashboard at AI Document Parser. Two analyzer types: Parse (one schema, returns extracted fields) and Classify (many schemas, one per document variant, returns the matched Classification Name plus its fields). Once saved you pick the Analyzer from the AI Analyzer Id dropdown in this Zap action.

O que esta ação faz

PDF4me IA - Analisador de Documentos executa um salvo Analisador de IA do PDF4me O painel é aplicado a qualquer documento e retorna os dados extraídos de forma dinâmica. JSON Dentro de um Zap. Uma ação abrange faturas, pedidos de compra, recibos, contratos, formulários personalizados, relatórios de laboratório ou qualquer coisa que você descreva em um esquema. Selecione o Analisador na lista. ID do Analisador de IA Menu suspenso (Analisar para um único esquema, Classificar para várias variantes de documentos). Os campos aparecem como tokens mapeáveis individualmente em cada etapa subsequente, em mais de 6.000 opções. Zapier aplicativos.

Exemplo de fatura para testes

Use esta fatura de exemplo para confirmar se a ação funciona de ponta a ponta antes de direcionar seu Zap para dados reais. Faça o upload para o Dropbox, Google Drive ou qualquer outro serviço de armazenamento e mapeie o arquivo para... Arquivo, concatenar Nome do arquivo + Extensão do arquivo (por exemplo sample_invoice + .pdf), e escolha default_invoice_extraction do ID do Analisador de IA menu suspenso. A ação retorna um menu preenchido. Texto do documento JSON Você pode analisar o fluxo subsequente.

Recomendado

Exemplo de fatura (PDF)

Corresponde à captura de tela de configuração: mapa do Dropbox como exemplo_fatura.pdf e selecione extração de fatura padrão em ID do Analisador de IA.

exemplo_fatura.pdf

Alternar

Exemplo de fatura de fornecedor (PDF)

Mesmo embutido extração de fatura padrão Analisador. Use se você já seguiu o passo a passo do blog sobre como renomear recursos inteligentes do Dropbox.

exemplo-fatura-do-fornecedor.pdf

Autenticando seu API Solicitar

Para acessar o PDF4me Web API através ZapierCada ação do Zap precisa de um valor válido. PDF4me API chave no PDF4me Conexão. Obtenha ou gire sua chave no painel do desenvolvedor.

Get your API Key Open AI Document Parser Dashboard

Primeiro, configure seu analisador.

URLs do painel que irá utilizar neste guia:

Lista de analisadores (Etapas 1–2): https://dev.pdf4me.com/dashboard/#/ai-document-parser/
Detalhes do analisador (Etapas 3–5): https://dev.pdf4me.com/ai-document-parser/?id=<analyzer-guid>

Crie primeiro o seu Analyzer (obrigatório para todas as plataformas)

O AI - Document Parser executa um Analyzer guardado a partir do painel de controlo do programador do PDF4me. Selecione «Parse» para um esquema de documento ou «Classify» para encaminhar várias variantes (Cliente ABC, Cliente XYZ, fatura genérica) numa única chamada. O mesmo ID do Analyzer funciona no Make, no Zapier, no Power Automate, no n8n e na API REST.

Guia de configuração do Parse

Um esquema, extrair campos com fieldName, fieldType e fieldDescription.

Guia de configuração do Classify

Vários esquemas por analisador. Nome da classificação + prompt + esquema do documento por variante.

Fatos importantes que você não deve perder

O Analisador reside no PDF4me painel de controle, o Zap apenas faz referência a ele.

Defina o esquema (campos, tipos, descrições) uma única vez no Lista de analisadores e Detalhes do analisador páginas. As Zapier ação lê ID do Analisador de IA Selecione no menu suspenso qual analisador executar. Edite o esquema posteriormente e todos os Zaps que apontam para o mesmo ID o detectarão automaticamente, sem necessidade de recriar o Zap.

Arquivo OU URL do arquivo, não ambos.

Mapa Arquivo de uma etapa anterior (Dropbox / Google Drive / anexo do Gmail / Webhook) quando o documento já está em um aplicativo conectado. Use Arquivo URL quando o documento está hospedado em um local público HTTPS link. Configurar ambos é desnecessário; a ação prioriza Arquivo quando presente.

A decisão entre analisar ou classificar é tomada pelo analisador, não pela ação.

Mesma ação, dois modos de análise. Um Analisar O analisador retorna os campos de seu esquema único. Classificar O analisador encaminha o documento para o esquema mais adequado e retorna seu nome de classificação. mais Os campos extraídos do esquema correspondente. Alterne o comportamento alterando o ID.

Use o ID do Analisador de IA, não o nome do Analisador de IA (Obsoleto)

Zapier mostra ID do Analisador de IA como um menu suspenso de analisadores do seu PDF4me conta. A mais antiga Nome do analisador de IA O campo de texto está marcado. (Obsoleto)Deixe em branco e selecione o Analisador em ID do Analisador de IA.

Zapier PDF4me AI - Guia Configurar do Analisador de Documentos: Arquivo mapeado do Dropbox (etapa 2), URL do arquivo vazia, Nome do arquivo mapeado como sample_invoice + .pdf, Lista suspensa de ID do Analisador de IA definida como default_invoice_extraction e Nome do Analisador de IA Obsoleto (deixado em branco) — Aba Configurar: mapa **Arquivo** da etapa anterior, saia **URL do arquivo** vazio, construir **Nome do arquivo** A partir dos tokens Nome do Arquivo + Extensão do Arquivo, selecione **ID do Analisador de IA**e sair **Nome do Analisador de IA (Obsoleto)** vazio.

Parâmetros

URLs do painel que irá utilizar neste guia:

Lista de analisadores (Etapas 1–2): https://dev.pdf4me.com/dashboard/#/ai-document-parser/
Detalhes do analisador (Etapas 3–5): https://dev.pdf4me.com/ai-document-parser/?id=<analyzer-guid>

Necessário na ação: Arquivo OU Arquivo URL (um dos dois), Nome do arquivo (com extensão) e ID do Analisador de IA. Deixar Nome do Analisador de IA (Obsoleto) vazio.

Campo	Obrigatório	O que faz	Exemplo
File	Conditional	Binary file from a previous Zap step. Map a file token from Dropbox, Google Drive, OneDrive, Gmail attachment, Slack file, Webhooks by Zapier, or any connector that exposes a file output. Required when File URL is not provided. In the screenshot, step 2 File is mapped from Dropbox.	`2. File`
File URL	Conditional	Publicly reachable HTTPS URL to the document. Required when File is not provided. Use when the document lives on a public CDN, S3 bucket, or content host. Leave empty when File is mapped.	`https://example.com/document.pdf`
File Name	Yes	Source document filename with extension. Best practice is to concatenate the previous step File Name and File Ext tokens (for example sample_invoice + .pdf becomes sample_invoice.pdf).	`sample_invoice.pdf`
AI Analyzer Id	Yes	Dropdown of Analyzers saved in your PDF4me account. Create Analyzers at `https://dev.pdf4me.com/dashboard/#/ai-document-parser/` (+ Add), then edit schemas on `https://dev.pdf4me.com/ai-document-parser/?id=<analyzer-guid>`. Sent to the API as `customisationNote`. Pick Parse for one schema or Classify for many variants.	`default_invoice_extraction`
AI Analyzer Name (Deprecated)	No	Legacy free-text field. Zapier marks this as deprecated. Leave empty and use AI Analyzer Id instead.	`-`

ID do Analisador de IA: como os IDs dos Analisadores se relacionam com o comportamento

ID do analisador de análiseUm esquema extrai os campos que você definiu.

O ideal é que todos os documentos processados compartilhem a mesma família de layout. Saída JSON Contém exatamente as propriedades que você descreveu em campos no analisador, incluindo mesa matrizes para itens de linha.

ID do Analisador de ClassificaçãoVários esquemas, rotas e extrações em uma única chamada.

Ideal para quando um único Zap precisa lidar com diversas variantes (Cliente ABC, Cliente XYZ, fatura genérica). A IA compara o documento recebido com o esquema mais adequado por meio de sua solicitação de classificação e, em seguida, retorna o nome da classificação correspondente, além dos campos extraídos desse esquema.

extração de fatura padrãoModelo de fatura integrado

Um analisador pronto para uso para faturas de fornecedores típicas. Escolha esta opção quando precisar extrair faturas imediatamente, sem criar um esquema personalizado. Utilize um analisador Parse personalizado quando precisar de campos específicos, lógica de fornecedor ou colunas de tabela que o padrão não abrange.

Saída

A ação retorna dinamicamente. JSONCada propriedade definida no seu esquema do Analyzer aparece em ZapierO resultado do teste é um token mapeável individualmente em cada etapa subsequente. O formato exato depende do seu analisador:

Chaves de nível superior combinar com fieldName valores em seu esquema (string, número, data ou table matrizes para itens de linha).
Analisadores de classificação Retorna também o nome da classificação correspondente para que você possa ramificar a partir daí o esquema correspondente.
Nenhum arquivo binário é retornado, o analisador de IA é um JSON- única ação.

Alguns nomes de tokens comuns que você provavelmente verá, dependendo do esquema:

Token	Tipo	Conteúdo típico
`invoiceNumber`	Corda	Número da fatura/conta/recibo
`invoiceDate`	Data	Data normalizada (quando) `fieldMethod: "generate"` está definido)
`vendorName`	Corda	Nome do fornecedor ou vendedor retirado do cabeçalho
`totalAmount`	Número	Total geral na moeda do documento
`lineItems`	Variedade	Dados de linha repetidos (um objeto por linha, campos que você descreveu no aninhamento) `fields` variedade)

Configuração rápida

Primeiro, construa seu analisador. Abra o Lista de analisadores, clique + AdicionarDigite um ID de analisador claro e selecione Analisar ou ClassificarSalve a linha e, em seguida, adicione um esquema de documento ao Detalhes do analisador página. Veja a Guia de configuração do Parse ou Guia de configuração do Classify para regras de esquema completas (incluindo fieldType: "table" para linhas aninhadas e fieldMethod: "generate" para valores derivados).
No seu clique do Zap +, procurar PDF4me, escolha IA - Analisador de Documentos.
Conecte ou reutilize seu PDF4me conta.
Mapa Arquivo de uma etapa anterior (anexo do Dropbox / Google Drive / Gmail / Webhook), ou colar um público HTTPS link para Arquivo URL.
Mapa Nome do arquivo aos tokens de nome de arquivo da etapa anterior (concatenar) Nome do arquivo + Extensão do arquivo (manter o nome original com a extensão correta).
De ID do Analisador de IA escolha seu analisador (por exemplo default_invoice_extraction, client_invoices(ou um analisador Parse ou Classify personalizado). Sair Nome do Analisador de IA (Obsoleto) vazio.
Clique Ação de testeInspecione o produto devolvido. JSON no Zapier Painel de teste.
Mapeie os campos retornados para a próxima ação (Criar linha no Planilhas Google, Criar registro no Airtable, Enviar e-mail no Gmail, Enviar mensagem no canal do Slack ou qualquer uma das mais de 6.000 opções). Zapier aplicativos).

Exemplos de fluxo de trabalho

Exemplos de fluxo de trabalhoOpen by default. Four common AI - Document Parser patterns inside Zaps.

Faturas de fornecedores para o Google Sheets

Gatilho: Gmail Novo anexo na caixa de entrada da AP.
IA - Analisador de Documentos com Arquivo mapeado a partir do anexo, Nome do Arquivo a partir de tokens do Gmail, ID do Analisador de IA extração de fatura padrão (ou seu analisador de análise personalizado).
Planilhas Google Criar linhaMapear InvoiceNumber, VendorName, TotalAmount, InvoiceDate no rastreador de contas a pagar.
Opcional: Slack Enviar mensagem no canal Para #finanças com valores que garantam visibilidade.

Impacto: Recebimento automático de contas a pagar de qualquer fornecedor.

Caixa de entrada com vários fornecedores e sistema de classificação.

Gatilho: Dropbox Novo arquivo na pasta em uma pasta de fornecedores mistos.
IA - Analisador de Documentos com ID de Analisador de IA apontando para um Analisador de Classificação (faturas_de_clientes) que contém um esquema por fornecedor.
Zapier Caminhos O Airtable ramifica-se com base no nome de classificação retornado e envia cada resultado para a base correspondente.

Impacto: Um único Zap gerencia todos os clientes sem fluxos separados.

Documento hospedado por URL

Gatilho: Webhooks por Zapier Gancho de pesca Recebe um link para um documento do seu portal.
IA - Analisador de Documentos com Arquivo URL Defina o link e o ID do Analisador de IA para o seu analisador de formulário personalizado.
Airtable Criar registro Com campos mapeados, cria-se um contato no CRM.

Impacto: Os formulários enviados pelo portal se tornam dados de CRM sem necessidade de entrada manual.

Renomear e arquivar arquivos de forma inteligente

Gatilho: Novo arquivo no Dropbox caixa de entrada.
AI - Document Parser retorna vendorName e invoiceNumber do esquema.
Dropbox Mover arquivo para arquivo/{{vendorName}} e renomear para {{vendorName}}_{{invoiceNumber}}.pdf.

Impacto: Arquivo limpo e pesquisável, sem qualquer intervenção manual.

Perguntas frequentes

What is the difference between AI - Document Parser and AI-Invoice Parser?+

AI-Invoice Parser uses a fixed schema tuned for invoices (vendor, line items, totals, dates). AI - Document Parser is schema-driven: it runs whatever Analyzer you pick from AI Analyzer Id, built once in the PDF4me dashboard. The same action handles purchase orders, receipts, contracts, custom forms, lab reports, ID cards, or anything else you describe in a schema. Pick AI - Document Parser whenever you need flexibility or a non-invoice document type.

Where do I build the Analyzer?+

At https://dev.pdf4me.com/dashboard/#/ai-document-parser/ (Analyzer list, + Add) and https://dev.pdf4me.com/ai-document-parser/?id=<analyzer-guid> (Analyzer detail for schemas). Two analyzer types: Parse (one schema) and Classify (many variants). Pick the Analyzer from the AI Analyzer Id dropdown in Zapier.

What happened to AI Analyzer Name?+

AI Analyzer Name is deprecated in Zapier. Use the AI Analyzer Id dropdown instead. Leave the deprecated text field empty.

Should I provide File or File URL?+

Provide one or the other. Map File from a previous Dropbox / Google Drive / Gmail / Webhook step when the document lives inside another connected app. Use File URL when the document is hosted at a public HTTPS link. Setting both is unnecessary; the action prefers File when present.

What format is the output and how do I map fields downstream?+

The response is dynamic JSON with one property per field defined in your Analyzer schema (for example customerName, invoiceNumber, totalAmount, lineItems). Zapier exposes those properties in the Test result of this step. Pick the matching property from the dynamic dropdown in any downstream action.

Which file types does the action accept?+

PDF, PNG, JPG, and JPEG. The AI engine handles OCR internally, so scanned PDFs and image formats work the same as native PDFs.

What does default_invoice_extraction give me?+

A built-in Analyzer for typical vendor invoices. Pick it when you need invoice extraction immediately without building a custom schema. Move to your own Parse Analyzer when you need specific fields, vendor logic, or table columns the default does not cover.

Can one Zap process several document variants in one run?+

Yes, with a Classify Analyzer. Build one Classify Analyzer in the dashboard with one Schema per variant (Client ABC, Client XYZ, generic invoice). The AI picks the best-matching Schema at runtime and the action returns its fields plus the Classification Name. Use a Zapier Paths step to branch on the Classification Name and send each variant to the right downstream app.

Will the same Analyzer work from Make, Power Automate, n8n, or the REST API?+

Yes. The Analyzer Id is shared across every platform. Save it once in the dashboard and call it from Zapier, Make, Power Automate, n8n, or the REST API by passing the same Id. Schema changes propagate to every platform without rewiring.