> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superagentes.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Campanhas de WhatsApp

> Guia completo para criar e gerenciar campanhas de WhatsApp usando o Super Agentes

# Campanhas de WhatsApp no Super Agentes

Este guia explica como criar e gerenciar campanhas de WhatsApp usando o Super Agentes, incluindo as diferenças entre API Oficial e APIs não oficiais.

<Card title="Antes de começar" icon="circle-info">
  Para usar campanhas de WhatsApp, você precisa:

  * Ter um [agente configurado](/agent/overview)
  * Ter uma [integração com WhatsApp ativa](/agent/integration/whatsapp)
</Card>

<Warning>
  Antes de criar uma campanha, certifique-se de seguir as diretrizes do WhatsApp para mensagens comerciais e respeitar os limites de cada tipo de API.
</Warning>

## Pré-requisitos

Antes de criar uma campanha, certifique-se de que:

1. [Seu agente está configurado](/agent/overview) e conectado ao WhatsApp
2. Cada agente tem apenas uma [conexão de WhatsApp](/agent/integration/whatsapp) (a primeira conexão será usada para disparos)
3. Para API Oficial: você tem acesso ao WABA ID (WhatsApp Business Account ID)

## Criando uma Nova Campanha

### Acessando o Módulo de Campanhas

1. Acesse a barra lateral do Super Agentes
2. Clique na aba **Campanhas**
3. Clique em **Nova Campanha**

### Preenchendo as Informações da Campanha

<Steps>
  <Step title="Informações Básicas">
    * **Nome da Campanha**: Defina um nome identificador para sua campanha
    * **Mensagem**: Digite ou cole o conteúdo da sua mensagem
      * Suporta formatação Markdown do WhatsApp
      * Mantenha a mensagem clara e objetiva
  </Step>

  <Step title="Seleção do Agente">
    * Escolha o [agente](/agent/overview) que fará os disparos
    * O agente deve ter uma [conexão WhatsApp ativa](/agent/integration/whatsapp)
    * O tipo de API (Oficial ou não oficial) será detectado automaticamente
  </Step>

  <Step title="Configuração Específica por Tipo de API">
    <AccordionGroup>
      <Accordion title="Para API Oficial">
        * Necessário fornecer o WABA ID
        * Como encontrar o WABA ID:
          1. Acesse o aplicativo Meta for Developers
          2. Vá em "WhatsApp > Configuração da API"
          3. Localize "Identificação da conta do WhatsApp Business"
          4. Copie o ID e cole no campo WABA ID
      </Accordion>

      <Accordion title="Para APIs não oficiais">
        * Será exibido um aviso sobre os riscos
        * Você precisará confirmar que entende os riscos antes de prosseguir
        * Consulte nossa [documentação de configurações avançadas](/agent/integration/whatsapp-configs) para mais detalhes
      </Accordion>
    </AccordionGroup>
  </Step>
</Steps>

### Selecionando os Destinatários

<CardGroup cols={3}>
  <Card title="Seleção por Agentes" icon="robot">
    * Selecione contatos que já interagiram com seus agentes
    * Filtre por agente específico
    * Filtre por campanhas anteriores
  </Card>

  <Card title="Números Manuais" icon="keyboard">
    * Digite os números manualmente
    * Formato: 55 + DDD + Número
    * Exemplo: 5511999999999
    * O sistema trata automaticamente o nono dígito
  </Card>

  <Card title="Importação de Arquivo" icon="file-import">
    * Formatos aceitos: CSV ou TXT
    * Estrutura do arquivo:

    ```
    nome,telefone
    João,5511999999999
    Maria,5511888888888
    ```

    * O sistema processa automaticamente os números importados
  </Card>
</CardGroup>

## Disparando a Campanha

### Para API Oficial

1. Após criar a campanha, aguarde a aprovação do template
   * O processo pode levar até 2 minutos
   * O botão de disparo será habilitado automaticamente após aprovação
2. Clique em **Disparar** quando o botão estiver habilitado
3. A campanha iniciará os envios conforme as configurações

### Para APIs não oficiais

1. Após criar a campanha, o botão de disparo já estará disponível
2. Clique em **Disparar**
3. A campanha iniciará imediatamente

## Monitoramento e Status

### Status da Campanha

<CardGroup cols={2}>
  <Card title="Rascunho" icon="file">
    Campanha criada mas não iniciada
  </Card>

  <Card title="Em Aprovação" icon="clock">
    Aguardando aprovação do template (API Oficial)
  </Card>

  <Card title="Em Andamento" icon="play">
    Disparos em execução
  </Card>

  <Card title="Concluída" icon="check">
    Todos os disparos realizados
  </Card>

  <Card title="Erro" icon="triangle-exclamation">
    Problemas durante a execução
  </Card>
</CardGroup>

### Métricas Disponíveis

* Total de contatos
* Mensagens enviadas
* Taxa de entrega
* Status por mensagem

## Boas Práticas

### 1. Planejamento

* Teste a mensagem antes com um número reduzido de contatos
* Verifique a formatação da mensagem
* Confirme se todos os números estão no formato correto

### 2. Timing

* Evite disparos em horários inadequados
* Distribua grandes volumes em diferentes horários
* Respeite os limites de cada tipo de API

### 3. Conteúdo

* Use mensagens personalizadas e relevantes
* Evite conteúdo que possa ser marcado como spam
* Siga as diretrizes do WhatsApp para mensagens comerciais

## Solução de Problemas

<AccordionGroup>
  <Accordion title="Campanha não inicia">
    1. Verifique se o agente está conectado
    2. Confirme se o WABA ID está correto (API Oficial)
    3. Verifique se há números válidos selecionados
  </Accordion>

  <Accordion title="Template não é aprovado (API Oficial)">
    1. Verifique se a mensagem segue as diretrizes da Meta
    2. Ajuste o conteúdo conforme necessário
    3. Tente criar um novo template
  </Accordion>

  <Accordion title="Erros durante o disparo">
    1. Verifique a conexão do WhatsApp
    2. Confirme se os números estão corretos
    3. Verifique os logs de erro na plataforma
  </Accordion>
</AccordionGroup>

## Perguntas Frequentes

<AccordionGroup>
  <Accordion title="Posso usar a mesma campanha para diferentes agentes?">
    Não, cada campanha está vinculada a um único agente.
  </Accordion>

  <Accordion title="Como sei se minha campanha foi entregue?">
    O sistema mostra o status de entrega para cada mensagem na interface de monitoramento.
  </Accordion>

  <Accordion title="Existe limite de contatos por campanha?">
    Sim, os limites variam conforme o tipo de API:

    * API Oficial: Conforme limites da Meta
    * APIs não oficiais: Recomendado máximo de 100 contatos por campanha
  </Accordion>

  <Accordion title="Posso cancelar uma campanha em andamento?">
    Sim, use o botão "Pausar" na interface de campanhas.
  </Accordion>

  <Accordion title="Como faço para reenviar mensagens com erro?">
    Você pode criar uma nova campanha selecionando apenas os contatos que apresentaram erro.
  </Accordion>
</AccordionGroup>