> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/others/comentario.md).

# Comentário

### Visão Geral

O **Componente de Comentário Interno** (identificado na interface pelo título técnico `Comentário`) é um nó utilitário focado de forma exclusiva na documentação, organização gráfica e governança de fluxos. Diferente dos nós de mensageria, este componente **não interage e não é visível para o cliente final**. Sua função principal é servir de apoio visual para que desenvolvedores e gestores insiram notas técnicas, descrições de regras de negócio, avisos de pendências ou mapeamento de jornadas dentro do próprio canvas de automação.

### Parâmetros de Configuração

A parametrização do bloco gerencia a formatação textual e a identidade visual da nota no editor:

* **Comentário:** Editor de texto enriquecido (*rich text*) onde o administrador digita a anotação, explicação ou documentação desejada. Ele disponibiliza uma barra de ferramentas nativa contendo opções como: negrito, itálico, tachado, linhas horizontais, cabeçalhos, links, blocos de citação, inserção de trechos de código (`code blocks`), tabelas e listas ordenadas.<br>
* **Pré-Visualização:** Área dinâmica que renderiza em tempo real o texto formatado no editor, demonstrando exatamente como a anotação ficará exposta para a equipe no mapa de design.<br>
* **Cor:** Barra seletora de tonalidade cromática (exibida em roxo na imagem). Ela permite alterar a cor de destaque do contêiner ou do cabeçalho do nó no mapa de fluxos.<br>

### Construtor Visual

A interface gráfica é otimizada para legibilidade e organização espacial dentro do mapa de automação:

* **Editor Rich Text Autônomo:** O construtor oferece ferramentas de formatação completas de nível de processador de texto para que dados complexos (como listas de pendências de API) possam ser documentados de maneira estruturada e limpa.<br>
* **Nó Sem Conectores de Linha:** No editor gráfico de fluxos, este componente atua como um bloco flutuante isolado. **Ele não possui portas físicas de entrada ou de saída**, pois não faz parte da esteira transacional do contato. Ele é posicionado livremente ao lado dos nós de ação para explicar o que aquela ramificação específica do bot realiza.<br>

### Operadores Especiais

As propriedades lógicas deste componente gerenciam a indexação puramente estática e o controle visual de projetos:

* **Organização por Código de Cores (Color-Coding System):** A propriedade do campo *Cor* permite que equipes ágeis criem padrões de moderação visuais rápidos no canvas (ex: usar blocos *Vermelhos* para documentar erros conhecidos, *Verdes* para indicar regras de negócio homologadas ou *Amarelos* para tarefas pendentes).<br>
* **Processamento Estático Sem Impacto de Infraestrutura:** O motor da automação ignora este componente por completo durante a execução da jornada de um cliente em tempo real. O nó não consome memória transacional, não gera latência e não processa variáveis dinâmicas de escopo.<br>

### Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de como configurar e espalhar os blocos de comentário para documentar uma automação profissional:

| **Cor do Bloco Selecionada** | **Conteúdo Formatado no Comentário**                                                                                                                                      | **Objetivo da Nota no Canvas**                                      | **Caso de Uso Prático**                                                                                                                    |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Roxo**                     | <p><code>### Regra de Distribuição de Leads</code><br><br><br><br>- <strong>Setor 1:</strong> Vendas Varejo<br><br><br><br>- <strong>Setor 2:</strong> Vendas Atacado</p> | Explicar os critérios de um bloco condicional Switch Case próximo.  | Deixar evidente para novos administradores quais parâmetros matemáticos guiam a divisão de setores do bot.                                 |
| **Vermelho**                 | `> ⚠️ **ATENÇÃO:** O Token de API abaixo expira a cada 90 dias. Próxima troca: 15/09/2026.`                                                                               | Emitir avisos críticos de infraestrutura ou manutenção para o time. | Fixar um alerta visual vermelho ao lado de um componente de Code ou Webhook para lembrar a equipe de suporte sobre atualizações de chaves. |
| **Cinza**                    | `*Fluxo construído pelo desenvolvedor Carlos em Junho/2026. Versão 2.4.*`                                                                                                 | Identificar autoria, histórico de alterações e versão do script.    | Manter um cabeçalho estático no topo do fluxo funcionando como um diário de bordo do projeto de automação.                                 |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/others/comentario.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.