> For the complete documentation index, see [llms.txt](https://sejasuri.gitbook.io/centraldeajuda/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sejasuri.gitbook.io/centraldeajuda/campanhas.md).

# Campanhas

## Sobre a tela de Campanha

As campanhas na plataforma Suri Shop by Totvs permitem que você envie mensagens em massa para vários contatos de forma organizada e eficiente, Mas diferentemente das listas de transmissão comuns do WhatsApp, onde é necessário que os números estejam salvos em seu dispositivo, na Suri Shop by Totvs você pode utilizar uma planilha para gerenciar seus contatos e personalizar suas mensagens.

Com a tela de campanhas liberada pelo time de suporte, você irá utilizar uma mensagem template aprovada pelo WhatsApp API para utilizá-la no envio da lista de clientes.\
\
[Entenda como criar uma mensagem template.](/centraldeajuda/master/mensagens-templates-e-mensagens-rapidas.md)

## **Como Funciona a Tela de Campanhas**

1. **Acesso à Aba de Campanhas**: No painel principal da Suri Shop by Totvs, selecione a aba "Campanhas".
2. **Preparação da Planilha**:
   * Faça o download da planilha, de acordo com a mensagem template escolhida
   * Organize as informações na coluna pré-existentes incluindo dados que serão utilizados para personalizar as variáveis das mensagens.
3. **Envio de Mensagens**:
   * Selecione uma mensagem template previamente aprovada pelo WhatsApp.
   * Faça o upload da planilha com os contatos.
   * Acompanhe o status de cada mensagem, verificando entregas, leituras e respostas dos clientes.

**Custos Associados às Campanhas**

* **Custo por Mensagem**: Embora o uso da ferramenta de campanhas seja gratuito em todos os planos de assinatura da Suri Shop by Totvs, há uma cobrança por cada mensagem entregue ao cliente. Este custo é determinado pelo WhatsApp e varia conforme a categoria da mensagem template aprovada, para que possa verificar os respectivos valores de mensagens enviadas é indicado que verifique com o time de suporte Suri Shop by Totvs.
* **Observações**:
  * Apenas as mensagens efetivamente entregues serão cobradas. Dessa forma, é importante saber que se durante o mês x sua empresa enviar 10 mensagens templates para esse contato único, haverá uma cobrança por cada mensagem enviada ao contato.
  * Os valores dos boletos referentes as cobranças do uso da tela de campanha são enviados pelo time do financeiro, por e-mail ou pelo WhatsApp.
  * A Meta cobra pelo envio de templates e por isso essas mensagens enviadas, seja para contatos únicos ou não serão cobradas.<br>

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

## Uso de mídias nas campanhas

Para garantir o envio correto de mídias nas campanhas, é fundamental seguir as configurações de uso definidas pela API. Abaixo estão os formatos e tamanhos permitidos para cada tipo de arquivo:

* **Imagem**: Deve estar no formato **JPEG** ou **PNG**, com tamanho máximo de **5MB**.
* **Vídeo**: Apenas no formato **MP4**, com tamanho máximo de **16MB**.
* **Arquivo**: Apenas documentos no formato **PDF**, com tamanho máximo de **100MB**.

**Atenção:** Caso a mídia utilizada ultrapasse o limite de tamanho ou esteja em um formato não compatível, o envio da campanha não será realizado, impedindo assim que seus clientes recebam a mensagem.

Para evitar problemas, sempre revise os arquivos antes do envio e, se necessário, utilize ferramentas de compactação ou conversão para adequá-los aos padrões exigidos.

## Configurando uma template com botões

Caso sua mensagem template possua botões é necessário realizar uma configuração de direcionamento, onde no campo *"Comportamento por botão"* você irá realizar o ajuste de botão 1 em comportamento  escolhendo entre transbordar ou direcionar para o fluxos, onde após essa configuração você irá clicar novamente no comportamento por botão e configurar o botão 2.<br>

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

## Como criar uma Campanha?

Clique em **+Nova Campanha**

![](/files/KQXlHUDHlDtKAxvMauzb)

E preencha o campo **Nome**, com o titulo da sua campanha. Você pode agendar o envio marcando a bolinha de **Agendar Campanha**, caso queira enviar **manualmente deixe desmarcada**. Em **Contatos**, você irá adicionar a planilha que você organizou os números de telefone.

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

Na tela de **Ações**, você irá selecionar o modelo de mensagem template aprovado pelo WhatsApp que será enviado aos clientes. Lembrando que só é permitido enviar uma template.

Abaixo em **Reposta**, você irá definir qual o comportamento que a Suri Shop by Totvs vai realizar ao identificar a resposta do cliente, escolhendo se vai: **transbordar** para um departamento ou **enviar alguma intenção** ajustada nos fluxos, como por exemplo, uma cadência de perguntas até transferir para o humano.

### ⚠ Muita atenção na planilha!

* Certifique-se de que a planilha esteja corretamente formatada, com os números de telefone no formato internacional (incluindo código do país e DDD) e sem caracteres especiais.
* Preencha todas as colunas correspondentes às variáveis utilizadas na mensagem template, garantindo que cada campo contenha as informações corretas para personalização.
* Não é permitido utilizar fórmulas do Excel dentro da planilha encaminhada.<br>

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

\
Você pode realizar o download do modelo da planilha clicando no botão azul *"Baixar planilha modelo"* (conforme exemplo da imagem acima ⬆).

**Importante:**

🔸**Não** é permitido utilizar fórmulas do Excel dentro da planilha\
🔸Coloque a coluna do número em célula **Especial**\
**🔸Todos os números precisam ter 55 + DDD + NÚMERO**\
**🔸**Se tem um número de WhatsApp é **número fixo** coloque um **0 antes do DDD**\
**🔸**As colunas precisam ter o **cabeçalho**: Número (obrigatório), Variável 1, Variável 2 (caso tenha)\
🔸\*O valor final das sessões ativas depende do plano e do que foi acordado na venda.<br>

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

\
Prontinho, feito isso! Agora é só clicar em **iniciar** e acompanhar as entregas!\
\
Confira o uso no vídeo abaixo:

{% embed url="<https://www.loom.com/share/3369048951444cf9a5286137a7602131>" %}

<p align="center"><em><strong>não é permitido o uso de fórmulas do Excel na planilha</strong></em><br></p>

## Como Criar uma Campanha usando fluxos específicos e tags

No vídeo abaixo, você aprenderá como criar uma campanha com um fluxo personalizado, utilizando tags para organizar e categorizar suas interações. Isso permitirá que você extraia relatórios detalhados no futuro, garantindo uma análise eficiente e precisa dos dados da campanha.

Confira o  vídeo:

{% embed url="<https://www.loom.com/share/ea21b59f6fb14968b96c78ecbba79307>" %}

<p align="center"><em><strong>não é permitido o uso de fórmulas do Excel na planilha</strong></em><br></p>

## **Requisitos de Formato e Tamanho de Arquivos**

Vale relembrar que, se a sua campanha tiver alguma mídia é fundamental que sega as configurações de uso definidas pela API:

* **Imagem**: Formatos compatíveis: **JPEG** ou **PNG**, com tamanho máximo de **5MB**.
* **Vídeo**: Apenas no formato **MP4**, com limite de **16MB**.
* **Arquivo**: Exclusivamente **PDF**, com tamanho máximo de **100MB**.Observação: Vídeos em **.MOV** do sistema IOS não são permitidos de serem enviados e reproduzidos pela API, ou seja, caso envie um vídeo nesse formato o seu cliente não receberá a mensagem. Já para o sistema operacional Android os vídeos não podem ter vídeos com resolução acima de 720 x 1280.

&#x20;**Atenção**: Se algum arquivo ultrapassar o tamanho permitido ou estiver em um formato não compatível, **o envio da campanha não será concluído**, impossibilitando o recebimento da mensagem pelos clientes.\
\
**Observação:** Vídeos em **.MOV** do sistema IOS não são permitidos de serem enviados e reproduzidos pela API, ou seja, caso envie um vídeo nesse formato o seu cliente não receberá a mensagem. Já para o sistema operacional Android os vídeos não podem ter vídeos com resolução acima de 720 x 1280.

Para evitar problemas, sempre revise os arquivos antes do envio. Caso necessário, utilize ferramentas de **compactação ou conversão** para ajustá-los aos requisitos exigidos.\ <br>

## Impedimentos de envio em campanhas

Em algumas situações, uma campanha pode apresentar impedimentos no envio de mensagens para determinados contatos, gerando **"erros"** ou **"falhas de processamento"**.<br>

**Acesse a campanha com impedimentos** diretamente na plataforma.

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

<br>

**Baixe os relatórios de erros**:

Ao acessar a campanha, você poderá pode efetuar o download das "falhas de processamento" no parte inferior direita da plataforma. Já para acessar os "erros" seria no canto superior direito em Exportar.

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

\
Após o download, será possível identificar os motivos dos impedimentos. Abaixo, listamos os mais comuns:

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

**1. "Possíveis motivos: número não é WhatsApp, está usando versão do WhatsApp desatualizada ou a Meta optou por não entregar a mensagem para manter o engajamento saudável."**

Esse erro normalmente indica que o número incluído na campanha não está cadastrado no WhatsApp, e você pode verificar se o número está disponível usando o [wa.me/](https://faq.whatsapp.com/425247423114725/?locale=pt_BR\&cms_platform=iphone).&#x20;

\
**2. "O número do contato faz parte de um experimento da Meta para não receber templates de Marketing. Tente enviar um template de Utilidade."**

Nesse caso, o contato participa de um experimento da Meta no qual **não é permitido o recebimento de mensagens da categoria Marketing**.\
A solução é tentar o envio com um **template de categoria Utilidade**.

\
**3. "Meta optou por não entregar. Mensagem não foi entregue para manter o engajamento saudável."**

Esse erro indica que o contato **tem um histórico de não interagir com mensagens de Marketing**, o que levou a Meta a bloquear o envio da campanha para esse número, **preservando a reputação do seu remetente**.\
Nesses casos, recomenda-se o envio manual de um **template da categoria Utilidade**.

\
**4. "Mensagem não enviada devido a restrições sobre este número de telefone (muitas mensagens anteriores foram sinalizadas como spam)."**

Esse contato tem um histórico negativo, indicando mensagens anteriores como spam.\
Por isso, o envio de mensagens de Marketing para esse número **não é permitido**. Evite novos envios para manter a reputação da sua conta.
