Page cover

Modelos HSM - Utility e Marketing

📌 📲 Modelos HSM de Início de Chat – Gupshup e Meta

**📍 Localização:**  
Configurações > Mesa de Serviço > Modelos >

🎯 Introdução

Os Modelos HSM (Highly Structured Messages) de Início de Chat são mensagens pré-aprovadas pelo WhatsApp que permitem iniciar conversas com clientes fora da janela de 24 horas. No Tiflux, integrado à plataforma Gupshup ou Meta, esses modelos são essenciais para envio de notificações, lembretes, autenticações ou mensagens promocionais, garantindo conformidade com as políticas do WhatsApp e uma comunicação eficaz e profissional.

✅ Ideal para iniciar atendimentos proativos, campanhas de pós-venda, reativação de leads ou envio de códigos de segurança.


📚 Sumário

  • 📄 Categorias de Modelos HSM

  • 🧾 Requisitos para uma boa criação

  • 🛠️ Processo de criação HSM quando Gupshup

  • 🛠️ Processo de criação HSM quando Meta

  • ⏳ Processo de análise e aprovação

  • 🔄 Utilização e regras de janela de 24h

  • ⚠️ Limitações e motivos comuns de rejeição

  • ❓ Perguntas Frequentes (FAQ)

  • 🔍 Palavras-chave para IA, indexação e busca


📄 Categorias de Modelos HSM

Todo modelo deve ser classificado em uma das seguintes categorias, conforme sua finalidade:

  • Utility Notificações transacionais: pedidos, agendamentos, faturas, atualizações de status. Ex: “Seu pedido #22215 foi confirmado. Enviaremos o rastreio em breve.”

  • Marketing Promoções, ofertas personalizadas, lançamentos ou mensagens institucionais. Ex: “Agradecemos por ser nosso cliente! Confira nossa nova campanha exclusiva.”

💡 A categoria influencia o custo da mensagem e o tempo de análise.


🧾 Requisitos para uma boa criação

Siga estas boas práticas para aumentar as chances de aprovação:

  • Consentimento do cliente: Ele deve ter concordado em receber mensagens via WhatsApp.

  • Clareza e relevância: Use linguagem simples, objetiva e alinhada ao contexto do cliente.

  • Horários adequados: Evite envios fora do horário comercial (ex: madrugada).

  • Quebras de linha: Melhoram a legibilidade.

  • Evite:

    • Uso excessivo de CAIXA ALTA

    • Emojis ou negrito abusivos

    • URLs, mídias ou emojis em modelos de Authentication

    • Solicitação de dados sensíveis (CPF, senhas, etc.)


🛠️ Processo de criação HSM quando Gupshup

  1. Acesse o Tiflux, vá em Configurações > Mesa de serviço > Modelos > Início de chat (Gupshup)

  2. Clique em “+ Grupo de Início de chat”.

    • Insira o nome do modelo

  3. Clique em “+ Novo Modelo”:

    • Nome do modelo: Identificador interno (até 512 caracteres).

    • Categoria: Authentication / Utility / Marketing.

    • Idioma: Ex: Português (Brasil).

    • Descrição: Texto final (até 1.024 caracteres).

    • Insira variáveis caso existam.

  4. Revise conforme as políticas do WhatsApp.

  5. Clique em “Salvar”.

📌 Importante: Após salvo, somente é possivel alterar o conteudo do modelo. Lembrando que após salvar, ele retorna para análise


🛠️ Processo de criação HSM quando Meta

  1. Acesse o Meta, vá em Gerenciador do Whatsapp deste numero

  2. Clique em “Modelos de mensagem”.

  3. Depois em “Criar modelo”

  4. Clique em “+ Novo Modelo”:

  5. Após efetuar a criação volte no Tiflux

  6. Vá em Configurações > Mesa de serviço > Modelos > Início de chat (Whatsapp Cloud API)

  7. Neste você deve clicar em atualizar para sincronizar as mensagens do Meta com o Tiflux.


Processo de análise e aprovação

  • O modelo entra no status “Em Análise”.

  • A análise pode levar até 24 horas.

  • Resultados possíveis:

    • Aprovado: Disponível para uso no Tiflux.

    • Reprovado: Motivo será informado (ex: violação de política, duplicata, conteúdo abusivo).

🔁 Após aprovação, sempre sincronize os modelos no Tiflux atraves do botão atualizar, seja ele Gupshup ou Meta.


🔄 Utilização e regras de janela de 24h

  • A janela de 24h começa a contar a partir da última mensagem enviada pelo cliente.

  • Fora dessa janela, só é permitido enviar mensagens via modelo HSM aprovado.

  • Cada envio de HSM inicia um novo chat, com nova janela de 24h.

  • Modelos podem ser usados em:

    • Automações (ex: “enviar HSM após 2 dias sem resposta”)

    • Ações manuais no ticket

    • Integrações externas via API


⚠️ Limitações e motivos comuns de rejeição

  • 🚫 Máximo de 100 modelos por hora por conta WhatsApp Business.

  • 🚫 Não coloque variável como primeira palavra no corpo.

  • 🚫 Não use duas variáveis seguidas (ex: {{nome}}{{cpf}}).

  • 🚫 Conteúdo duplicado: Se já existe um modelo idêntico, o novo será rejeitado.

  • 🚫 Conteúdo ameaçador, enganoso ou abusivo (ex: “Pagamento vencido – ação judicial será tomada”).

  • 🚫 Autenticação com URL, emoji ou mais de 15 caracteres no parâmetro.


Perguntas Frequentes (FAQ)

🔹 Posso usar emojis em modelos de Marketing? Sim, com moderação. Evite excessos que comprometam a legibilidade.

🔹 Quanto tempo demora para o modelo aparecer no Tiflux após aprovação? Imediatamente após atualizar a página na aba de Modelos.

🔹 Como sei se meu modelo foi reprovado? O status será “Reprovado” no painel da Gupshup, com descrição do motivo.

🔹 Posso enviar modelo HSM para qualquer número? Apenas se o cliente deu consentimento e o número estiver ativo no WhatsApp.

🔹 Modelos de Utility podem ter links? Sim, desde que sejam relevantes (ex: link de rastreio, fatura).

🔹 É possível testar o modelo antes de submeter? Não. Só é possível testar após aprovação.

🔹 O que acontece se eu enviar um modelo não aprovado? A mensagem não será entregue e pode gerar erro na integração.

🔹 Preciso de modelo HSM para responder dentro de 24h? Não. Dentro da janela, você pode enviar mensagens livres.

🔹 Posso reutilizar um modelo aprovado em outra campanha? Sim! Modelos aprovados podem ser usados quantas vezes quiser.

🔹 O Tiflux valida os modelos automaticamente? Não. A validação é feita exclusivamente pela Gupshup e Meta.


🔍 Palavras-chave para IA, indexação e busca

Atualizado