Pular para o conteúdo principal
API PDF4meIntegraçõesBase de conhecimentoExtensõesTestador de APIBlog

Classificação de Documentos em Zapier

Classificar documento é um Zapier ação por PDF4me que combina PDF conteúdo em relação a regex ou JavaScript As regras que você define em dev.pdf4me.com retornam o nome da classe correspondente. Use-o para encaminhar faturas, contratos e recibos para a pasta ou ramificação de fluxo de trabalho correta, sem necessidade de aprendizado de máquina ou dados de treinamento.

Artigos relacionados no blogue(1)

O que esta ação faz

PDF4me Classificar documento leva um PDF e retorna o Nome da turma que corresponda às regras que você criou previamente, dentro de um Zap. Defina classes como pdf4me_fatura com uma expressão regular como fatura(.*) no PDF4me painel, depois use o nome da classe retornado em um Filtrar, caminhos, carregar arquivo, Planilhas Google ou Airtable. Passo a passo para classificar documentos por tipo sem escrever ou treinar um classificador.

Autenticando seu API Solicitar​

Para acessar o PDF4me Web API através ZapierCada solicitação deve incluir credenciais de autenticação adequadas.

Get your API Key

Fatos importantes que você não deve perder​

As aulas estão disponíveis em dev.pdf4me.com, não em Zapier
Criar e editar classes (Nome da Classe mais uma Expressão Regular ou JavaScript padrão) no Painel de controle de classificação de documentos primeiro. O Zapier a ação avalia apenas um PDF contra quaisquer classes já existentes em sua conta.
Baseado em regras, não em aprendizado de máquina.
Ao contrário dos classificadores de aprendizado de máquina que precisam de dados de treinamento rotulados e uma taxonomia fixa, esta ação compara o conteúdo com uma expressão regular ou JavaScript Expressão que você escreve. Sem simulações de treinamento, sem limites de confiança para ajustar, você controla exatamente qual texto identifica cada classe.
Somente o arquivo é necessário.
O nome do arquivo é opcional e usado apenas para identificação. A ação não retorna nem altera o arquivo. PDF Em si, continue usando a referência de arquivo original do seu gatilho para qualquer etapa subsequente.
Painel de configuração da ação Classificar Documento do Zapier, mostrando o arquivo mapeado a partir do gatilho e o nome do arquivo, formado pelo nome do arquivo mais a extensão do arquivo.

Configurar painel de ações: O campo Arquivo é obrigatório, o campo Nome do arquivo é opcional e é gerado a partir do nome e extensão do arquivo do gatilho.

Parâmetros​

Requerido no Zapier UI: Arquivo. O nome do arquivo é opcional.

ParâmetroObrigatórioO que fazExemplo
FileRequiredThe PDF file to classify. Map from your trigger (for example File from New File in Folder) or a previous step.1. File
File NameOptionalName of the PDF for identification in the response. Typically built from the trigger's File Name plus File Ext.document.pdf
Criando uma classe
No Painel de controle de classificação de documentos, clique em Editar e adicione um nome de classe (por exemplo, pdf4me_fatura), escolha Expressão Regular ou JavaScripte insira um padrão como fatura(.*)Clique em Salvar alterações antes de testar. Zapier.

Saída​

CampoTipoO que contém
Trace IdStringUnique identifier for the request, useful for support and debugging.
Class NamesStringThe matched class (for example pdf4me_invoice or Invoice). Empty or unmatched if no saved class matched the content. Use in a Filter, Paths, or file-naming step.

Como faço para configurar a classificação de documentos em Zapier?​

  1. Sobre dev.pdf4me.com, abrir Classificar documento e adicione uma classe (Nome da Classe mais uma Expressão Regular ou JavaScript padrão), depois clique Salvar alterações.
  2. No seu Zap, adicione PDF4me como o aplicativo de ação e escolha Classificar documento.
  3. Conecte seu PDF4me Crie uma conta ou selecione uma conexão existente.
  4. Mapa Arquivo a partir do seu gatilho ou de uma etapa anterior. Opcionalmente, mapeie. Nome do arquivo.
  5. Teste a etapa e confirme. Nomes das turmas Retorna a classe esperada.
  6. Usar Nomes das turmas em um Filtro ou Caminhos passo para ramificar seu Zap, ou em Carregar arquivo Para nomear a saída por tipo de documento.

Quando devo usar a classificação baseada em regras em vez de um classificador de aprendizado de máquina?​

Escolha a opção Classificar Documento quando seus tipos de documento forem identificáveis por uma frase, cabeçalho ou padrão de ID consistente (um formato de número de fatura, um título de contrato fixo, um código de formulário conhecido) e você quiser um resultado imediato, sem fase de treinamento. Escolha um classificador de aprendizado de máquina, como o Google Cloud Natural Language ou o Amazon Comprehend, quando as categorias forem imprecisas, o conteúdo variar muito em termos de redação ou você já tiver um conjunto de dados rotulado para treinamento.

