Integrações com Make e Zapier

Antes de conectar

Você precisa de uma conta de cliente do PDFgine, um modelo nesse espaço de trabalho, cota de páginas disponível e uma conta no Make ou Zapier. Primeiro crie seu modelo e anote o Template Code.

O aplicativo do Make está em análise para o catálogo. A integração do Zapier é privada. Entre em contato com o PDFgine para obter acesso; nenhuma das integrações está listada publicamente ainda.

Solicitar acesso à integração

Conecte seu espaço de trabalho

Crie uma chave de API exclusiva na sua conta do PDFgine com usage:read e documents:render. Use a URL da API hospedada abaixo. Adicione templates:read somente se usar o seletor opcional Brand Kit nas prévias.

https://api.pdfgine.com · usage:read · documents:render

O seletor Locale do conector oferece inglês e turco no momento. O idioma do site não altera os dados do documento nem os campos disponíveis no conector.

Configure um cenário no Make

1. Aceite o acesso ao aplicativo privado fornecido pelo PDFgine. Adicione um módulo PDFgine ao cenário e crie uma conexão com sua URL da API e uma chave de API exclusiva.
2. Escolha Create a Document, configure Template Code e Format e mapeie os valores do módulo anterior no objeto JSON de Template Data. Use Queue a Document para trabalhos assíncronos ou Create a Public Preview para um link destinado ao destinatário.
3. Execute Run once com dados de exemplo e confira o resultado do módulo e o documento gerado. Ative o agendamento somente quando o mapeamento estiver correto. Make an API call aceita caminhos relativos autorizados da API; os escopos da conexão continuam se aplicando.

Configure um Zap

1. Aceite o convite para a integração privada do PDFgine na sua conta do Zapier. Escolha seu gatilho, adicione uma ação do PDFgine e conecte com sua URL da API e uma chave de API exclusiva.
2. Para Create Document, configure Template Code e Format e mapeie os dados do gatilho em Template Data como JSON válido. Queue Document e Create Public Preview são ações separadas. Brand Kits é uma fonte opcional de lista suspensa, não um gatilho.
3. Teste a ação, publique o Zap e envie um novo evento de gatilho. Confirme uma execução bem-sucedida no Zap History e confira o documento desse evento; um Test Step no editor, por si só, não comprova que o fluxo ativo foi executado.

Mapeie valores reais e mantenha o JSON válido

Template Data deve ser um objeto JSON correspondente aos campos do modelo, não um caminho de arquivo ou um marcador vazio. O exemplo abaixo é para um modelo de proposta. Mapeie nomes e valores do gatilho, mantenha valores numéricos como números e verifique os totais calculados antes de enviar.

{
  "document": { "title": "DEMO ONLY" },
  "referenceNo": "DEMO-001",
  "issueDate": "2026-10-27",
  "currency": "USD",
  "customer": "Demo Customer",
  "quoteItems": [
    { "name": "Demo service", "quantity": 2, "unitPrice": 50, "total": 100 }
  ],
  "subtotal": 100,
  "vatAmount": 20,
  "grandTotal": 120
}

Escolha a saída certa

Create Document retorna uma downloadUrl protegida que exige autenticação da API. Para um link que o cliente possa abrir no navegador, use Create Public Preview e escolha uma duração de acesso permitida. Queue Document retorna uma statusUrl do trabalho; uma resposta na fila não é um documento concluído.

Renderização na fila · Links de prévia

Teste antes de ativar

Use primeiro dados fictícios de clientes. Confira o destinatário, a referência, os itens, os totais e o formato de saída. Após ativar o fluxo, envie um novo evento e verifique o histórico de execução da plataforma. Evite execuções de produção repetidas: as páginas geradas consomem sua cota do PDFgine.

Limites e solução de problemas

Para 401 ou 403, confira a conexão e os escopos da API. Para 402, confira a cota disponível. Para 429, respeite Retry-After e reduza a frequência das requisições. Corrija o JSON ou os dados do modelo inválidos antes de tentar novamente. A duração da prévia e os limites de geração dependem do plano.

Erros · Consultar sua cota

Mantenha as chaves de conexão privadas

Insira sua chave de API apenas nas configurações de conexão da plataforma. Não a coloque em Template Data, capturas de tela ou registros de execução compartilhados. Use uma chave separada para cada conexão e revogue-a no PDFgine quando o acesso não for mais necessário.

Precisa de eventos de documentos? Consulte o guia de webhooks da API. Webhooks