# Campanhas

## Sobre a tela de Campanha

As campanhas na plataforma Suri 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 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, 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, 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.
* **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 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.


---

# 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://sejasuri.gitbook.io/centraldeajuda/campanhas.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.
