# Como criar e enviar campanhas de WhatsApp no Vambe

Guia completa para preparar seu arquivo, configurar sua campanha e enviá-la de forma controlada.

Este guia explica passo a passo como criar uma campanha de WhatsApp no Vambe, como preparar corretamente seu arquivo de contatos, como carregá-lo, validar as informações e, por fim, enviar a campanha cumprindo as políticas da Meta.

{% hint style="info" %}
Pré-requisitos:

* Ter um número de [WhatsApp Business API](https://academy.vambe.ai/c%C3%B3mo-conectar-whatsapp-api-oficial) ou [Dual](https://academy.vambe.ai/c%C3%B3mo-conectar-un-n%C3%BAmero-de-whatsapp-business-a-vambe-mediante-el-m%C3%A9todo-h%C3%ADbrido-api-qr) conectado no Vambe.
* Ter uma [modelo](/canal/canal-pt-br/modelos/como-crear-plantillas.md) de WhatsApp aprovada e disponível para o canal.
* Preparar um arquivo Excel ou CSV com:
  * `telefone` (formato internacional E.164: +56…, +52…, +57…, etc.)
  * `nome`
  * Colunas adicionais de acordo com as variáveis do template (ex.: `var_1`, `var_2`, `var_3`… )

No passo 2 você poderá baixar um arquivo de exemplo com as colunas exatas que seu template exige.
{% endhint %}

***

#### Passo 1: Criar a Campanha

1. No menu lateral esquerdo, vá para **Canais** e depois para a aba **Campanhas**.
2. Clique no botão azul **+ Criar campanha** no canto superior direito.

<figure><img src="/files/0a9dfdb40903c46f50f9e79f206b18f1018e8bbd" alt=""><figcaption></figcaption></figure>

Será aberta uma janela de configuração onde você deve preencher os dados básicos:

* **Título**: Um nome interno para identificá-la (Ex: "Promo Cyber").
* **Canal**: Escolha de qual número de WhatsApp a mensagem será enviada.
* **Etapa de entrada** (Opcional): Se você selecionar uma etapa aqui, todos os clientes que responderem à campanha serão movidos automaticamente para essa coluna do funil.
* **Template**: Selecione a mensagem que você enviará.
  * *Observação:* Se seu template não aparecer, verifique se ele está aprovado e disponível para esse canal específico.

<figure><img src="/files/900db59d775178b39fb8427c7b5ca602570d9697" alt=""><figcaption></figcaption></figure>

***

#### Passo 2: Selecionar os Destinatários

Aqui você tem dois caminhos: carregar um Excel externo ou usar seus contatos salvos no Vambe.

**Opção A: Usando um arquivo Excel**

<figure><img src="/files/021b710e37e904d4136e3249ada785f192714a34" alt=""><figcaption></figcaption></figure>

Ideal se você tiver uma base de dados externa.

1. Selecione a opção **Excel**.
2. **Personalizar Colunas**: Você verá os campos que seu template exige (Ex: `{{1}}`, `{{2}}`). Você deve atribuir a eles um nome de coluna para seu Excel (Ex: "Nome", "Desconto").

   * *Dica:* Você pode adicionar campos de "Metadata" fixos se precisar guardar informações extras que não vão na mensagem.

   <figure><img src="/files/c22558203d6416f58e674add729661288828cc51" alt=""><figcaption></figcaption></figure>
3. **Baixar Exemplo:** Clique em Baixar e atualizar template. Isso lhe dará um arquivo Excel vazio com as colunas exatas que você precisa preencher.<br>

   | $$521234569$$ | John Doe     | Jorge   | Mark 120  | $$19000$$ |
   | ------------- | ------------ | ------- | --------- | --------- |
   | $$563959094$$ | Ana García   | Beatriz | Delta 289 | $$23000$$ |
   | $$534210456$$ | Carlos Pérez | Ricardo | Gamma 754 | $$53000$$ |
4. **Carregar Arquivo:** Preencha esse Excel com seus dados e faça o upload na área de carregamento.\ <br>

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

\
**Opção B: Usando Contatos do Vambe (com IA)**

<figure><img src="/files/0c5e37bda21369529024bd54fb22f3656ff56d38" alt=""><figcaption></figcaption></figure>

Ideal para contatar pessoas com as quais você já conversou.

1. Selecione a opção **Contatos no Vambe.**
2. **Escolher Visualização:** Selecione a lista ou filtro de clientes para os quais você quer enviar (Ex: "Todos os clientes", "Etapa Vendas").<br>

   <figure><img src="/files/92720e1177ef171a1873f592ae604872a30739c7" alt=""><figcaption></figcaption></figure>
3. Mapeamento de Variáveis com IA:

   * Se seu template tiver variáveis (ex: "Olá {{1}}"), você pode ativar o interruptor **"Preencher com IA".**
   * **O que isso faz?** A IA lerá o histórico e as informações do ticket do cliente para tentar preencher esse dado automaticamente.
   * ***⚠️ Aviso:*** Não use variáveis para dados externos que a IA não conhece (ex: "Seu código de acesso é {{2}}"), pois a IA não conseguirá inventá-lo.

   <figure><img src="/files/779969e09c45a686ddcb2a317990956421c16efe" alt=""><figcaption></figcaption></figure>

Clique em **Criar** para finalizar a configuração.

***

#### Passo 3: Enviar ou Programar

Depois de criada, a campanha aparecerá na sua lista com o status Pendente. Ainda nada foi enviado. Você tem duas opções:

**1. Enviar Agora**

1. Clique no botão azul **Enviar**<br>

   <figure><img src="/files/f335db4d2d1eeb03021cddeb24eee48b918bff95" alt=""><figcaption></figcaption></figure>
2. Uma barra deslizante aparecerá. Escolha a quantidade de mensagens que você quer disparar (você pode enviá-las todas de uma vez ou em lotes).<br>

   <figure><img src="/files/3a149bff89be1f4e2a4fd2c18f1491962411fc90" alt=""><figcaption></figcaption></figure>
3. Clique em Enviar X mensagens.

**2. Programar para depois**

1. Clique nos três pontos (⋮) à direita do botão Enviar.\ <br>

   <figure><img src="/files/9568f23d6e486960d09960fa346a0c0fd4fafac7" alt=""><figcaption></figcaption></figure>
2. Selecione **Programar Campanha**.
3. Escolha a Data, a Hora e certifique-se de que o Fuso Horário esteja correto.\ <br>

   <figure><img src="/files/235cfdd87a1e18d980fdb9cc3a4048e4bddcfd99" alt=""><figcaption></figcaption></figure>
4. Clique em **Programar**. O sistema enviará as mensagens automaticamente nesse momento.

***

#### Passo 4: Monitorar Resultados

Como saber se funcionou? Na lista de campanhas, clique nos três pontos (⋮) e selecione Ver Detalhes.

<figure><img src="/files/9568f23d6e486960d09960fa346a0c0fd4fafac7" alt=""><figcaption></figcaption></figure>

Será aberto um painel de estatísticas onde você poderá ver:

* Total de mensagens.
* Enviadas com sucesso.
* Erros: (Muito útil para ver se algum número falhou).
* Respostas: Quantas pessoas reagiram à sua campanha.
* Abaixo você verá a lista nome por nome com o status de cada envio.

<figure><img src="/files/631056f93fb51880b44f2373b87d22472216f92a" alt=""><figcaption></figcaption></figure>

***

## Solução de problemas comuns

| Problema                       | Causa comum                         | Solução                                                                                                                                                                            |
| ------------------------------ | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Números não recebem a mensagem | Formato de telefone incorreto       | Garantir formato +56…                                                                                                                                                              |
| Template não aparece           | Não está associado ao canal         | Associar canal em Templates → Habilitar                                                                                                                                            |
| Erro de variáveis              | Colunas mal nomeadas ou vazias      | Revisar nomes exatos `var_1`, `var_2`…                                                                                                                                             |
| Campanha não avança            | Número WABA sem método de pagamento | [Adicionar método de pagamento no Business Manager](/canal/canal-pt-br/configuracao-na-meta/como-agregar-un-metodo-de-pago-y-configurar-el-perfil-de-tu-numero-de-whatsapp-api.md) |
| Rejeição pela Meta             | Conteúdo não permitido              | Ajustar a redação, a categoria e reenviar                                                                                                                                          |


---

# 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://academy.vambe.ai/canal/canal-pt-br/campanhas/como-crear-y-enviar-campanas-de-whatsapp-en-vambe.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.