# Envio em Massa
{% hint style="warning" %}
**Disponível para o perfil: Administrador, Supervisor e Usuário**
{% endhint %}
O sistema oferece duas modalidades distintas: o disparo via API Oficial (WABA), que exige o uso de templates aprovados pela Meta, e o disparo via APIs não oficiais (conexão por QR Code), que permite maior flexibilidade no conteúdo das mensagens.
#### Principais funções
* Envio de campanhas para listas de números via upload de CSV ou inserção manual.
* Disparos segmentados por Etiquetas (Tags), colunas do Kanban ou Contatos selecionados.
* Envio programado para Grupos de WhatsApp através de IDs.
* Controle de intervalo entre mensagens para evitar bloqueios.
#### Caso de Uso
Uma empresa deseja anunciar uma promoção para 500 clientes que estão na coluna "Interessados" do seu Kanban. Em vez de enviar manualmente, o administrador utiliza o Disparo em Massa, seleciona a coluna do Kanban desejada e o sistema realiza o envio automático para todos os contatos daquela segmentação.
***
#### Como acessar a página
1. No menu lateral, clique em Comunicação e Marketing;
2. Selecione a aba Envio em Massa.
#### Você verá a seguinte tela:
#### Explicação dos campos e ícones
* Tempo de Disparo: Define o intervalo (em segundos) entre o envio de uma mensagem e outra.
* Números / IDs: Campo para inserir os destinatários manualmente ou via importação.
* Selecionar Template: (Apenas API Oficial) Lista os modelos de mensagens pré-aprovados pela Meta.
* Selecionar Etiqueta: Filtra contatos que possuem uma tag específica.
* Selecionar Kanban: Filtra contatos que possuem cards em uma coluna específica do quadro.
* Mídia: Espaço para anexar imagens, áudios (gravados ou arquivo) e documentos ao disparo.
### Tutorial envio em massa
{% embed url="" %}
#### Passo a passo de uso
**1. Disparo via API Oficial (WABA)**
Este método é o mais seguro e requer um Template HSM aprovado.
1. Na aba de API Oficial, defina o Tempo de Disparo.
2. Suba sua lista de números ou cole-os manualmente (Formato: `55DD9XXXXXXXX`).
3. Escolha o Template aprovado na lista suspensa.
4. Clique em Enviar.
{% hint style="info" %}
Dica de Importação: Use um arquivo CSV com apenas uma coluna contendo os números. O sistema processará a lista automaticamente.
{% endhint %}
{% hint style="warning" %}
Templates: Na API Oficial, se o seu template tiver variáveis (ex: `Olá, {{1}}`), certifique-se de que sua lista de importação está preparada para preencher esses campos.
{% endhint %}
**2. Disparo via APIs Não Oficiais (QR Code)**
Utilizado para envios mais flexíveis, sem necessidade de templates.
1. Selecione a Conexão (WhatsApp conectado via QR Code) que realizará o disparo.
2. Escolha o destino: Manual, Contatos, Grupos, Etiqueta ou Kanban.
3. Se for Grupos, insira os IDs dos grupos (obtidos no menu Gestão de Grupos).
4. Digite sua mensagem e, se desejar, anexe uma Mídia.
5. Clique em Enviar.
***
#### Detalhamento: Como obter IDs de Grupos
Para disparar em massa para grupos, você deve primeiro capturar os IDs:
1. Vá em Grupos > Gestão de Grupos em Massa.
2. Selecione a conexão de WhatsApp e clique em Listar ID dos Grupos.
3. Copie os IDs ou exporte a planilha para usar no disparador.
***
#### Avisos e precauções
{% hint style="danger" %}
Risco de Banimento (API Não Oficial): Ao usar conexões não oficiais, evite tempos de disparo muito curtos (como 0 a 1 segundo) para listas grandes. Isso pode sinalizar comportamento de bot ao WhatsApp e resultar no banimento do chip.
{% endhint %}
{% hint style="info" %}
Sempre utilize o formato internacional: `DDI + DDD + Número` (Ex: `5511999999999`).
{% endhint %}
### Tutorial envio em massa para grupos
{% embed url="" %}
#### Passo a passo de uso
**Passo 1: Extrair os IDs dos Grupos**
1. No menu Gestão de Grupos, selecione a Conexão desejada.
2. Clique no botão "Listar ID dos Grupos".
3. Com a lista exibida, você pode copiar os IDs manualmente ou clicar em "Exportar CSV".
{% hint style="info" %}
Para o disparo, o sistema aceita apenas os IDs. Se copiar manualmente, remova os nomes dos grupos. Se usar o CSV, exclua a coluna de nomes e mantenha apenas a coluna dos IDs.
{% endhint %}
**Passo 2: Configurar o Disparo**
1. Navegue até o menu Comunicação e Marketing > Disparo em Massa.
2. Selecione novamente a Conexão de WhatsApp que fará o envio.
3. Defina o Tempo de Disparo (Ex: entre 1 e 5 segundos).
**Passo 3: Inserir Destinatários e Mensagem**
1. Cole os IDs dos grupos no campo de contatos ou faça o upload do arquivo CSV formatado apenas com os IDs.
2. Digite o texto da sua campanha no campo de mensagem.
3. Clique em Enviar.
**Passo 4: Conferir o Envio**
Para validar se as mensagens foram entregues:
1. Vá até a tela de Atendimentos.
2. Clique na aba Grupos.
3. Verifique as mensagens enviadas (elas aparecerão inicialmente como pendentes e depois serão entregues aos grupos selecionados).
***
#### Avisos e precauções
{% hint style="warning" %}
Formatação de IDs: O disparador não reconhece nomes de grupos. Certifique-se de que o campo de destinatários contém apenas os códigos técnicos (IDs) separados por vírgula.
Intervalo de Segurança: Ao disparar para muitos grupos, utilize tempos de intervalo maiores (acima de 3 segundos) para garantir a estabilidade da conexão do WhatsApp.
{% endhint %}
---
# 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://ajuda.zdg.com.br/ferramentas-do-atendimento/comunicacao-e-marketing/envio-em-massa.md?ask=
```
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.
