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:- Transferir o PDF a partir de um URL (de um serviço de geração de PDF)
- Carregar o ficheiro para o Twenty
- Criar um Anexo ligado ao registo
Pré-requisitos
Antes de configurar o fluxo de trabalho:- Crie uma Chave de API: Vá a Definições → APIs e crie uma nova chave de API. Vai precisar deste token para a função lógica.
- 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
- Vá a Fluxos de Trabalho e crie um novo fluxo de trabalho
- Selecione Gatilho Manual
- Escolha o objeto ao qual pretende anexar PDFs (por exemplo, Empresa ou Oportunidade)
Passo 2: Adicionar uma Função lógica
- Adicionar uma ação Code (função lógica)
- Crie uma nova função com o código abaixo
- Configure os parâmetros de entrada
Parâmetros de Entrada
| Parâmetro | Valor |
|---|---|
companyId | {{trigger.object.id}} |
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
SubstituatargetCompanyId pelo campo apropriado:
| Objeto | Nome do Campo |
|---|---|
| Empresa | targetCompanyId |
| Pessoa | targetPersonId |
| Oportunidade | targetOpportunityId |
| Objeto personalizado | targetYourCustomObjectId |
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:- Primeiro, faça uma ação de Pedido HTTP para gerar o PDF
- Passe o URL do PDF devolvido para a função lógica como parâmetro
Etapa 4: Testar e ativar
- Guarde o fluxo de trabalho
- Aceda a um registo de Empresa
- Clique no menu ⋮ e selecione o seu fluxo de trabalho
- Verifique a secção Anexos no registo para confirmar que o PDF foi anexado
- 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
| Etapa | Ação | Finalidade |
|---|---|---|
| 1 | Gatilho Manual (Empresa) | O utilizador inicia num registo |
| 2 | Pesquisar Registo | Obter detalhes da Oportunidade ou dos itens de linha |
| 3 | Requisição HTTP | Chamar a API de geração de PDF com os dados do registo |
| 4 | Função serverless | Transferir e anexar o PDF gerado |
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
Resolução de Problemas
| Problema | Solução |
|---|---|
| ”Falha ao transferir PDF” | Verifique se o URL do PDF é acessível e devolve um PDF válido |
| ”Falha ao carregar” | Verifique se a sua chave de API é válida e tem permissões de escrita |
| ”Falha na criação do anexo” | Garanta que o nome do campo de ID do objeto corresponde ao objeto de destino |