Where do I define the classification rules?

Classification rules: class names and their regex or JavaScript expressions: are created and stored in your PDF4me account at dev.pdf4me.com under Classify Document. The Make module reads those rules at runtime. You must set up at least one class before the module can return a result.

What does the module return?

The module returns two fields: Class Name (the matched class label, e.g. pdf4me_invoice or Contract) and Trace Id (a unique identifier for debugging). It does NOT return the PDF file. To pass the PDF to downstream modules, use the Document output from the prior download or trigger step.

What expression types can I use to define a class?

Two types are supported: Regular Expression and JavaScript. Regular expressions match text patterns found anywhere in the document content: for example, invoice(.*) matches any PDF containing the word invoice. JavaScript expressions let you write more complex matching logic for multi-condition or scored classification.

What happens if the PDF does not match any class?

If no class expression matches the document content, the module returns an empty or unmatched Class Name. Handle this case in your Router by adding a fallback branch for documents that could not be classified: for example, routing them to a manual review folder.

Classificar documento em Make

Q: Does each classification run use a credit?

Yes. Each Classify Document module run consumes one PDF4me credit regardless of whether a match is found. For high-volume scenarios processing hundreds of PDFs daily, plan your credit allocation accordingly.

O que este módulo faz

PDF4meClassificar documento lê um PDF e retorna um Nome da turma que identifica o tipo de documento: fatura, contrato, recibo ou qualquer classe personalizada que você definir. Regras de classificação (expressões regulares ou JavaScript expressões) são configuradas uma vez em seu PDF4me conta em dev.pdf4me.com. Quando um PDF passa pelo módulo em Make, é comparado com essas regras e o rótulo da classe vencedora é retornado. Alimente esse rótulo em um Make O roteador envia o documento para a pasta correta, seleciona o modelo de análise adequado ou aciona uma ação subsequente específica do tipo, tudo isso sem qualquer classificação manual.

Autenticando seu API Solicitar

Todo PDF4me módulo em Make requer um válido ConexãoCrie ou selecione um que contenha o seu PDF4me API chave para que o cenário possa autenticar solicitações de classificação com segurança.

Get your API Key

Fatos importantes que você não deve perder

Defina as classes primeiro na sua conta, não no Make.

As regras de classificação estão no seu PDF4me painel em dev.pdf4me.com → Classificar DocumentoAdicione um nome de classe (por exemplo, pdf4me_fatura) e uma expressão regular ou JavaScript expressão (ex.: fatura(.*)), depois clique em Salvar alterações. Make Este módulo não possui campos para definir regras; ele apenas aplica as regras que você salvou em sua conta.

O módulo retorna apenas o nome da classe, não o PDF

A função Classificar Documento gera dois campos: Nome da turma (o rótulo correspondente) e ID de rastreamento (para depuração). Não retorna nem modifica o PDF arquivo. Se você precisar passar o PDF para um módulo subsequente, faça o upload, analise ou envie por e-mail, mapeie a saída do documento do anterior Faça o download ou acione a etapa, não a partir deste módulo.

Um crédito consumido por execução de classificação.

Cada execução do módulo Classificar Documento utiliza um PDF4me crédito, independentemente de haver ou não uma correspondência de classe. Para cenários que processam grandes volumes de documentos (centenas ou milhares de PDFs diariamente), planeje sua alocação de crédito no PDF4me Painel de controle antes de habilitar o cenário em escala. Adicione uma ramificação de fallback do roteador para documentos não correspondentes para evitar falhas silenciosas.

Crie o módulo Classificar Documento do PDF4me mostrando a Conexão definida como Minha conexão do PDF4me, o Nome do Arquivo mapeado a partir do nome do arquivo da etapa 1 e o Documento mapeado a partir dos dados da etapa 1. — O módulo precisa apenas do nome do arquivo e do documento de uma etapa de download anterior. As regras de classificação são lidas do seu arquivo. PDF4me conta automaticamente, sem configuração de regras interna Make.

Parâmetros

Pré-requisito: Crie pelo menos uma classe de documento em dev.pdf4me.com → Classificar Documento Antes de usar este módulo, consulte [link para a documentação]. Configurar e classificar documento Para o passo a passo completo.

Parâmetro	Obrigatório	O que faz	Exemplo
Connection	Yes	PDF4me API connection. Click Add and paste your API key if connecting for the first time.	`My PDF4me connection`
File Name	Yes	Filename of the PDF to classify including .pdf extension. Map from the prior module's file name output.	`document.pdf`
Document	Yes	Binary content of the PDF to classify. Map from the prior module's data output: Dropbox, Google Drive, HTTP, or email attachment.	`1. Data`

Campos de saída

