> 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

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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FN0aY7CHzsWM9yjSPHpxV%2F01-visao-geral-canvas.png?alt=media&amp;token=e3268639-7db8-4fdc-acea-f8b82bc738d6" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo HTML para PDF na área de trabalho do fluxo no Hyperflow Integrações.</p></figcaption></figure>

***

### 🧭 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fm3eUTLruw9pAq65Rs6JS%2Fimage.png?alt=media&amp;token=cc9b0f57-04e2-4584-90b4-c8f4e47f0457" alt=""><figcaption><p>Imagem 2 - Painel de módulos com a categoria Integração expandida e o módulo HTML para PDF visível.</p></figcaption></figure>

***

### 🔍 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F7yEnbBCkAaW2aklerYy9%2F03-painel-aberto.png?alt=media&amp;token=4605ddce-7c47-4a24-8b78-2f705cb5c98e" alt=""><figcaption><p>Imagem 3 - Painel de configuração do módulo HTML para PDF aberto.</p></figcaption></figure>

***

#### 📝 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FViqsaeG3ZW7fKN5o4jOj%2F04-html-exemplo.png?alt=media&amp;token=a7e752ef-e30f-40dc-9693-d63f9a994360" alt=""><figcaption><p>Imagem 4 - Campo HTML preenchido com um exemplo.</p></figcaption></figure>

***

#### ⚙️ 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 %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FoBEdZvsevCH3pm3Ulqvf%2F05-opcoes-pdf.png?alt=media&amp;token=256e1ac4-eb8e-4170-b0fb-8546afda1c88" alt=""><figcaption><p>Imagem 5 - Seção Opções de PDF expandida com configurações preenchidas.</p></figcaption></figure>

***

#### 🔀 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 %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fy9O5Q4DFTFi4zJnEsxp0%2F06-saidas-conectadas.png?alt=media&amp;token=ad8ea22d-034f-4888-add8-88f22d5b45ba" alt=""><figcaption><p>Imagem 6 - Módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro.</p></figcaption></figure>

***

### 💡 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.