←Gerar documento (único)

Voltar ao guia principal: todos os tipos de modelos, parâmetros de nós e campos de saída.

Mala direta

O que este guia abrange

Este guia orienta você no processo de fusão de um modelo clássico de mala direta do Word em n8n usando simple_mail_merge_template.docx e sample_mail_merge_data.jsonO modelo utiliza o Word. MERGEFIELD espaços reservados (não <<[campo]>> ou bigode {{campo}}). Os dados são um JSON variedade com um objeto por destinatário. Para Gerar Documento (Único), use uma fileira na matriz. A saída pode ser PDF ou Word.

Artigos relacionados no blogue

Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.

Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.

Visite o blogue →

Antes de começar

Campos de mala direta do Word

A amostra simple_mail_merge_template.docx Foi criado com a ferramenta de mala direta do Word (Inserir Campo de Mesclagem). Os nomes dos campos são primeiro nome, sobrenome, gênero, e membroEles devem combinar. JSON exatamente as teclas.

JSON dados de matriz

Usar sample_mail_merge_data.json (recomendado), test.xml, ou test.csvOs dados de mala direta são um matriz de objetosPara um documento, cole uma matriz com um único objeto.

PDF4me credencial em n8n

Criar um PDF4me credencial em n8n e cole o seu API chave. A mesma chave funciona em todos os PDF4me nós em sua instância.

→ Obtenha o seu API chave

:::nota Mala Direta vs. Modelo do Word PDF4me Mala direta É para documentos do Word criados com campos de mala direta clássicos (MERGEFIELD). Modelo PDF4me Word usa <<[nomeDoCampo]>> Sintaxe LINQ em um formato regular .docxEscolha o tipo que corresponde à forma como seu modelo foi criado. Para vários destinatários em um só. API ligar, usar Gerar documentos (múltiplos) em vez de. :::

Pacote de Arquivos de Amostra

Faça o download dos quatro arquivos abaixo. Um modelo de mala direta em Word e três formatos de dados equivalentes.

simple_mail_merge_template.docx

Modelo de mala direta do Word (4 campos)

sample_mail_merge_data.json

JSON matriz com uma linha de destinatário (recomendado)

test.xml

Os mesmos dados do destinatário que XML

test.csv

Os mesmos dados do destinatário que CSV (uma linha)

O que há dentro dos arquivos de amostra?

Mesclar campos em simple_mail_merge_template.docx

O exemplo é simples. carta de adesão com quatro campos de mesclagem clássicos do Word:

Merge field name	Typical label in template	Sample value (sample_mail_merge_data.json)
firstname	Given name	John
lastname	Family name	Adams
gender	Gender	Female
member	Membership tier	Basic

:::dica Como inspecionar nomes de campos de mesclagem No Microsoft Word, pressione Alt+F9 para alternar os códigos de campo. Os campos de mala direta aparecem como { MERGEFIELD firstname } códigos de estilo. O nome depois MERGEFIELD deve corresponder ao seu JSON chave. :::

Mapeamento de campos em todos os arquivos de dados

Merge field	JSON key (sample_mail_merge_data.json)	XML element (test.xml)	CSV column (test.csv)	Sample value
firstname	firstname	firstname	firstname	John
lastname	lastname	lastname	lastname	Adams
gender	gender	gender	gender	Female
member	member	member	member	Basic

Ao contrário do modelo PDF4me Word, não há <<[campo]>> etiquetas. Ao contrário de HTMLNão existe sintaxe Mustache. O mecanismo vincula JSON chaves para nomes de Word MERGEFIELD um para um.

Visão geral do fluxo de trabalho

Manual Trigger  →  Read Binary File (simple_mail_merge_template.docx)  →  PDF4me Generate Document (Single)  →  (optional) Write Binary File

Etapa	n8n nó	Propósito
1	Gatilho manual	Inicie o fluxo de trabalho sob demanda
2	Ler arquivo binário	Cargas simple_mail_merge_template.docx em propriedade binária data
3	PDF4me → Gerar documento (único)	Mescla o modelo + JSON matriz, saídas PDF ou Word
4	Escrever arquivo binário ou Enviar e-mail (opcional)	Salva ou envia generated_document_output.pdf

Definir Tipo de arquivo de modelo para Mala direta. Escolher PDF ou Word para Tipo de saída.

