> 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/campanhas/campanha-waba-whatsapp-business-api.md).

# Campanha Waba (WhatsApp Business API)

Para usar campanhas via WhatsApp, é necessário possuir a conta WhatsApp Business API contratada e realizar o processo de aprovação e verificação da mesma. [Clique aqui para saber mais sobre estes trâmites](/manual-digisac-2-0/conexoes-versao-antiga/whatsapp-business-api-waba.md).&#x20;

***

### **Como criar uma Campanha WABA**

1. Na seção Campanha (ícone de **megafone** do Menu Principal), clique em **+ Adicionar**.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FC4pez52jE4qa2kUgF2Uv%2Fimage.png?alt=media&amp;token=379f3e98-c972-4d52-a947-023d70f519ff" alt=""><figcaption></figcaption></figure>

2. Na nova tela, selecione **WhatsApp Business API** e clique em **Próximo**.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FLuKG2KvTAbY6AKLq5B1u%2Fimage.png?alt=media&amp;token=fd6f84d9-6c3b-4751-a8f0-184665feefae" alt=""><figcaption></figcaption></figure>

3. Em **Configurar**, preencha as informações da campanha:
   * **Nome:** Informe o nome da campanha.
   * **Tipo de conexão:** Selecione **WhatsApp Business API**.
   * **Conexão:** Selecione a **conexão** **oficial** que será utilizada no envio.
   * **Outras configurações:** Caso necessário, habilite as opções:
     * **Abrir chamado ao enviar a campanha:** Cria automaticamente um atendimento para cada contato que receber a campanha.
     * **Agendamento de campanha:** Permite programar a data e o horário para o envio da campanha.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FjzkZBWwFJPGtrMFsnSjF%2Fimage.png?alt=media&amp;token=4483233a-7336-41ab-91a4-b11264ae725a" alt=""><figcaption></figcaption></figure>

4. Clique em **Próximo** para continuar a configuração da campanha.
5. Em **Conteúdo**, selecione o **Template** cadastrado previamente que será utilizado no envio da campanha.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2F4QR6NNi5wPFuGe7dTFLW%2Fimage.png?alt=media&amp;token=04c3b4e7-9f18-4bde-92f0-6b656e6b4fa7" alt=""><figcaption></figcaption></figure>

6. A partir da escolha do template, novos campos serão disponibilizados. Em **Disparo**, defina o público da campanha utilizando tags ou importando uma lista de contatos. Ao selecionar:&#x20;
   * **Tags:** será exibido um campo para informar as tags vinculadas aos contatos. Nesse caso, a campanha será enviada **apenas para os contatos que possuírem as tags selecionadas**.
   * **Importar contatos:** será exibido um campo para anexar um arquivo CSV com a lista de contatos. Para isso, clique em **Baixar o modelo**, preencha o arquivo com os contatos desejados e, depois, clique em **Selecionar o arquivo** para importá-lo na plataforma.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FtJOCBXzC8OSvcxakcazr%2Fimage.png?alt=media&amp;token=7652e3b3-1ea2-4ea9-913b-480f8be98724" alt=""><figcaption></figcaption></figure>

7. Em **Tipo de Envio**, há duas opções de API para disparo, e a disponibilidade de cada uma depende do tipo de template e do status da conta no MM Lite:

* MM Lite; e
* Cloud API.

{% hint style="info" %}
O **MM Lite** pode ser utilizado exclusivamente em templates do tipo **Marketing**. Para campanhas com outros tipos de template, o envio estará disponível apenas via **Cloud API**.
{% endhint %}

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FQVW6lTFTKN3ZHOoTs38u%2Fimage.png?alt=media&amp;token=6b88b61c-761c-4baf-8179-b77ce3faca23" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Para usar o **MM Lite**, o cliente deve aceitar os termos de uso diretamente na BusinessManager (BM) da Meta.

A conta pode estar em um dos seguintes status:

* **Inelegível:** O  &#x20;MM Lite não está disponível. Apenas a opção Cloud API  \
  será exibida. Todas as campanhas seguem exclusivamente pelo Cloud API.
* **Elegível:** O **MM Lite aparece como opção**, porém **ainda não pode ser selecionado**, pois precisa ser ativado pelo cliente. O **Cloud API permanece como envio padrão**.
* **Integrado:** O **MM Lite está liberado para uso**. Todas as campanhas de marketing seguirão exclusivamente pelo MM Lite.
  {% endhint %}

8. Após preencher todas as informações, clique em **Salvar** para finalizar a criação.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2F6tjt9vkkKOZyzhu1ftxe%2Fimage.png?alt=media&amp;token=522b214c-10d5-4df8-af54-5c364e5f6c68" alt=""><figcaption></figcaption></figure>

