> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/integracoes/api-oficial-do-whatsapp/gupshup/modelo-de-mensagem-hsm-gupshup.md).

# Modelo de mensagem HSM Gupshup

Como cadastrar modelos de mensagem HSM no Tiflux?

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

Selecione **"+ Modelos".**

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FHrXXjIV9yPi51apUYZbB%2Fimage.png?alt=media&amp;token=5947d727-ed7e-46b5-a834-1e9d81a07257" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FHq8r5GpnORiQ6qZWwphX%2Fimage.png?alt=media&amp;token=71d4d781-6d5d-4cd4-9272-2985006b9d06" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FyWijBcSiC6al6ppwIbHP%2Fimage.png?alt=media&amp;token=08197ec9-f81b-444b-a535-0925d63ae485" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FPD9BvqreS8kP0Z6yocjN%2Fimage.png?alt=media&amp;token=ada12b6f-aa1b-4f9d-b0da-e6933f433776" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FOEsTEiixpXc9erLocdX0%2Fimage.png?alt=media&amp;token=02eaf41d-3688-4803-b7e1-abe00b0e0fd5" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FCKaLM4QEd9ChrYstz7sq%2Fimage.png?alt=media&amp;token=59df5945-69aa-4238-9a90-1db83f94b668" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FH8d5Q7mHvWDVf5pSQuCl%2Fimage.png?alt=media&amp;token=e34349e3-fae8-4ab8-97d7-8818d78edd13" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2F5MHVRjH3yar7IDPCdkLh%2Fimage.png?alt=media&amp;token=6374e9c7-12ef-4967-aaa0-88ec73fabbc1" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2F9mVrCDyO7MHb23Ko7l74%2Fimage.png?alt=media&amp;token=763becfe-c80a-46ab-bad2-108bbe3e2162" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FC2LEFuoHJ8EmLtHc0Axo%2Fimage.png?alt=media&amp;token=5204fd06-e87b-46ca-b988-3bfcb17262ea" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FnAoS8kmowGP2Q5VhX3xo%2Fimage.png?alt=media&amp;token=76157ae2-51fe-465b-a96d-d62e384d6056" alt=""><figcaption></figcaption></figure>
