# Modelo de mensagem HSM

Para cadastrar seu modelo vá em Configurações > Modelos > Inicio de chat (Gupshup).

Selecione **"+ Modelos".**

<figure><img src="/files/wU1sOJ5bkDhNRF3SYjMf" alt=""><figcaption></figcaption></figure>

Para cadastrar seu modelo é necessário **preencher os campos solicitados**:

<figure><img src="/files/AK76lXwoXryOV5SGIvPM" alt=""><figcaption></figcaption></figure>

* **Nome do modelo:** Deve ser escrito com letras minúsculas sem espaço entre as palavras.
* **Categorias:**&#x20;
  * **Marketing:** Conversas relacionadas a promoção de produtos ou serviços, com informações de venda, ofertas personalizadas, descontos e promoções, ou ainda templates que não se qualifica como utilidade ou autenticação.&#x20;
  * **Utility:** São conversas relacionadas a alguma transação, como notificações e contatos de vendas e pós-vendas, faturas e extratos de cobranças recorrentes, entre outros.
* **Descrição:** É a definição do modelo, o intuito da utilização.
* **Mensagem do modelo**: Mensagem enviada ao cliente. Utilize as variáveis disponíveis para personalizar sua mensagem.
* **Adicionar variável:** o botão de variáveis é uma ferramenta que permite personalizar e dinamizar suas mensagens. Ao usar esse botão, você pode inserir variáveis nos modelos de mensagem, que serão substituídas por valores específicos quando a mensagem for enviada.

Agora, você tem mais flexibilidade para gerenciar suas mensagens HSM no Gupshup. É possível editar as variáveis cadastradas nos modelos de mensagem, o que facilita tanto o cadastro quanto a edição dos mesmos.

{% hint style="info" %}
Após a aprovação de um modelo HSM no Gupshup, o conteúdo da descrição não pode mais ser editado. Somente os campos de Grupos de Modelos e os valores das variáveis são ajustáveis. Para modificar a descrição, é necessário criar um novo modelo HSM.
{% endhint %}

<figure><img src="/files/8AFqpczH1ouvbDmECRBy" alt=""><figcaption></figcaption></figure>

Ao configurar as variáveis na descrição do modelo, elas aparecerão no formato {{1}}, {{2}}, e assim por diante, conforme a ordem em que são inseridas. Cada campo de variável permitirá que você selecione uma variável específica para o modelo.

Quando você clicar no campo das variáveis, será exibida uma lista com as variáveis aceitas pelo modelo HSM do Gupshup.&#x20;

{% hint style="info" %}
A variável {CLIENT\_NAME} representa o nome do cliente. Para utilizar essa variável, é necessário que o cliente esteja previamente cadastrado no sistema. Se o cliente não estiver cadastrado, a mensagem de erro será exibida durante o envio, indicando que o cliente não está registrado.
{% endhint %}

Se for necessário utilizar uma variável específica, é possível criar variáveis personalizadas no modelo HSM do Gupshup. Para isso, siga os passos abaixo:

Acesse **Configurações > Mesa de serviço > Variáveis.**

Clique em **+Variável**

<figure><img src="/files/xCDSYyH85sYbgk5c7yJk" alt=""><figcaption></figcaption></figure>

Um pop-up será exibido, onde você poderá definir o nome da variável e o seu valor. Após preencher os campos, clique em "Salvar" para concluir.

<figure><img src="/files/zoCAbjCY9xzsdSwbaqWz" alt=""><figcaption></figcaption></figure>

Para configurar a sua variável personalizada criada acesse, **Configurações > Mesa de serviço > Modelos** e clique em **Início de chat (Gupshup).**

Você pode editar um modelo existente ou criar um novo, incorporando essa nova variável. Para isso, basta clicar no campo de valor e selecionar a variável personalizada recém-criada.

<figure><img src="/files/KDiJZHTWIlUFS3QhsmRj" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
As variáveis personalizadas que você criou serão exibidas na seção "Personalizadas". Além dessas, o TiFlux também oferece variáveis "Padrão", que já vêm pré-cadastradas no sistema.
{% endhint %}

## Aprovação do modelo

Após clicar em salvar, seu modelo ficará pendente de aprovação. Atualize a tela e verifique em status se seu modelo foi aprovado.&#x20;

Cada modelo possui um tempo individual de aprovação devido ao conteúdo [**analisado pelo Facebook.** ](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines/?translation)

{% hint style="info" %}
Para evitar que seus modelos sejam negados atente-se a **"Mensagem do modelo"** é compatível com sua **"Categoria".**
{% endhint %}

<figure><img src="/files/MviXp7CkQHDp26csNIoO" alt=""><figcaption></figcaption></figure>

## Utilizando os modelos&#x20;

Para iniciar uma conversa com seu cliente, você **sempre** enviará um modelo de mensagem já aprovado.

Ao clicar na tag todos os seus modelos estarão disponíveis para uso, selecione e clique em enviar.

<figure><img src="/files/oxct8vvUAUmHqjZVk6tz" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Após o envio do modelo de mensagem é necessário que seu cliente responda a mensagem para a barra de digitação ficar disponível. Isso significa que seu cliente está **autorizando a conversa.**&#x20;

Você pode enviar quantos modelos desejar. &#x20;
{% endhint %}

## Como deletar um modelo aprovado:

A exclusão é feita dentro do Tiflux ou pelo Gupshup.

Acesse as configurações do seu aplicativo no painel do Gupshup e vá em **Modelos** e selecione o modelo que deseja **excluir.**

<figure><img src="/files/k72fUFo9g8rFp4QZq39V" alt=""><figcaption></figcaption></figure>

Acesse as configurações do seu modelo no Tiflux e selecione o modelo que deseja **excluir.**

<figure><img src="/files/J3bGfVx1L9rCU2S6jvaI" alt=""><figcaption></figcaption></figure>

### **Em seguida atualize seus modelos no Tiflux:**

<figure><img src="/files/g15DQRNqM2jPs8N4j9MV" alt=""><figcaption></figcaption></figure>


---

# 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/integracoes/api-oficial-do-whatsapp/gupshup/modelo-de-mensagem-hsm.md?ask=<question>
```

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.
