> For the complete documentation index, see [llms.txt](https://digisac.gitbook.io/manual-digisac-2-0/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://digisac.gitbook.io/manual-digisac-2-0/mais-opcoes/templates.md).

# Templates

Os **Templates** são mensagens padrão aprovadas pelo **WhatsApp**, utilizadas para iniciar um atendimento ativo por meio da [conexão oficial WABA (WhatsApp Business API)](/manual-digisac-2-0/conexoes-versao-antiga/whatsapp-business-api-waba.md).

Eles são obrigatórios para iniciar conversas fora da janela de 24 horas.

Para acessar essa área, no **Menu Principal**, clique em **Mais opções** e selecione a opção **Templates**.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FsbZVlJLIChEXKGuVum6o%2Fimage.png?alt=media&amp;token=4b00dec1-069f-4b6e-bdd4-f1e539295c5b" alt=""><figcaption></figcaption></figure>

***

### Como criar um Template

Na tela de **Templates**, clique em **Novo Template**.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FpOnkh46MY8cqyabPVoOk%2Fimage.png?alt=media&amp;token=794d3925-265d-42d4-adb1-d22d3623dbcd" alt=""><figcaption></figcaption></figure>

Em **Categoria**, selecione o tipo de template que deseja criar:

* **Marketing:** utilizado para promoções, ofertas e outras mensagens destinadas a aumentar o alcance e o engajamento.
* **Utilidade:** utilizado para atualizações de conta, status de pedidos, alertas e outras informações importantes.
* **Autenticação:** utilizado para o envio de códigos de verificação, como os necessários para acesso a contas.

Clique em **Próximo** para continuar a configuração.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FgtrSYHoRyTEaAALBhSJF%2Fimage.png?alt=media&amp;token=9df59f86-67e3-474f-bd46-50ab82109a41" alt=""><figcaption></figcaption></figure>

Em **Configurar**, preencha os campos necessários para solicitar o cadastro do template. A seguir, confira a explicação de cada campo:

* **Nome do modelo (na Digisac):** nome interno utilizado apenas para identificar o template dentro da plataforma. Essa informação **não é enviada à Meta**.
* **Nome do modelo:** defina o nome do template que será submetido para aprovação na Meta. O nome deve seguir as seguintes regras:

{% hint style="warning" %}
**Regras:**

* Utilizar apenas **letras minúsculas (a-z), números (0-9)** e **underscore (\_)**;

* Não utilizar letras maiúsculas, espaços ou caracteres especiais, como **hífen (-), ponto (.), #, @**, entre outros;

* Possuir no máximo **512 caracteres**.
  {% endhint %}

* **Conexão:** selecione a conexão oficial à qual o template será vinculado.

* **Idioma:** selecione o idioma do template entre **português**, **inglês** ou **espanhol**.

* **Tipo de mensagem:** selecione o formato do conteúdo que será utilizado no template:
  * **Somente texto:** permite criar um template composto apenas por texto.
  * **Mídia & Interativo:** permite criar um template com recursos de mídia e elementos interativos.

Clique em **Próximo** para prosseguir para a última etapa da configuração.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FyZntOrDoESMWOg0862iM%2Fimage.png?alt=media&amp;token=88b85e07-b590-4f93-8ff7-4bc1c13037f0" alt=""><figcaption></figcaption></figure>

Se escolhida a opção **Somente Texto**, na página **Conteúdo**, preencha o campo **Texto** com a mensagem que será enviada ao cliente. O campo permite até **1.024 caracteres**.

É possível utilizar **parâmetros** para tornar a mensagem mais dinâmica e personalizada. Para isso, os parâmetros devem seguir as regras definidas pela Meta:

{% hint style="warning" %}
**Regras:**

* devem ser **numéricos**;
* devem ser inseridos de forma **sequencial** (1, 2, 3...);
* devem estar entre **duas chaves de cada lado**;
* não é permitido inserir texto dentro das chaves.
  {% endhint %}

Para adicionar os parâmetros, clique em **+ Parâmetro** e arranje-os no texto da mensagem na posição desejada. Em seguida, preencha os campos exibidos abaixo do texto com os nomes correspondentes às variáveis utilizadas na mensagem.

Por exemplo, em uma mensagem com **{{1}}** e **{{2}}**, os parâmetros podem ser preenchidos como **nome do cliente** e **nome do atendente** respectivamente.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FusIwyCsl43UPqxG6GojF%2Fimage.png?alt=media&amp;token=085450b0-43c8-450c-8730-c34fdb127425" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Ao lado da configuração, na seção **Pré-visualização**, é possível visualizar como a mensagem será exibida, incluindo os **parâmetros** configurados.
{% endhint %}

Agora, se escolhida a opção **Mídia & Interativo**, na página **Conteúdo** serão exibidos os seguintes campos:

**Cabeçalho:** Escolha o tipo de conteúdo que deseja utilizar no cabeçalho: **Texto**, **Imagem**, **Documento** ou **Vídeo**. De acordo com a opção selecionada, preencha o campo **Texto** ou escolha uma **mídia de exemplo**.

* **Texto:** Preencha o título da mensagem, que será exibido em destaque (**negrito**). O conteúdo deve ocupar apenas uma linha, com até **60 caracteres**, e pode conter **1 parâmetro**, seguindo as mesmas regras descritas anteriormente.

{% hint style="warning" %}
Caso deseje incluir uma **imagem**, **documento** ou **vídeo** ao template, verifique os formatos e tamanhos máximos suportados:

* **Documentos:** `.txt`, `.pdf`, `.doc`, `.docx`, `.ppt`, `.pptx`, `.xls`, `.xlsx` — até **100 MB**
* **Imagens:** `.jpg` ou `.png` — até **5 MB**
* **Vídeos:** `.3gp` ou `.mp4` — até **16 MB**
  {% endhint %}

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2Fb99W2sIiBWisE3TuG6g7%2Fimage.png?alt=media&amp;token=01829f59-8736-4f7f-9b60-60f72255b3a0" alt=""><figcaption></figcaption></figure>

**Corpo:** No campo **Texto**, insira o conteúdo do template que será enviado ao cliente. O texto deve conter até **1.024 caracteres** e também pode utilizar **parâmetros** para tornar a mensagem mais dinâmica e personalizada.

Os parâmetros devem seguir as mesmas regras descritas anteriormente. Para adicioná-los, clique em **+ Parâmetro** e insira-os no texto na posição desejada. Em seguida, preencha os campos exibidos abaixo do texto com os nomes correspondentes às variáveis utilizadas na mensagem.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FiYVjxWycruBMtw85JHHD%2Fimage.png?alt=media&amp;token=c77198fa-f7d0-426b-b0ef-85edf7ce8eaf" alt=""><figcaption></figcaption></figure>

**Rodapé (opcional):** Insira uma mensagem complementar, que será exibida em tamanho menor. O conteúdo deve ocupar apenas uma linha, com até **60 caracteres**.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FmGSGBACrwyBMenFz8VYp%2Fimage.png?alt=media&amp;token=c93bbc42-85bf-4c6a-8308-850414dbaa71" alt=""><figcaption></figcaption></figure>

**Botões (opcional):** Permitem que o cliente interaja com a mensagem por meio de ações rápidas. É possível adicionar até **10 botões** em templates das categorias **Marketing** e **Utilidade**. Templates de **Autenticação** podem utilizar apenas **1 botão**, conforme as regras da Meta.

Para adicionar um botão, clique em **+ Adicionar**, ao lado do campo.

Os tipos disponíveis são:

* **Resposta rápida:** permite que o cliente envie uma resposta predefinida ao clicar no botão;
* **URL:** direciona o cliente para um link externo;
* **Número de telefone:** permite que o cliente realize uma ligação para o número configurado;
* **Solicitar informações do contato:** permite solicitar o compartilhamento do número de telefone de contatos identificados apenas por **username**. Ao clicar no botão, o cliente poderá compartilhar seu número por meio de um cartão de contato. O número recebido será associado automaticamente ao cadastro do contato existente na plataforma.
  * O texto do botão é definido pelo WhatsApp e **não pode ser editado**.

{% hint style="warning" %}
**Regras importantes:**&#x20;

* É possível utilizar até **10 botões de resposta rápida**;
* É possível utilizar até **2 botões de URL**;
* É possível utilizar **1 botão de telefone**;
* É possível utilizar **1 botão de** **informações do contato**;

O total combinado não pode ultrapassar **10 botões**.&#x20;

Além disso, os botões devem ser agrupados por tipo, sem intercalação.

**Exemplo válido:** URL; URL; Resposta rápida; Resposta rápida.

**Exemplo inválido:** URL; Resposta rápida; URL; Resposta rápida.
{% endhint %}

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2Fa5sItCSSFDcUCzjANZeL%2Fimage.png?alt=media&amp;token=d28f92a2-c3d4-4a86-a9a8-1aba4d0904a2" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Ao lado da configuração, na seção **Pré-visualização**, é possível visualizar como a mensagem será exibida, incluindo os **parâmetros** e **botões** configurados.
{% endhint %}

Por fim, clique em **Salvar** para gravar as configurações do template.&#x20;

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2Fn7pFHnYFxcxYuQ6XRhZe%2Fimage.png?alt=media&amp;token=34518278-8d4b-4e05-9fa0-f7679e22e268" alt="" width="351"><figcaption></figcaption></figure>

***

### Envio para aprovação

Após salvar o template, é necessário enviá-lo para aprovação da Meta. Para isso, siga o passo a passo abaixo:

1. No **Menu Principal**, clique em **Mais opções** e selecione **Templates**.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FsbZVlJLIChEXKGuVum6o%2Fimage.png?alt=media&amp;token=4b00dec1-069f-4b6e-bdd4-f1e539295c5b" alt="" width="563"><figcaption></figcaption></figure>

2. Na tela de template, clique nos **três pontinhos** do template que precisa ser aprovado e clique em **Enviar para análise**.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FsLVRH90VmQqyajWWgmjP%2Fimage.png?alt=media&amp;token=d3c24256-0074-4a74-9deb-cf05e77fabbc" alt=""><figcaption></figcaption></figure>

3. Preencha os **parâmetros com exemplos reais** para que a Meta consiga entender claramente o tipo de informação que será enviada em cada variável. Revise as informações do conteúdo do template e clique em **Enviar para análise** novamente para concluir o envio.

{% hint style="info" icon="circle-info" %}
Os exemplos inseridos nos parâmetros são apenas para análise e não serão fixos no envio final.
{% endhint %}

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FYO97geXVXp2RoZXirHbD%2Fimage.png?alt=media&amp;token=a9d2ee42-aca9-42b2-98a5-ca7ded583cf5" alt="" width="493"><figcaption></figcaption></figure>

{% hint style="info" icon="calendar-check" %}
Prazo de aprovação:

* Máximo de 7 dias
* Média de 24 horas

Você poderá acompanhar o status na tela de template, podendo ser pendente, aprovado ou rejeitado.
{% endhint %}

***

### Detalhes do Template

Para visualizar os detalhes do template, clique nos **três pontinhos** em **Ações** e selecione **Visualizar**.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FW95aZRG9UN0LVvS9Q6bI%2Fimage.png?alt=media&amp;token=7b46264e-e971-4360-970a-4b0862260342" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FGuO29qyyiXPTgl1kKHtM%2Fimage.png?alt=media&amp;token=856e8e2a-bb4f-4169-876d-6cbb4dc1e301" alt=""><figcaption></figcaption></figure>

Caso o template tenha sido **rejeitado**, será possível consultar o **Motivo da rejeição** informado pela Meta.

{% hint style="info" %}
O campo **Motivo da rejeição** será exibido somente para templates com status **Rejeitado** e que possuam um motivo informado.

**Importante:** a aprovação ou rejeição do template é realizada pela **Meta**. A Digisac apenas exibe o motivo retornado pela plataforma.
{% endhint %}

***

### Status dos Templates

Os templates podem apresentar os seguintes status:

* **Aprovado:** template aprovado pela Meta e liberado para envio.
* **Rejeitado:** template não aprovado pela Meta.
* **Pausado:** template temporariamente indisponível para uso.
* **Criado:** template cadastrado, mas ainda não enviado para aprovação.
* **Enviando:** template enviado e aguardando aprovação da Meta.

### Saúde dos Templates

Os templates também possuem um indicador de qualidade —  a **saúde do template** —  que pode variar conforme o desempenho e a interação dos usuários:

* **Pendente:** ainda não há dados suficientes para classificação (ex: templates recém-criados ou sem envios).
* **Alta:** template com boa aceitação, dentro das políticas e com alto engajamento.
* **Média:** template com desempenho regular, podendo apresentar baixa interação ou início de feedback negativo.
* **Baixa:** template com baixo desempenho, podendo ter denúncias ou não estar bem aderente às políticas da Meta.

***

### Como enviar um Template no Chat

Para utilizar um template:

1. Dentro do **Chat**, selecione um chamado com um contato da conexão oficial e clique em Abrir chamado.&#x20;

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FumZ6pyqOCi1Gxjzqireg%2Fimage.png?alt=media&amp;token=e4842427-ec0c-4bee-9fe5-e61cd74ac1f1" alt=""><figcaption></figcaption></figure>

2. Clique em **Enviar template**, selecione o template desejado e preencha o parâmetro (quando existir).

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2F5U1i6ItczrXlu4WTIZwi%2Fimage.png?alt=media&amp;token=ad4eedf1-587e-46a6-aa4b-d9f7864cec7c" alt=""><figcaption></figcaption></figure>

3. Clique em **Confirmar** para enviar o template.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FQk2RpPQeMSTZHkGreZ8Q%2Fimage.png?alt=media&amp;token=0453f27d-43ce-4c60-99c5-ddd22461c1f6" alt=""><figcaption></figcaption></figure>

Sempre que um template é enviado, inicia-se uma janela de **24 horas** dentro do chat.&#x20;

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FXniSz3eeculz7gtRByy5%2Fimage.png?alt=media&amp;token=ff35a374-292d-4b46-9eb6-2bb46630168d" alt=""><figcaption></figcaption></figure>

Somente após o cliente responder o template será possível enviar mensagens livremente.&#x20;

{% hint style="success" %}
O envio de templates também pode ser feito pelo botão com símbolo de **cifrão ($)**. Esse botão só aparece quando o contato já enviou alguma mensagem nas últimas 24 horas.
{% endhint %}

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2F5cC71lcdBJPBNQx4khOI%2Fimage.png?alt=media&amp;token=a2c4b8cd-686e-47bf-adaa-e91001bc21c8" alt=""><figcaption></figcaption></figure>

Ao tentar enviar um template com saúde baixa, a entrega pode não ocorrer. Para entender melhor o motivo, clique em **“Saiba mais detalhes”**.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2F4BQeLWOkJjiSQ6kDAjt9%2Fimage.png?alt=media&amp;token=e9c6e7a5-33e9-4962-a5cf-34d7229e13b1" alt="" width="375"><figcaption></figcaption></figure>

***

### Limite e Restrição de Envio de Template

Caso o tipo de conta selecionada no provedor seja da **Ikatec**, cuja gestão é realizada em conjunto com a Ikatec, o monitoramento do limite de envios de Templates será feito pelo **Suporte da Digisac**.

{% embed url="<https://youtu.be/xuJJ8r9NFRU>" %}

Para visualizar a quantidade de templates disponíveis, no Menu Principal, selecione **Mais Opções** > **Empresa**.&#x20;

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FqtAwMK4Kr0DYAXkfEVdi%2Fimage.png?alt=media&amp;token=8f44833c-953f-4f2a-8b89-90559d7d00ad" alt=""><figcaption></figcaption></figure>

Nessa modalidade:

* Será disponibilizado um limite de envios de Templates;
* O volume liberado seguirá o que foi acordado previamente;
* O controle se aplica tanto para **campanhas** quanto para **envios individuais de templates**.
* Ao atingir o limite configurado, o sistema exibirá uma notificação informando que o número máximo de envios foi alcançado.
* Enquanto o limite não for ajustado, novos envios de templates não poderão ser realizados, até que haja ajuste ou nova liberação.

Caso seja necessário ampliar a quantidade de envios:

* Entre em contato com o **Suporte da Digisac** para solicitar a liberação de um novo limite.
