# Templates

Os templates utilizados na integração devem ser criados diretamente no painel de gestão da spread.chat. Isso porque realizamos o envio para aprovação da Meta de forma automática. Certifique-se de criar e configurar os templates necessários no painel de gestão para garantir um processo de envio suave e eficiente.

Essa aprovação é necessária devido ao uso da API oficial da Meta para conectar o WhatsApp. Como a API permite disparos em massa, é importante garantir que todas as conversas sejam iniciadas através desses templates. Isso permite que o WhatsApp identifique que nenhum conteúdo que viole suas diretrizes de uso esteja sendo disseminado

### Categorias de templates

1. **Marketing**

Esses templates são os mais flexíveis e podem conter conteúdo mais genérico, como inícios de conversa ou informações comerciais, incluindo promoções, ofertas, atualizações e convites. As conversas que não se enquadram nas categorias de utilidade ou autenticação são consideradas de marketing pela Meta.

<details>

<summary>Exemplos</summary>

"Compre 2 cafés ou mais e receba R$ 5,00 de desconto." \
"Agradecemos o seu pedido! Use o código SAVE20 para receber 20% de desconto no próximo pedido." \
"Olá! Este é o nosso perfil no WhatsApp." \
"Tenha um bom dia." \
"Nossa loja mudou de endereço. Venha conhecer!" \
"Estaremos fechados na próxima segunda-feira devido ao feriado." "Boas notícias! O produto que você salvou está de volta ao estoque." "Participe do nosso evento de final de ano." \
"Estes são os cupons de desconto deste mês. Boas compras!" \
"Você vai adorar esta novidade! Confira o nosso novo sabor de sorvete." "Agradecemos o seu pedido. Queremos saber a sua opinião. Clique aqui." \
"Esqueceu de algo? Guardamos os seus itens. Clique aqui para finalizar a compra." \
"Sua inscrição está te esperando. Clique aqui para concluir." \
"Você perdeu a sua consulta. Clique aqui para remarcar."

</details>

2. **Utilidade**

Esses templates são usados para informar sobre solicitações, transações ou atualizações específicas, como notificações pós-venda e extratos de faturas recorrentes.

<details>

<summary>Exemplos</summary>

"O pedido #0021 foi confirmado"\
"O check-in foi concluído. Aqui está o seu cartão de embarque para o voo." \
"Agradecemos a sua reserva. Até a semana que vem!" \
"O pagamento foi recebido. Aproveite o show!" \
"Seu pedido foi cancelado. O reembolso levará 7 a 10 dias para ser processado." \
"Lembrete: você tem uma consulta agendada para terça-feira às 13h." \
"Aqui está o extrato mensal que você solicitou"

</details>

3. **Autenticação**

Esses templates permitem que as empresas autentiquem os usuários com senhas de uso único em várias etapas do processo de login, como verificação de conta, recuperação de conta e desafios de integridade.

<details>

<summary>Exemplos</summary>

"Seu código de autenticação é 123123."\
"Sua nova senha é 123123."

</details>

{% hint style="warning" %}
É possível usar o modelo padrão disponibilizado pela Meta ao selecionar a categoria de Autenticação. Além disso, é possível escolher se a mensagem será enviada com ou sem a ação de botão para copiar o código enviado. Para associar o conteúdo, basta selecionar a propriedade no campo abaixo da categoria
{% endhint %}

<figure><img src="/files/tNR7AwafWDvZDDESNiNJ" alt="" width="563"><figcaption></figcaption></figure>

### Criando um novo template!&#x20;

Para criar um novo template, basta acessar a aba de templates no painel de gestão, onde você encontrará o botão "Novo template". Ao clicar nele, você será redirecionado para o pop-up de criação, onde poderá configurar o template conforme necessário.

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

1. **Nome**.

Importante colocar um nome como referência para o template que seja compatível com o conteúdo de mesmo.&#x20;

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

{% hint style="warning" %}
**Importante:** Nomes de template **não podem conter caracteres especiais** **ou emoji**, caso contrário, não serão aceitos/enviados para aprovação da Meta.&#x20;
{% endhint %}

2. **Conteúdo do Template.**

O conteúdo do template pode ser inserido, e as variáveis do template devem ser colocadas entre '{{}}', conforme o exemplo abaixo.

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

Não há limite para o número de variáveis que podem ser incluídas nos templates, com isso você pode ter campos personalizados em todo os seu conteúdo.

{% hint style="warning" %}
**Importante:** De acordo com as especificações recentes da Meta, os conteúdos de template **não podem começar nem terminar com uma variável**.
{% endhint %}