Configurações típicas​

Exemplos de fluxo de trabalhoCommon Zapier patterns using Classify Document.
Direcione faturas e contratos para pastas diferentes.
  1. Um gatilho para Novo Arquivo na Pasta (Dropbox, Google Drive, SharePoint) dispara em um novo PDF.
  2. Classificar documentos mapeando Arquivo e Nome do Arquivo, retornando Nomes de Classe.
  3. Uma etapa do Paths se ramifica em nomes de classe: a fatura segue um caminho, o contrato outro.
  4. A opção "Carregar Arquivo" salva cada ramo em sua própria pasta (Contabilidade/Faturas, Jurídico/Contratos).
Classifique primeiro e, em seguida, analise com o modelo correspondente.
  1. Um gatilho "Novo Arquivo na Pasta" é acionado quando um arquivo é recebido. PDF.
  2. A função Classificar Documento retorna os nomes das classes do documento.
  3. Uma etapa Paths executa a análise do documento com o modelo de fatura quando Class Names for invoice (fatura), ou com o modelo de recibo quando for receipt (recibo).
  4. Cada caminho mapeia os campos extraídos para sua respectiva etapa subsequente.
Adicione o prefixo da classe detectada aos nomes dos arquivos.
  1. Um gatilho "Novo Arquivo na Pasta" é acionado quando um arquivo é recebido. PDF.
  2. A função Classificar Documento retorna os nomes das classes do documento.
  3. O recurso "Carregar Arquivo" utiliza o arquivo original do gatilho e define "Especificar Nome do Arquivo" como "Nomes de Classe" mais um sublinhado e o nome do arquivo original.

Dicas práticas​

Test your regex on dev.pdf4me.com before wiring the Zap
Save Changes only commits a class once its pattern actually matches sample content. Confirm the class works in the dashboard test panel first, then map File in Zapier.
Always handle the unmatched case
Class Names comes back empty or unmatched when no saved class fits, this is not an error. Add a default Paths branch or a catch-all Filter so unclassified documents still land somewhere reviewable.
Keep patterns specific to avoid false matches
A broad regex like invoice(.*) can also match a contract that happens to mention the word invoice. Anchor patterns to consistent headers, ID formats, or fixed phrases unique to each document type.
The action does not return the PDF itself
Only Class Names and Trace Id come back. Keep referencing the original File from your trigger for any follow-up step like Upload File or Parse Document.
JavaScript expressions unlock logic regex cannot
For classification rules that need more than pattern matching, for example combining two conditions, use a JavaScript expression class instead of a Regular Expression class.

Folha de dicas​

CampoValor
ActionClassify Document
Classes defined atdev.pdf4me.com Classify Document dashboard
FileRequired, from trigger or previous step
File NameOptional
OutputTrace Id, Class Names
Unmatched resultEmpty/unmatched Class Names, not an error
Credits1 credit per classification run

Perguntas frequentes​

How is this different from AI or machine-learning document classification?+
Services like <a href="https://cloud.google.com/natural-language/docs/classifying-text" target="_blank" rel="noopener noreferrer">Google Cloud Natural Language</a> and <a href="https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ClassifyDocument.html" target="_blank" rel="noopener noreferrer">Amazon Comprehend</a> classify text with trained machine-learning models and a predefined category taxonomy. PDF4me Classify Document instead matches PDF content against a regex or JavaScript rule you write and store on dev.pdf4me.com. There is no model training, no taxonomy to adopt, and no confidence score to tune, you decide exactly what pattern identifies each document type.
Where do I create document classes?+
Classes are created and stored in your PDF4me account, not inside Zapier. Open the Classify Document dashboard on dev.pdf4me.com, add a Class Name with a Regular Expression or JavaScript pattern, and click Save Changes. The Zapier action only evaluates a PDF against classes that already exist in your account.
What does the action return if no class matches?+
Class Names comes back empty or unmatched rather than throwing an error when the PDF content does not match any saved expression. Route this case through a Filter or a default Paths branch so unclassified documents still land somewhere reviewable instead of silently disappearing from the workflow.
Can I classify a document without sending the PDF content again in the next step?+
Yes. Classify Document returns only Class Names and Trace Id, it does not return or modify the PDF file itself. Keep referencing the File field from your trigger or an earlier step for any follow-up action such as Upload File, Parse Document, or an email attachment.

Ações relacionadas​

Casos de uso e aplicações industriais​

  • Roteamento de faturasEncaminhar faturas por classe (por exemplo, correspondência de expressão regular com "fatura") para o fluxo de trabalho de Contas a Pagar.
  • Processamento de RecibosIdentificar recibos para gestão de despesas usando padrões de expressão
  • Classificação de documentosOrganize os documentos financeiros por tipo, utilizando suas regras de classificação.

Obtenha ajuda​

Zapier IntegrationGet your API KeySet Up Classify Document (classification setup)Zapier Documentation