Skip to main content

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.

CampoObrigatórioTipoDescriçãoExemplo
useFileNãoTexto ("true"/"false")Se false (padrão), o HTML vem do campo html. Se true, vem de um arquivo já presente na mensagem."false"
htmlSim, se useFile for falseTexto (HTML)O conteúdo HTML a converter."<p>Olá <b>mundo</b></p>"
fileSim, se useFile for trueTextoNome da propriedade da mensagem onde está o arquivo HTML."paginaHtml"
formatNãoTexto: text ou markdownFormato de saída. Valor padrão: "text"."markdown"
charsetNãoTextoCodificaçã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 / SintomaCausa provávelComo 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.