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).

• Template: Permite escolher qual dos modelos homologados e aprovados pela Meta na conta comercial será utilizado (ex: teste_var).

• 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.

• 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.

• _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.

• 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.

• 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).

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?).

• 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.

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.

• 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.

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.