> 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/whatsapp-components/hsm-do-whatsapp.md).

# HSM do WhatsApp

### Visão Geral

O **Componente de Envio de Mensagens Prontos do WhatsApp** (popularmente conhecido como `whatsapp_hsm`) é um nó de ação focado no disparo de notificações estruturadas e proativas para contatos. Sua função principal é transmitir modelos de mensagens comerciais pré-aprovados pela Meta (*Highly Structured Messages - HSM*) fora da janela de conversação padrão de 24 horas, permitindo o envio de alertas, lembretes de cobrança, atualizações de status e mensagens de reengajamento.

**Regra de Bloqueio por Atendimento Aberto:** Para evitar interferências lógicas ou interrupções no fluxo de trabalho de operadores humanos, o componente possui uma trava nativa de segurança: o sistema realiza uma varredura prévia e, se o número de destino **já possuir um ticket ou atendimento humano em aberto**, a HSM **não será enviada**. Para forçar o disparo de forma prioritária e independente do estado atual do contato, é mandatório ativar explicitamente o parâmetro de bypass do componente.

### Parâmetros de Configuração

A parametrização do componente conecta a conta da Meta às variáveis do fluxo, dividindo-se nos seguintes critérios:

* **Conexão:** Menu suspenso para selecionar por qual conta ou número oficial do WhatsApp Business API a notificação ativa será transmitida para o destinatário. *(Recomenda-se utilizar nomenclaturas fictícias ou padronizadas de canais no ambiente de design).*<br>
* **Template:** Permite escolher qual dos modelos homologados e aprovados pela Meta na conta comercial será utilizado (ex: `teste_var`).<br>
* **Variáveis (Body):** Campos de entrada dinâmicos gerados dinamicamente com base nos marcadores de posição do template selecionado (ex: `{{1}} *`). Servem para preencher as informações personalizadas que serão injetadas na mensagem enviada.<br>
* **Setor / Usuário / Campanhas (Atribuição e Rastreabilidade):** Menus opcionais para vincular o ticket gerado pelo disparo a uma fila de atendimento específica, a um operador fixo ou a uma campanha de marketing interna para fins de relatórios analíticos.<br>
* \_*Enviar para (* Campo Obrigatório):\_\* Campo de entrada numérico contendo o telefone do destinatário (com código de área/DDD) que receberá o disparo. Aceita valores estáticos ou injeção de variáveis do fluxo.<br>
* **Não abrir atendimento (Chave de Alternância - Toggle Switch):** Parâmetro crítico de controle. Quando **desativado**, o envio da HSM abre automaticamente um ticket no painel caso o cliente responda. Quando **ativado**, o sistema envia a notificação como um disparo isolado (notificação pura) e ignora a trava de segurança, garantindo a entrega do conteúdo mesmo se o contato tiver um atendimento em aberto com um humano.<br>
* **Múltiplas Saídas (Chave de Alternância - Toggle Switch):** Quando habilitado, altera a morfologia do bloco no editor gráfico de fluxos, disponibilizando portas de ramificação distintas baseadas nos status de entrega e leitura ou nas interações com o post (como cliques em botões de resposta rápida do template).<br>

### Construtor Visual

O construtor adapta dinamicamente sua interface gráfica em tempo real, servindo como um assistente de validação antes do envio:

* **Módulo de Pré-Visualização Integrado:** Ao selecionar um modelo no campo *Template*, a interface renderiza uma caixa de exibição simulando exatamente como a mensagem aparecerá no aparelho do cliente final, exibindo os marcadores de variáveis (ex: `Bom dia, eu sou o {{1}}, tudo bem?`).<br>
* **Formulário Dinâmico de Inputs:** O bloco detecta quantos marcadores de dados existem no corpo, cabeçalho ou rodapé do template da Meta e gera um campo do tipo texto obrigatório (`*`) para cada um deles no bloco *Variáveis*, garantindo que nenhuma mensagem seja enviada com trechos vazios ou quebrados.<br>

### Operadores Especiais

As propriedades lógicas deste componente gerenciam a interpolação de dados com os servidores da Meta e o roteamento de respostas:

* **Tokenização de Strings para Variáveis:** Os campos de inputs de variáveis aceitam tanto valores textuais fixos quanto tags de dados do próprio fluxo (ex: injetar a variável `{{cliente.nome}}` dentro do campo do marcador `{{1}}`). No momento do disparo, o motor compila esse payload e o envia estruturado para a API do WhatsApp.<br>
* **Gatilho por Interação de Botão (Quick Replies):** Se o template aprovado pela Meta possuir botões de resposta rápida e o parâmetro *Múltiplas Saídas* estiver ativo, cada botão vira uma linha física de conexão no editor de fluxo. Isso permite desenhar caminhos de automação condicionados a qual botão o usuário clicou ao responder a HSM.<br>

### Exemplos Práticos

A tabela abaixo demonstra o comportamento do componente diante de diferentes cenários operacionais de entrega:

| **Template Escolhido** | **Variável Injetada no {{1}}** | **Status da Chave "Não abrir atendimento"** | **Estado do Cliente no Painel**       | **Comportamento do Sistema**                                                                                                           |
| ---------------------- | ------------------------------ | ------------------------------------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `teste_var`            | `Atendente Teste`              | **Desativada (Padrão)**                     | Sem chamados abertos.                 | **Sucesso:** A mensagem é entregue e, se o cliente responder, um novo atendimento é gerado na plataforma.                              |
| `teste_var`            | `Atendente Teste`              | **Desativada (Padrão)**                     | Em atendimento com o suporte técnico. | **Envio Bloqueado:** O sistema aborta o disparo da HSM para não violar o atendimento que já está sendo tratado por um humano.          |
| `aviso_cobranca`       | `Valor: R$ 150,00`             | **Ativada**                                 | Em atendimento com o setor comercial. | **Envio Forçado:** O sistema ignora o chamado aberto e entrega a notificação de cobrança de forma transparente no aparelho do cliente. |


---

# 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/whatsapp-components/hsm-do-whatsapp.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.