---

Passo 1: Baixe e coloque os arquivos de exemplo.

1. Download simple_mail_merge_template.docx e sample_mail_merge_data.json do Pacote de Arquivos de Amostra acima.
2. Salve o modelo em algum lugar n8n É possível lê-lo (caminho local em servidores próprios ou armazenamento em nuvem para gatilhos de produção).
3. Opcionalmente, faça o download. test.xml ou test.csv para testar outros tipos de dados.

---

Passo 2: Crie o n8n Fluxo de trabalho

1. Em n8nCrie um novo fluxo de trabalho.
2. Adicionar um Gatilho manual nó.
3. Adicionar um Ler arquivo binário nó após o gatilho.
4. Adicionar PDF4me → Gerar documento (único) após ler o arquivo binário.
5. Conecte seu PDF4me credencial.

:::cuidado O código HTML não é válido aqui Tipo de entrada do arquivo de modelo: HTML Código só funciona quando Tipo de arquivo de modelo é HTMLPara mala direta, use Dados binários, Base64 Corda, ou URL. :::

---

Passo 3: Carregar o modelo do Word (Read Binary File)

Configure o Ler arquivo binário nó:

Campo	Valor
Caminho do arquivo	Caminho completo para o arquivo baixado. simple_mail_merge_template.docx
Nome da propriedade	data (padrão; usado como Propriedade binária do modelo em PDF4me)

Execute este nó uma vez e confirme se o item de saída mostra o valor binário. data com nome de arquivo simple_mail_merge_template.docx.

---

Etapa 4: Configurar PDF4me Gerar documento (único)

Configurações principais

Campo	Valor	Notas
Credencial para se conectar com	Seu PDF4me credencial	Pegar API chave
Recurso	Generate
Gerar operações	Gerar documento (único)
Tipo de arquivo de modelo	Mala direta	Modelo clássico do Word MERGEFIELD
Tipo de saída	PDF ou Word	PDF para compartilhar; Word se o destinatário precisar editar o documento mesclado

Entrada de modelo (de Ler arquivo binário)

Campo	Valor
Tipo de entrada de arquivo de modelo	Dados binários
Propriedade binária do modelo	data
Nome do arquivo de modelo	simple_mail_merge_template.docx

Dados do documento (cole o array JSON de sample_mail_merge_data.json)

Campo	Valor
Tipo de entrada de dados do documento	Texto
Tipo de dados do documento	JSON
Texto dos dados do documento	Cole o conteúdo completo de sample_mail_merge_data.json (ver bloco abaixo)

[
  {
    "firstname": "John",
    "lastname": "Adams",
    "gender": "Female",
    "member": "Basic"
  }
]

:::importante O JSON deve ser uma matriz Os dados de mala direta são um JSON variedade, mesmo para um único destinatário. Um objeto na matriz produz um documento mesclado com Gerar Documento (Único). :::

Opções de saída

Campo	Valor
Manter PDF Editável	Desativado (padrão) quando o Tipo de Saída é PDF
Nome da saída de dados binários	data (padrão)

---

Etapa 5: Execute e verifique o resultado

1. Clique Executar fluxo de trabalho.
2. Abra o PDF4me Saída do nó. Em Binário, propriedade aberta data (generated_document_output.pdf ou .docx).
3. Confirme se todos os quatro campos de mesclagem estão preenchidos:
   • primeiro nome → João
   • sobrenome → Adams
   • gênero → Feminino
   • membro → Básico

Se um campo estiver em branco, compare o seu JSON Chaves com os nomes MERGEFIELD no modelo do Word (Alt+F9 no Word).

---

Etapa 6: Salvar ou enviar a saída (opcional)

Escrever arquivo binário:

Campo	Valor
Nome do arquivo	mail-merge-output.pdf
Nome da propriedade de dados	data
Caminho de saída	Pasta de destino no seu n8n hospedar

Enviar e-mail: Anexe o binário data de PDF4me como o PDF ou Word anexo.

---

Formatos de dados alternativos

Opção A: JSON arquivo como binário (sample_mail_merge_data.json)

1. Adicionar Ler arquivo binário para sample_mail_merge_data.json (use um Fusão nó se o modelo e os dados compartilharem o item de fluxo de trabalho).
2. Definir Tipo de entrada de dados do documento para Dados binários, Tipo de dados do documento para JSON, Propriedade binária do documento para o seu campo de dados, Nome do arquivo de dados do documento para sample_mail_merge_data.json.