3. **Identificação das variáveis.**&#x20;

Todas as variáveis incluídas devem ser associadas a uma propriedade na lista de seleção extraída diretamente do HubSpot. Além disso, é necessário fornecer um exemplo literal dessa propriedade para que a Meta possa visualizar a variável na prática.

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

4. **Categoria.**

Nesta etapa, é necessário selecionar a categoria à qual o template pertence, com base nas informações apresentadas no tópico "***Categorias de templates"*** acima. Além disso, deve-se escolher o idioma no qual o template será enviado.

<figure><img src="/files/6makQ62pqWawOraMqrye" alt=""><figcaption></figcaption></figure>

5. **Idioma.**

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

6. **Fonte de envio**.&#x20;

Aqui, identificamos a fonte de envio do template, que pode ser: Workflow (para disparos em massa) e Contact (para disparos via timeline).

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

Os templates de contato são utilizados para iniciar conversas individuais diretamente pela timeline do contato. É essencial que todos esses templates estejam configurados e aprovados, permitindo que os atendentes tenham acesso livre para utilizá-los em suas operações. Da mesma forma, os templates do tipo Workflow são disponibilizados para uso em disparos em massa, dentro dos fluxos de trabalho.

É vantajoso criar um template com apenas um dos tipos, pois isso evita o acúmulo desnecessário de templates para atendentes e criadores de fluxos

{% hint style="warning" %}
**Importante:** Um template pode ser criado com ambas as formas de fonte de envio: Workflow e Contact. Neste caso, ficará disponível em ambos os ambientes.
{% endhint %}

7. **Tipo do template.**&#x20;

Você pode selecionar o tipo de template que deseja, seja ele **Padrão**, **Midia e Interativo** ou **Carousel**.

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

* **Padrão:** É um modelo simples, onde o conteúdo será apenas o texto.
* **Mídia e interativo:** É um tipo de template interativo que permite adicionar cabeçalhos, rodapé, respostas rápidas, CTA.&#x20;
* **Carousel:** Permite exibir **vários cards deslizáveis** dentro de uma mesma mensagem.&#x20;

### Tipo de Template: Carousel&#x20;

Quando seleciona a opção Carousel é possivel criar templates compostos por cards deslizáveis dentro de uma mesma mensagem. Cada card pode conter uma **mídia (imagem ou vídeo)**, um **texto descritivo** e **botões de ação.**

* **Tipo de mídia:** Nesta etapa você escolhe o tipo de conteúdo visual que vai aparecer em cada cartão,:

  * **Imagem:** adiciona uma foto estática (ideal para produtos, banners, etc).
  * **Vídeo:** adiciona um vídeo curto (ideal para demonstrações rápidas).

  <figure><img src="/files/3w9dkyBYI1OJPoEtx3Ar" alt="" width="485"><figcaption><p>Painel de Gestão - Templates</p></figcaption></figure>
* **Texto do corpo do cartão:** Aqui nesse espaço você irá descrever o conteúdo do card.
* **Tipo de botão:** Você pode adicionar **botões de ação** ao card. Existem dois tipos disponíveis:

  * **Quick reply:** Botão de resposta rápida. Quando o usuário clica, ele envia automaticamente a resposta para o chat.
  * **URL:** Botão que direciona o usuário para um **link externo** (ex: site, catálogo, landing page, etc).

  <figure><img src="/files/KMXIKgN0enX3cz7wIyLJ" alt="" width="545"><figcaption></figcaption></figure>
* **Texto do botão:** Aqui você define o texto que vai aparecer no botão.

<figure><img src="/files/7VILvbprKJK26rT4GFiN" alt="" width="542"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Atenção:** É possível adicionar até 10 cards no Carousel. As especificações dos tipos de mídia seguem o mesmo padrão definido pela Meta, conforme citado neste material.
{% endhint %}

### Tipo do Template: Mídia e Interativo

Ao selecionar a opção **Mídia e Interativo**, é possível configurar elementos adicionais à mensagem, como cabeçalho com imagem, vídeo ou documento; botões de resposta rápida do tipo simples ou CTA ; rodapé com informações complementares ou OPT-OUT.

* **Imagens**:&#x20;

As imagens podem ser adicionadas como header de um texto ou de uma call to action, como mostra os exemplos abaixo.&#x20;

<figure><img src="/files/OL6wJ23ZATcvoPoKmuQT" alt=""><figcaption><p>Template com imagem no header, texto no footer e um link de acesso rápido call to action.</p></figcaption></figure>

