Skip to main content
Gere automaticamente ou obtenha um PDF e anexe-o a um registo no Twenty. Isto é normalmente utilizado para criar orçamentos, faturas ou relatórios que estão associados a Empresas, Oportunidades ou outros objetos.

Visão Geral

Este fluxo de trabalho utiliza um Gatilho Manual para que os utilizadores possam gerar um PDF a pedido para qualquer registo selecionado. Uma Função lógica trata de:
  1. Transferir o PDF a partir de um URL (de um serviço de geração de PDF)
  2. Carregar o ficheiro para o Twenty
  3. Criar um Anexo ligado ao registo

Pré-requisitos

Antes de configurar o fluxo de trabalho:
  1. Crie uma Chave de API: Vá a Definições → APIs e crie uma nova chave de API. Você precisará deste token para a função lógica.
  2. Configure um serviço de geração de PDF (opcional): Se quiser gerar PDFs dinamicamente (por exemplo, orçamentos), utilize um serviço como o Carbone, o PDFMonkey ou o DocuSeal para criar o PDF e obter um URL de transferência.

Configuração passo a passo

Etapa 1: Configurar o gatilho

  1. Vá a Fluxos de Trabalho e crie um novo fluxo de trabalho
  2. Selecione Gatilho Manual
  3. Escolha o objeto ao qual pretende anexar PDFs (por exemplo, Empresa ou Oportunidade)
Com um disparador Manual usuários podem executar este fluxo de trabalho usando um botão que aparece no topo direito, depois que um registro é selecionado — isso executa o fluxo de trabalho para gerar e anexar um PDF.

Passo 2: Adicionar uma Função lógica

  1. Adicionar uma ação Código (função lógica)
  2. Crie uma nova função com o código abaixo
  3. Configure os parâmetros de entrada

Parâmetros de Entrada

Se estiver a anexar a um objeto diferente (Pessoa, Oportunidade, etc.), renomeie o parâmetro em conformidade (por exemplo, personId, opportunityId) e atualize a função lógica.

Código da Função lógica

Passo 3: Personalizar para o seu caso de utilização

Para anexar a um objeto diferente

Substitua targetCompanyId pelo campo apropriado: Atualize tanto o parâmetro da função como o objeto variables.data na mutação de anexo.

Para utilizar um URL de PDF dinâmico

Se utilizar um serviço de geração de PDF, pode:
  1. Primeiro, faça uma ação de Pedido HTTP para gerar o PDF
  2. Passe o URL do PDF devolvido para a função lógica como parâmetro

Etapa 4: Testar e ativar

  1. Guarde o fluxo de trabalho
  2. Aceda a um registo de Empresa
  3. Clique no menu e selecione o seu fluxo de trabalho
  4. Verifique a secção Anexos no registo para confirmar que o PDF foi anexado
  5. Ative o fluxo de trabalho

Combinar com Serviços de Geração de PDF

Para criar orçamentos ou faturas dinâmicos:

Exemplo: Gerar Orçamento → Anexar PDF

Serviços Populares de Geração de PDF

  • Carbone - Geração de documentos baseada em modelos
  • PDFMonkey - Criação dinâmica de PDF a partir de modelos
  • DocuSeal - Plataforma de automatização de documentos
  • Documint - Geração de documentos orientada a API
Cada serviço fornece uma API que retorna uma URL em PDF, que você pode passar para a função lógica.

Resolução de Problemas

Relacionados