> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/html-para-pdf.md).

# HTML para PDF

## 📄 HTML para PDF

O módulo **HTML para PDF** converte um conteúdo HTML em um arquivo PDF, entregando uma URL temporária para acessar o resultado. É útil para gerar documentos como comprovantes, relatórios ou contratos a partir de um modelo HTML montado no fluxo.

**📷 Inserir print:** visão geral do módulo HTML para PDF na área de trabalho do fluxo

***

### 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Integração** (identificada pela cor azul).
5. Arraste o módulo **HTML para PDF** para a área de trabalho do fluxo.

**📷 Inserir print:** painel de módulos com a categoria Integração expandida e o módulo HTML para PDF visível

***

### 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

**📷 Inserir print:** painel de configuração do módulo HTML para PDF aberto

***

#### 📝 HTML

No campo principal, escreva o conteúdo HTML que será convertido em PDF. Você pode usar variáveis do fluxo para personalizar o conteúdo.

**📷 Inserir print:** campo HTML com um exemplo de código digitado, incluindo alguma variável do fluxo (como `{{input.nome}}`)

***

#### ⚙️ Opções de PDF

Existe uma seção opcional, identificada por uma seta para expandir, para configurar opções adicionais do PDF. Ao abrir essa seção, você encontra duas abas: **Editar configurações** (para adicionar pares de **Configuração** e **Valor** manualmente, um de cada vez) e **Editar como JSON** (para escrever todas as opções de uma vez em um único campo).

{% hint style="warning" %}
No momento, as opções configuradas nesta seção **não têm efeito** — o PDF é sempre gerado com as configurações padrão, independentemente do que for preenchido aqui. Ao abrir essa seção pela primeira vez, também é normal aparecer uma mensagem informando "formato de configuração inválido" mesmo sem nenhum erro real — pode ser ignorada.
{% endhint %}

**📷 Inserir print:** seção Opções de PDF expandida, mostrando as abas Editar configurações e Editar como JSON com os campos Configuração e Valor

***

#### 🔀 Saídas do módulo

O módulo tem duas saídas:

* **Sucesso** — o PDF foi gerado, com a URL disponível na variável de saída para os próximos módulos do fluxo.
* **Erro** — não foi possível processar a solicitação de conversão.

{% hint style="warning" %}
A URL do PDF é **temporária**. Se precisar manter o arquivo disponível por mais tempo, salve-o em outro local (por exemplo, enviando-o para um módulo de armazenamento) logo após a geração.
{% endhint %}

**📷 Inserir print:** módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro

***

### 💡 Caso de uso

**Cenário:** uma empresa quer gerar um comprovante em PDF ao final de um atendimento, com os dados da conversa.

**Configuração:**

1. Adicione o módulo **HTML para PDF** ao fluxo, no ponto em que os dados do atendimento já foram coletados.
2. No campo **HTML**, monte o layout do comprovante usando variáveis do fluxo, como `{{input.nome}}` e `{{input.protocolo}}`.
3. Conecte a saída **Sucesso** a um módulo que envie a URL do PDF ao cliente.

**Resultado:** o cliente recebe um link para baixar o comprovante em PDF, gerado automaticamente com os dados do atendimento.

***

### 📌 Dicas úteis

* Teste o HTML em um navegador antes de usá-lo no módulo, para garantir que a formatação ficará como esperado no PDF.
* Lembre-se de que a URL gerada é temporária — não a use como link permanente.
* Como não há confirmação de que o PDF foi realmente gerado com sucesso dentro do serviço de conversão, teste o fluxo e confirme que a URL retornada realmente abre o arquivo esperado.

***

### 📝 Resumo

* O módulo **HTML para PDF** converte um conteúdo HTML em um arquivo PDF.
* O único campo obrigatório é o **HTML** a ser convertido.
* A seção de Opções de PDF ainda não tem efeito sobre o resultado.
* A saída **Sucesso** entrega uma URL temporária de acesso ao PDF gerado; a saída **Erro** ocorre em falhas de processamento.