<figure><img src="/files/cdh0MlN4TuzucnsATNPa" alt=""><figcaption><p>Template com imagem no header.</p></figcaption></figure>

Para inserir uma imagem no template, bata selecionar "imagem" no campo de cabeçalho e inserir a imagem desejada.&#x20;

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

{% hint style="success" %}
**Dica:** As especificações de imagem que podem ser incluídas no templates pela meta são: imagens de até 5MB em um dos arquivos image/jpeg ou image/png.
{% endhint %}

* **Vídeo**

Assim como as imagens, os vídeos podem ser enviados como cabeçalho para um texto.

<figure><img src="/files/Mlk7nynhApWSueJinorj" alt=""><figcaption><p>Template com vídeo no header, duas variáveis preenchidas (local e horário) e texto no footer.</p></figcaption></figure>

Para inserir uma vídeo no template, bata selecionar "video" no campo de cabeçalho e inserir o arquivo desejado.

{% hint style="success" %}
**Dica:** As especificações de vídeo que podem ser incluídas no templates pela meta são: Vídeos de até 16MB em um dos arquivos video/mp4 ou video/3gp.
{% endhint %}

* **Documentos**

Arquivos podem ser incluídos no template da mesma maneira que os vídeos e imagens.

{% hint style="success" %}
**Dica:** As especificações de documentos que podem ser incluídas no templates pela meta são: Documentos de até 100MB em um dos arquivos text/plain, application/pdf, application/vnd.ms-powerpoint e application/msword
{% endhint %}

* **Call to Action**

Essa opção permite adicionar um link de acesso rápido diretamente no template.

<figure><img src="/files/cJ841Fvlr4DrRWswYqYC" alt=""><figcaption><p>Template com call to action contendo um link.</p></figcaption></figure>

Para incluir um link, basta incluir a opção call to action no campo de respostas rápidas.&#x20;

<figure><img src="/files/2gogVN2Rqsh2ZVV4B9nn" alt=""><figcaption></figcaption></figure>

É necessário acrescentar uma resposta rápida, que vai direcionar o contato para a ação desejada ao clicar. Este link pode redirecionar para um URL especifica, ou seguir com ligação telefônica.&#x20;

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

* **Respostas rápidas**

As respostas rápidas podem ser incluídas no template para direcionar o caminho do contato, permitindo que eles sigam a conversa ou ignorem determinada parte dela. As respostas rápidas são limitadas a três botões.

<figure><img src="/files/zdWybKIAc974lXSCa5Zg" alt=""><figcaption><p>Template com respostas rápidas padrões.</p></figcaption></figure>

É possível incluir as respostas rápidas no botão indicado, e atribuir a elas as ações de **"Seguir conversa"** ou **"Ignorar resposta"**.\
Diferente de "Seguir conversa", ao selecionar "ignorar resposta" a conversa será **finalizada sem direcionamento para atendimento humano**.

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

{% hint style="warning" %}
**Importante:** Botões de texto e CTA **não** podem **conter caracteres especiais ou emoji**, caso contrário, não serão aceitos/enviados para aprovação da Meta.&#x20;
{% endhint %}

### Status de aprovação

Após cadastrar o template no painel de gestão, ele será automaticamente enviado para aprovação pela Meta. Somente após a aprovação, o template estará apto para uso. O status do template pode ser acompanhado na coluna "STATUS" no painel. Se a sua conta tiver mais de um número, a aprovação dos templates será enviada para todos os números cadastrados.

Aqui estão as referências para acompanhar a aprovação no painel da Spread:

| Status   | Descrição                        |
| -------- | -------------------------------- |
| Aproved  | Template aprovado pela Meta.     |
| Pending  | Template pendente de aprovação.  |
| Rejected | Template não aprovado pela Meta. |

{% hint style="success" %}
**Dica:** Se o template for rejeitado, recomendamos revisar o material de referência já disponibilizado, aplicar os ajustes necessários e, em seguida, enviar uma nova solicitação.
{% endhint %}

### Tempo de aprovação

O facebook passa um período de **até 48 horas para realizar a aprovação dos templates**. O retorno geralmente acontece de forma rápida, porém há **o teto de até 48 horas que deve ser considerado**. Desta forma, o **indicado é sempre se anteceder ás operações e criar os templates antecipadamente**, para que não haja atrasos e impedimentos.&#x20;


---

# 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://help.rvops.com/spread.chat/painel-de-gestao/templates.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.