Campo	Descrição
Nome da turma	O rótulo da classe correspondente (por exemplo, `pdf4me_invoice`, `Contract`Use isso no seu roteador ou na etapa de renomeação.
ID de rastreamento	Identificador único para esta execução de classificação, útil para depuração ou registro de auditoria.

Configuração rápida

Vá para dev.pdf4me.com → Classificar Documento, clique Editar, adicione um nome de classe (por exemplo, pdf4me_invoice) com uma expressão regular (por exemplo, invoice(.*)), e clique Salvar alterações.
Em seu Make cenário, adicione PDF4me → Classificar documento após a etapa de download do arquivo.
Selecione Conexão (ou clique) Adicionar para criar um com o seu PDF4me API chave).
Mapa Nome do arquivo e Documento do módulo de download ou gatilho anterior.
Clique Salvar e execute o cenário. O Nome da turma A saída contém o tipo de documento correspondente: conecte-o a um Roteador Para criar ramificações por tipo, um módulo de upload para salvar em uma pasta específica do tipo ou uma etapa de renomeação para prefixar o nome do arquivo com a classe.

Exemplos de fluxo de trabalho

Exemplos de fluxo de trabalhoCommon Make scenario patterns using Classify Document.

Encaminhe faturas, contratos e recibos para pastas separadas.

A pasta de monitoramento do Dropbox é acionada quando uma nova pasta é adicionada. PDF Aparece em uma pasta "Entrada".
O recurso "Baixar um arquivo" do Dropbox recupera o PDF binário.
A função Classificar Documento retorna o Nome da Classe, por exemplo. pdf4me_fatura, contrato_pdf4me, ou recibo_pdf4me.
O roteador ramifica-se com base no nome da classe: invoice → /Contabilidade/Faturas/, contrato → /Legal/Contratos/, recibo → /Finanças/Recibos/.
Cada filial carrega o PDF (da etapa de download, não da etapa de classificação) para a pasta de destino. O Slack notifica a equipe responsável.

Classifique e, em seguida, analise com o modelo correto.

O recurso de monitoramento de e-mail é acionado quando um PDF O anexo chega à caixa de entrada da conta.
A opção "Classificar Documento" identifica se o documento é uma fatura, uma ordem de compra ou uma nota de entrega.
O roteador cria ramificações com base no nome da classe e executa o módulo Parse Document correspondente: modelo de fatura para faturas e modelo de pedido de compra para pedidos de compra.
Os dados extraídos (total, fornecedor, data) são gravados em uma linha do Google Sheets para cada tipo de documento.
Um dos cenários processa qualquer tipo de documento, sem necessidade de classificação manual antes do processamento.

Renomear arquivos automaticamente por tipo de documento ao chegarem.

O recurso "Monitorar arquivos" do Google Drive é acionado quando um novo arquivo é adicionado. PDF é carregado em uma pasta compartilhada "Documentos".
O recurso "Obter um arquivo" do Google Drive baixa o arquivo binário.
A função Classificar Documento retorna o Nome da Classe, por exemplo. contrato_pdf4me.
O recurso "Carregar um arquivo" do Google Drive salva novamente o arquivo. PDF com um nome de arquivo prefixado: Nome da classe + sublinhado + nome original (por exemplo, pdf4me_contrato_NDA_2025.pdf).
O arquivo original, sem nome, foi movido para uma subpasta de arquivo para fins de referência.

Perguntas frequentes

Where do I create and manage classification rules?+

Rules are created at dev.pdf4me.com under the Classify Document section: not inside Make. Click Edit, add a Class Name and an expression (Regular Expression or JavaScript), then click Save Changes. The Make module automatically reads all saved classes from your account each time it runs. See the Set Up Classify Document guide for screenshots and full walkthrough.

What expression types are supported for defining a class?+

Two types: Regular Expression and JavaScript. Regex expressions match text patterns found anywhere in the PDF text content: for example, invoice(.*) matches any document containing the word "invoice". JavaScript expressions let you write more complex logic: multiple conditions, scored matching, or length-based rules, for documents where a single regex is insufficient.

What does the module output: does it return the PDF?+

No. The module outputs two text fields: Class Name (the matched class label, e.g. pdf4me_invoice) and Trace Id (a unique run identifier for debugging). The PDF itself is not returned. To pass the document to a downstream upload, email, or parse module, map the Document field from the prior download or trigger step: not from Classify Document.

What happens when no class expression matches the document?+

When no expression matches, the Class Name output is empty or contains an unmatched indicator. Add a fallback branch to your Router that handles empty Class Names: for example, route unclassified documents to a "Manual Review" folder and send a Slack alert. This prevents unmatched PDFs from being silently dropped or misrouted.

How many credits does each classification use?+

One credit per module execution, regardless of whether a match is found. For high-volume scenarios: processing hundreds of PDFs daily, estimate your monthly credit consumption before enabling at scale. Use the PDF4me dashboard to monitor usage and set up credit alerts if needed.