Criar modelos de documentos PDF para workflows do HubSpot

O ecrã Document templates é onde cria e gere os modelos PDF que a ação de workflow do HubSpot Generate Document preenche. Cada modelo define o esquema de um PDF e as propriedades de contacto a incluir nele.

Antes de começar

Precisa da função Owner ou Admin. Os Members e as pessoas com a função Billing veem uma lista vazia e não podem abrir, criar nem alterar modelos.
O HubSpot tem de estar ligado à sua organização. Consulte Configuração do HubSpot.

Abrir Document templates

Selecione Settings na barra lateral esquerda e depois Document templates em Integrations. O ecrã tem uma lista Templates de um lado e o editor de modelos do outro. A lista mostra o nome de cada modelo; quando está vazia, indica “No document templates yet.”

Criar um modelo

Introduza um Name para o modelo.
Escreva o Template JSON. O editor começa com um exemplo que pode alterar.
Selecione Create template.

A definição estabelece um title opcional para o documento e uma lista de blocks, apresentados de cima para baixo. Um modelo precisa de pelo menos um bloco e pode ter até 80.

Bloco	É apresentado como
`heading`	Uma linha de título
`paragraph`	Um parágrafo de texto
`table`	Uma tabela construída a partir de linhas de células
`spacer`	Espaço vertical entre blocos

Para inserir uma propriedade de contacto, coloque um token no formato contact.<property> entre chavetas duplas, como {{contact.firstname}}. Pode usar tokens no título, no texto de títulos e parágrafos e nas células de tabelas. Quando a ação Generate Document é executada, o Flowella substitui cada token pelo valor do contacto inscrito.

{
  "title": "Letter for {{contact.firstname}}",
  "blocks": [
    { "type": "heading", "text": "Hello {{contact.firstname}}" },
    { "type": "paragraph", "text": "Email: {{contact.email}}" },
    { "type": "spacer" },
    {
      "type": "table",
      "rows": [
        ["Name", "{{contact.firstname}} {{contact.lastname}}"],
        ["Phone", "{{contact.phone}}"]
      ]
    }
  ]
}

Se o JSON não puder ser lido, o Flowella mostra “Template JSON is invalid” e não o guarda.

Editar ou eliminar um modelo

Selecione o modelo na lista Templates. O editor mostra o respetivo Name, Template ID e Template JSON.
Altere o nome ou o JSON e depois selecione Save changes.

Para começar antes um modelo novo, selecione New template. Isto limpa o editor. Para remover o modelo, selecione Delete.

Delete remove o modelo de imediato, sem pedir confirmação. Qualquer workflow do HubSpot que ainda use o respetivo ID falhará com DOCUMENT_TEMPLATE_NOT_FOUND.

Usar um modelo no HubSpot

Selecione o modelo na lista Templates.
Junto a Template ID, selecione Copy ID.
No seu workflow do HubSpot, cole o ID no campo Document template ID da ação Generate Document.

Quando o workflow é executado, o Flowella preenche o modelo com as propriedades do contacto inscrito e guarda o PDF nos seus ficheiros do HubSpot como ficheiro público, para que qualquer pessoa com a ligação o possa abrir. Não coloque dados pessoais sensíveis nos modelos de documentos. A ação devolve o URL do ficheiro e o ID do ficheiro no HubSpot para passos posteriores do workflow. Consulte Generate Document para conhecer as definições da ação.

Se o documento não for criado

Quando a ação não consegue criar o PDF, o passo do workflow falha com um código de erro:

Código de erro	O que significa	O que fazer
`DOCUMENT_TEMPLATE_NOT_FOUND`	Não existe nenhum modelo com esse ID na sua organização. Pode ter sido eliminado.	Copie novamente o ID a partir de Document templates e cole-o na ação.
`DOCUMENT_TOKEN_MISSING`	Um token no modelo aponta para uma propriedade de contacto que está vazia para este contacto.	Preencha a propriedade no HubSpot ou remova o token do modelo.
`HUBSPOT_NOT_CONNECTED`	O Flowella não consegue aceder à sua conta HubSpot.	Volte a ligar o HubSpot em Settings e depois HubSpot.

Primeiros passos

Essenciais

Usar a aplicação

Definições

Configuração Meta e WhatsApp

Integração HubSpot

Flows e campanhas

Referência da API

Resolução de problemas

Registro de alterações

Criar modelos de documentos PDF para workflows do HubSpot

Antes de começar

Abrir Document templates

Criar um modelo

Editar ou eliminar um modelo

Usar um modelo no HubSpot

Se o documento não for criado

Relacionado

Generate Document (HubSpot)

AI Document Reader (HubSpot)

​Antes de começar

​Abrir Document templates

​Criar um modelo

​Editar ou eliminar um modelo

​Usar um modelo no HubSpot

​Se o documento não for criado

​Relacionado

Generate Document (HubSpot)

AI Document Reader (HubSpot)

Antes de começar

Abrir Document templates

Criar um modelo

Editar ou eliminar um modelo

Usar um modelo no HubSpot

Se o documento não for criado

Relacionado