# KCS - 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.\ \&#xNAN;*Ex: “Seu pedido #22215 foi confirmado. Enviaremos o rastreio em breve.”* * **Marketing**\ Promoções, ofertas personalizadas, lançamentos ou mensagens institucionais.\ \&#xNAN;*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** ``` modelo HSM, início de chat, Gupshup Tiflux, mensagem template WhatsApp, autenticação WhatsApp, marketing WhatsApp, utility message, modelo aprovado, janela de 24h, consentimento WhatsApp, política WhatsApp, notificação proativa, envio de código, modelo reprovado, criar template Gupshup, integração WhatsApp, modelos de início, ticket início chat, comunicação proativa ``` --- # Agent Instructions: 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: ``` GET https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/integracoes/whatsapp/kcs-modelos-hsm-utility-e-marketing.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.