9. Se não tiver agendamento, o envio deve ser feito manualmente. Para isso, ao lado da campanha criada, selecione **Ações (3 pontinhos)** > **Enviar campanha**.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FHpLKXt5bUQahUS4BFob7%2Fimage.png?alt=media&amp;token=3e3a3bb4-55da-4de0-8df1-8b5d45313a98" alt=""><figcaption></figcaption></figure>

Pronto! Após isso, o envio ocorrerá a todos contatos selecionados e você pode acompanhar o status de entrega na própria página de Campanhas.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FgIn58e7APYacEraDChw2%2Fimage.png?alt=media&amp;token=eda33dd5-7c65-4514-9c95-fb62af9492fc" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Pausa Preventiva:** caso ocorra alguma situação sensível durante o envio da campanha — como a queda do template para qualidade baixa — a campanha será **pausada automaticamente**, com a indicação do motivo. Essa funcionalidade reduz o risco de banimento, garante mais estabilidade para a operação e oferece maior segurança nos envios em todos os canais da plataforma.
{% endhint %}

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FINYGC8RqwEkUl7IdA9ry%2Fimage.png?alt=media&amp;token=1ea0d05b-8962-4843-86d2-2cab4563ea79" alt=""><figcaption></figcaption></figure>

***

### **Acompanhamento - Relatório de Campanhas**

Assim como nas campanhas de SMS, após sua criação e/ou envio, você pode acompanhar as informações da campanha. Para isso:

* Na seção campanhas, acesse **Ações (3 pontinhos)** > **Visualizar**

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FCxJ1JTZf7AiKTnDnJUUY%2Fimage.png?alt=media&amp;token=ff02e21d-3be1-4efc-8248-693fbc0e21cb" alt=""><figcaption></figcaption></figure>

Nesta área, você poderá:

* Exportar os resultados da campanha em uma planilha .**csv**, ao clicar no botão **Exportar**, no canto superior direito.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2Fg7Bx3IKZknDViegRiKZI%2Fimage.png?alt=media&amp;token=3aafb932-395e-4fc4-862b-7a5519567efb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Importante:** o arquivo utiliza **ponto e vírgula (;)** como separador. Os números de telefone são exportados com o DDI completo. Para evitar alterações na formatação dos números ao abrir o arquivo no Excel, recomenda-se importá-los como **texto**.
{% endhint %}

* Ver gráficos e detalhes das entregas.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2FfKMIauxOzbwiqbTQUu5q%2Fimage.png?alt=media&amp;token=077b1599-53c2-4f0b-8528-8d22c695f656" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Ao clicar em **Ver detalhes** em um gráfico, você poderá visualizar informações adicionais sobre a seção e campanha. Para retornar à visualização do gráfico, clique em **Ver gráfico**.
{% endhint %}

* Informações detalhadas sobre os contatos da campanha.

<figure><img src="https://1814036563-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MfJsMJqevSfkQd5v__H%2Fuploads%2F4j5o2PDBJJFWEeS5BOoQ%2Fimage.png?alt=media&amp;token=4c12cae8-865c-426f-8d60-9efa61006e88" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Importante:** Agora a seção **Informações dos contatos** apresenta as colunas **Número** e **Username**. Quando o contato não possuir um telefone cadastrado, será exibido o **username** do WhatsApp, caso esteja disponível.

No relatório, também poderá ser exibido o motivo **Erro de username - Não houve contato anterior** quando não for possível localizar o contato pelo username informado.
{% endhint %}

#### Status das Mensagens

Os status das mensagens indicam o retorno do **WhatsApp (Meta)** em relação ao envio e recebimento da mensagem.

Os status disponíveis são:

* **Enviada:** a mensagem foi enviada com sucesso pela plataforma.
* **Não enviada:** a mensagem não foi enviada.
* **Recebida:** a mensagem foi entregue ao destinatário.
* **Lida:** a mensagem foi visualizada pelo destinatário.
* **Respondida:** o cliente respondeu a mensagem enviada.
* **Em avaliação de qualidade pela Meta:** status temporário indicando que a mensagem está passando por uma análise de qualidade da Meta antes do envio. A mensagem ainda poderá ser entregue posteriormente.
* **Cancelado por avaliação de qualidade da Meta:** indica que a mensagem foi descartada após a avaliação da Meta.

{% hint style="warning" %}
Devido às políticas da Meta, algumas mensagens podem passar por uma análise de qualidade antes de serem entregues ao destinatário. Esse processo é conhecido como **WhatsApp Pacing Mechanism**.

Quando isso acontece, a mensagem poderá ficar temporariamente com o status:

* **Retida para avaliação**

Nesse cenário, a mensagem ainda não falhou. Ela está apenas em análise e poderá ser enviada normalmente após a validação da Meta.

Caso a Meta identifique problemas relacionados aos seus critérios internos de qualidade, o status poderá ser alterado para:

* **Descartada por qualidade**

&#x20;**Importante:** esses status são definidos diretamente pela Meta/WhatsApp e não representam um erro técnico da plataforma Digisac.
{% endhint %}