:::cuidado Conflito de nomes de propriedades binárias Se o modelo e os dados usarem a propriedade data, um sobrescreve o outro. Use nomes separados (por exemplo, template e mergeData) ou mesclar itens de dois nós de Leitura de Arquivo Binário. :::

Opção B: XML (test.xml)

Definir Tipo de dados do documento para XML e cole:

<?xml version="1.0" encoding="UTF-8"?>
<Person>
    <firstname>John</firstname>
    <lastname>Adams</lastname>
    <gender>Female</gender>
    <member>Basic</member>
</Person>

Os nomes dos elementos correspondem aos nomes dos campos de mesclagem e às chaves JSON.

Opção C: CSV (test.csv)

Definir Tipo de dados do documento para CSV e colar (linha de cabeçalho + uma linha de dados):

firstname,lastname,gender,member
"John","Adams","Female","Basic"

Os cabeçalhos das colunas correspondem diretamente aos nomes dos campos de mesclagem.

---

Entrada de modelo alternativo: URL

Hospedar simple_mail_merge_template.docx em público HTTPS URL, então defina:

Campo	Valor
Tipo de entrada de arquivo de modelo	URL
URL do arquivo de modelo	Link público para simple_mail_merge_template.docx
Nome do arquivo de modelo	simple_mail_merge_template.docx

Não é necessário nenhum nó de leitura de arquivo binário. Os dados ainda podem ser colados como Texto dos dados do documento ou carregado de um URL.

---

Padrões de fluxo de trabalho de produção

Formas comuns de executar mala direta em produçãoOnce the sample test works, replace the Manual Trigger with these patterns.

Planilhas do Google: linha por letra

1. As planilhas são acionadas na criação de uma nova linha.
2. Código ou Definir O nó envolve a linha em um JSON variedade: [{"primeiro nome": "...", ...}].
3. PDF4me Mala direta com correção simple_mail_merge_template.docx.
4. Envie por e-mail o arquivo mesclado PDF ao destinatário.

Formulário de registro de webhook

1. O webhook recebe a carga útil do formulário.
2. Mapear campos do corpo para mesclar chaves (primeiro nome, sobrenome, etc.).
3. Construa um item único JSON matriz para texto de dados do documento.
4. Armazene ou envie o resultado por e-mail. PDF.

Fusão em massa (vários destinatários)

1. Exportar contatos como um JSON matriz (um objeto por pessoa).
2. Mudar para Gerar documentos (múltiplos) por um PDF por linha.
3. Mantenha a opção Gerar Documento (Único) ativada quando precisar apenas de um arquivo mesclado por execução.

Perguntas frequentes

How is Mail Merge different from PDF4me Word Template?+

Mail Merge uses classic Word MERGEFIELD placeholders created in Word mail merge. PDF4me Word Template uses <<[fieldName]>> LINQ syntax in a regular .docx. Pick the type that matches how your template was authored. Data for Mail Merge is typically a JSON array.

Why must JSON be an array?+

Mail merge is designed for one or more recipient rows. Generate Document (Single) uses the first row when you pass one object in the array. Generate Documents (Multiple) processes every row and returns multiple output files.

Why is a merge field blank?+

JSON keys must match MERGEFIELD names exactly, including case. firstname works; FirstName or first_name usually does not. Toggle field codes in Word (Alt+F9) to read the internal name.

PDF or Word output?+

Choose PDF for emailing, archiving, or printing. Choose Word when the recipient needs to edit the merged document after generation. Both work with the same template and JSON array.

JSON vs XML vs CSV: which should I use?+

JSON arrays are the most natural fit for mail merge in n8n. XML and CSV in the sample pack carry the same four values for a single recipient. All formats map one value per merge field name.

Guias relacionados

• Visão geral da geração de documento (único): todos os parâmetros, campos de saída e tipos de modelo
• PDF4me Modelo do Word: <<[fieldName]>> sintaxe em vez de MERGEFIELD
• Gerar documentos (múltiplos): um arquivo de saída por linha em seu JSON variedade
• Blog sobre fluxo de trabalho de mala direta: padrão de ponta a ponta em Make

Back to overviewGenerate Documents (Multiple)