HTML to Text

1. Visão Geral

O componente HTML to Text (html-to-txt) converte um conteúdo HTML em texto puro ou em Markdown, removendo as tags e mantendo apenas o conteúdo legível.

Use quando o fluxo precisa extrair o texto de um e-mail em HTML, página web ou qualquer conteúdo HTML recebido. Não use para extrair dados estruturados de HTML (nesse caso, uma abordagem de parsing específica seria mais adequada).

2. Pré-requisitos

Não há credenciais externas — processamento local.

3. Autenticação e Conexão

Não aplicável.

4. Configuração / Operações Suportadas

O componente tem uma única operação: converter HTML em texto.

Campo	Obrigatório	Tipo	Descrição	Exemplo
`useFile`	Não	Texto ("true"/"false")	Se `false` (padrão), o HTML vem do campo `html`. Se `true`, vem de um arquivo já presente na mensagem.	`"false"`
`html`	Sim, se `useFile` for `false`	Texto (HTML)	O conteúdo HTML a converter.	`"<p>Olá <b>mundo</b></p>"`
`file`	Sim, se `useFile` for `true`	Texto	Nome da propriedade da mensagem onde está o arquivo HTML.	`"paginaHtml"`
`format`	Não	Texto: `text` ou `markdown`	Formato de saída. Valor padrão: `"text"`.	`"markdown"`
`charset`	Não	Texto	Codificação de caracteres. Valor padrão: `"UTF-8"`.	`"UTF-8"`

5. Exemplos Práticos

Exemplo simples: extrair o texto puro de um e-mail recebido em HTML.

Entrada:

{
  "corpoEmail": "<html><body><p>Olá <b>Maria</b>, seu pedido foi confirmado.</p></body></html>"
}

Configuração do componente:

{
  "componentName": "html-to-txt",
  "configurations": {
    "html": "{$.body.corpoEmail}"
  }
}

Resposta:

{
  "text": "Olá Maria, seu pedido foi confirmado.",
  "format": "text",
  "length": 38,
  "charset": "UTF-8"
}

Exemplo avançado: converter um arquivo HTML recebido em um passo anterior para Markdown.

Entrada:

{
  "paginaHtml": "<arquivo .html, disponibilizado por um passo anterior>"
}

Configuração do componente:

{
  "componentName": "html-to-txt",
  "configurations": {
    "useFile": "true",
    "file": "paginaHtml",
    "format": "markdown"
  }
}

Resposta:

{
  "text": "# Título da página\n\nConteúdo em **negrito** e *itálico*.",
  "format": "markdown",
  "length": 58,
  "charset": "UTF-8"
}

6. Erros Comuns e Troubleshooting

Erro / Sintoma	Causa provável	Como resolver
"HTML content is empty"	O conteúdo HTML resolvido está vazio.	Verificar se `html` ou o arquivo referenciado em `file` realmente têm conteúdo.
"file parameter is required when useFile=true"	`useFile` está ativado, mas `file` não foi preenchido.	Preencher `file` com o nome da propriedade que contém o arquivo.
"HTML content not found. Use 'html' parameter (text) or set useFile=true with 'file' parameter."	Nem `html` nem `file`+`useFile=true` foram configurados corretamente.	Escolher uma das duas formas de fornecer o conteúdo e configurá-la corretamente.
"File [nome] not found inside the execution context."	O arquivo referenciado em `file` não existe na mensagem com esse nome.	Confirmar que um passo anterior disponibilizou o arquivo com esse nome exato.
"Error converting HTML to text: ..."	Falha ao processar o HTML (malformado ou erro interno).	Revisar o conteúdo HTML de entrada.

1. Visão Geral​

2. Pré-requisitos​

3. Autenticação e Conexão​

4. Configuração / Operações Suportadas​

5. Exemplos Práticos​

6. Erros Comuns e Troubleshooting​