> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como criar e disparar uma campanha pelo GronerZap

Sim. Em **Campanhas**, o GronerZap permite enviar a mesma imagem para uma lista de destinatários usando um número conectado por **QR Code**. Você escreve uma mensagem, escolhe **Imagem** e informa o link público da imagem. Depois seleciona os destinatários, faz um teste e define o ritmo do envio.

A campanha usa a lista que você selecionou. Ela não inclui automaticamente todos os contatos da empresa, da agenda do celular ou do histórico de conversas. O envio acontece com intervalos e limites; não há garantia de entrega para toda a lista nem de ausência de bloqueio pelo WhatsApp.

## Antes de começar

- Tenha um número disponível para o seu usuário e conectado ao GronerZap.
- Separe o texto do comunicado e a imagem que será enviada.
- Para imagem em campanha por QR Code, tenha um **link público que abra a imagem sem pedir login**. Um arquivo salvo apenas no computador não atende a esse campo.
- Confira quais clientes devem receber o comunicado e se têm telefone cadastrado. O acesso aos negócios continua respeitando as permissões do seu usuário.
- Se usar a conexão oficial da Meta, a campanha utiliza um **template aprovado**, em vez do editor de texto livre descrito para QR Code. Há uma seção específica abaixo.

## 1. Abra Campanhas

1. No CRM, acesse **Configurações > Comunicação & Marketing > GronerZap > Configurações** para abrir o GronerZap. Se ele já estiver aberto, continue nele.
2. No menu lateral do GronerZap, clique em **Campanhas**, no ícone de megafone.
3. Clique em **Nova campanha**.

A lista de campanhas também oferece o filtro **Todos os números** e a opção **Dashboard**. Se nenhum número estiver disponível para o seu usuário, **Nova campanha** fica desabilitado e aparece **Nenhum número conectado para este usuário.**

## 2. Escolha o número

No passo **Número**, em **1. Por qual número?**, selecione o número que deve enviar o comunicado. Confira o número escolhido antes de clicar em **Continuar**.

- **QR Code:** permite mensagem livre com imagem, vídeo, documento ou áudio por link público.
- **Conexão oficial da Meta:** utiliza um template aprovado e apresenta opções de ritmo próprias dessa conexão.

Se o número estiver desconectado, reconecte-o antes de prosseguir. Veja [Como reconectar seu número no GronerZap](https://ajuda.groner.app/pt-br/article/como-reconectar-seu-numero-no-gronerzap-149bpww/).

## 3. Escreva o comunicado e coloque a imagem

No passo **Mensagem**, em **2. Escreva a mensagem**:

1. Preencha **Nome da campanha** com um nome que ajude a identificar o envio, como “Comunicado de segurança”.
2. Em **Mensagem**, escreva o texto que acompanhará a imagem. Preencha o texto mesmo que o principal conteúdo esteja na imagem.
3. Em **Mídia (opcional)**, selecione **Imagem**.
4. Em **URL pública da mídia**, cole o link da imagem.
5. Para enviar um único comunicado, deixe **Passos de acompanhamento** sem passos adicionais.
6. Clique em **Continuar**.

O campo da mídia recebe um link; ele não é um botão para escolher uma imagem do computador. Abra o link em uma janela sem login para conferir se a imagem está acessível. Um link para uma pasta ou para uma página que exige autorização pode não funcionar no envio.

### Variações e campos personalizados

Em **Adicionar variação**, você pode preparar até três versões alternativas do texto. Cada destinatário recebe uma das versões. A mesma imagem continua sendo a mídia da campanha.

Para inserir o nome do contato ou outro dado disponível, use marcadores como **{{1}}** no texto. No passo dos contatos, escolha qual informação preenche cada marcador. Para um comunicado idêntico para todos, escreva o texto sem esses marcadores.

### Passos de acompanhamento

**Adicionar passo** cria uma sequência para quem ainda não respondeu. Cada passo tem seu conteúdo e o campo **Horas depois do passo**. No passo final, a jornada permite escolher **Parar ao responder** ou **Seguir mesmo assim**.

Em números por QR Code, um passo adicional pode usar **Texto fixo** ou **Gerar por IA**. A geração por IA consome **1 crédito por mensagem** e pode produzir textos diferentes. Para um comunicado que precisa manter exatamente a informação aprovada pela empresa, use texto fixo e revise antes de enviar.

## 4. Escolha quem recebe

No passo **Contatos**, em **3. Escolha os contatos**, selecione a origem da lista.

### Negócios do CRM

1. Clique em **Negócios do CRM**.
2. Em **Filtrar negócios**, escolha os filtros que representam os destinatários: **Data de cadastro**, **Data da venda**, **Critério**, **Funil** e **Status**. Os critérios de tarefas também permitem escolher **Tipo de tarefa**.
3. Se quiser todos os negócios disponíveis ao seu usuário, deixe a busca por nome vazia, o **Critério** em **Todos** e remova os demais filtros, usando **Limpar filtros** quando aparecer.
4. Clique em **Buscar**.
5. Confira a quantidade de **negócios com telefone** encontrada. Os resultados dessa busca já formam a lista da campanha; não é necessário marcar cada negócio em uma tabela.
6. Se a mensagem tiver marcadores, como **{{1}}**, preencha cada **Variável**. Escolha o dado que será usado, como **Nome do contato**, ou selecione **Texto fixo** e escreva o valor.
7. Clique em **Ver prévia** para abrir **Prévia e teste**.

**Buscar também funciona sem nome:** o campo **Buscar por nome ou contato (opcional)** pode ficar vazio. Nesse caso, clique em **Buscar** para carregar os negócios que atendem aos filtros. Apenas escolher **Negócios do CRM** ou ajustar os filtros ainda não carrega os destinatários.

**Os filtros são aplicados em conjunto.** Preencher **Data da venda** exige uma venda no período informado, mesmo com **Critério** em **Todos**. Se você quer incluir negócios que ainda não têm venda, limpe **Data da venda** pelo **x** do próprio campo e faça a busca novamente. Deixe esse filtro preenchido apenas quando quiser selecionar negócios com venda naquele período.

Depois de alterar qualquer filtro ou o nome pesquisado, clique em **Buscar** novamente. **Limpar filtros** remove os filtros de datas, funil, status e critério; confira separadamente se o campo de nome também está vazio.

**Atenção ao limite da busca:** cada busca carrega no máximo **5.000 negócios com telefone**. Se aparecer o aviso de que a busca foi cortada, a lista não representa toda a base. Refine os filtros para formar seleções menores e confira novamente a quantidade.

Para trabalhar uma base maior pelo CRM, você pode separar as seleções por períodos de **Data de cadastro** que não se sobreponham. Informe a data inicial e final de cada período. Verifique a cobertura de todos os períodos e os contatos com mais de um negócio: eles podem aparecer em campanhas diferentes e receber o aviso mais de uma vez.

A lista é de negócios acessíveis ao seu usuário, não uma seleção automática de todos os cadastros da empresa. Um contato sem negócio ou sem telefone disponível não entra por essa origem. A quantidade de negócios também pode ser maior que a de telefones únicos.

### Grupos de WhatsApp

Em números por QR Code, a opção **Grupos de WhatsApp** permite escolher os grupos do número. **Marcar todos** seleciona todos os grupos carregados.

Isso envia o comunicado para os grupos, não uma mensagem individual para cada participante. Mensagens para grupos não usam os marcadores de dados de contato; retire-os antes de continuar. Para um aviso individual aos clientes, use a lista dos negócios.

### Planilha

A opção **Escolher planilha** permite selecionar uma lista própria e indicar a **Coluna do telefone**. Use o modelo disponibilizado na tela: somente a primeira aba, **Contatos**, é lida; mantenha a estrutura do modelo e remova as linhas de exemplo antes de usar.

Se precisar que a equipe Groner faça uma importação ou prepare uma carga de dados para você, esse serviço deve ser tratado separadamente com o suporte. Este passo a passo permite montar a campanha com os negócios que já estão no CRM.

### O que é retirado da lista

Na mesma campanha, telefones repetidos são ignorados para evitar duplicidade. Telefones inválidos e destinatários que pediram descadastro também são ignorados, com o motivo disponível no acompanhamento. Isso não impede repetição entre campanhas diferentes.

## 5. Confira e envie um teste

No passo **Prévia e teste**, em **4. Confira e teste**:

1. Leia as cinco primeiras mensagens exibidas e confira o preenchimento dos marcadores, se houver.
2. Informe seu próprio celular com DDD no campo de teste.
3. Clique em **Enviar teste**.
4. Abra o WhatsApp desse celular e confirme que o texto e a imagem chegaram como esperado.
5. Só avance depois de conferir o recebimento.

O teste envia uma mensagem real para o telefone informado, mas não dispara para toda a lista. A indicação de teste enviado não substitui a conferência da imagem recebida no celular.

## 6. Defina o ritmo e confirme

No passo **Disparo**, em **5. Ritmo e disparo**, confira:

- **Intervalo mínimo (s)** e **Intervalo máximo (s):** em QR Code, definem o intervalo entre as mensagens. O mínimo deve ser de pelo menos 5 segundos; o máximo não pode ser menor que o mínimo nem passar de 900 segundos.
- **Teto por dia:** define o limite diário desejado. O número também está sujeito aos limites de envio apresentados pelo GronerZap. A base pode levar vários dias para ser percorrida.
- **Início do disparo:** escolha **Enviar imediatamente** ou **Agendar para data específica**. Para agendar, preencha **Data e hora do disparo** com uma data futura.
- **Janela de envio comercial:** selecione os horários e os dias permitidos. Fora dessa janela, a campanha pausa e retoma no período permitido, conforme o horário de Brasília.
- **Quando o contato responder:** mantenha **Não fazer nada (padrão)** ou escolha uma fila em **Entregar o negócio a uma fila de distribuição**. A atribuição vale para destinatários vindos dos negócios do CRM. O campo **Só quando a resposta contiver (opcional)** limita a ação às palavras informadas, separadas por vírgula.

Leia a quantidade final de destinatários e confira novamente o número remetente.

- **Salvar sem enviar:** guarda como rascunho. Depois, use **Iniciar** na lista quando estiver pronto.
- **Disparar agora:** inicia a campanha, respeitando a janela e os limites.
- **Agendar:** confirma o envio para o horário escolhido, também respeitando a janela.

### Medidor de risco do QR Code

Leia o nível de risco e os motivos exibidos. Se estiver alto, o disparo normal fica bloqueado. Aumente o intervalo, ajuste a janela de envio, revise a lista e as variações do texto.

A tela pode oferecer **Disparar mesmo assim**, seguido da confirmação **Disparar com risco alto?** e de **Assumo o risco e disparo**. Essa confirmação não elimina o risco de restrição ou banimento do WhatsApp. Para um comunicado importante, revise as condições antes de assumir esse risco.

Os limites de envio do número também são usados por outras mensagens da operação. Não conte com o envio de toda a base em um único dia.

## 7. Acompanhe os resultados

1. Volte a **Campanhas** e abra a campanha para ver os destinatários, seus estados e os motivos de falha ou de exclusão do envio.
2. Use **Pausar** e **Retomar** quando precisar interromper e continuar. **Cancelar campanha** encerra o envio pendente.
3. Em **Dashboard**, escolha o período para acompanhar os indicadores de entrega, leitura e resposta.
4. Antes de usar **Reenviar falhas**, confira o que falhou. Incluir envios não confirmados pode fazer o destinatário receber a mesma mensagem novamente.

“Enviado” não significa que o destinatário leu. Confira os indicadores disponíveis antes de considerar que todos foram informados.

## Se o número usa a conexão oficial da Meta

A campanha usa um template já aprovado. Prepare-o antes em **Configurações > Comunicação & Marketing > Templates Meta**, no CRM, ou em **Configurações > Números > Gerenciar templates**, no GronerZap.

No passo **Mensagem**, escolha o modelo aprovado. No passo dos contatos, indique o valor de cada marcador solicitado. O ritmo é configurado em mensagens por segundo, minuto ou hora; a conexão oficial também oferece **Variação humanizada**. As regras e os custos da Meta continuam valendo.

Para criar o modelo e entender quando ele é necessário, veja o [Guia completo de templates da Meta no WhatsApp](https://ajuda.groner.app/pt-br/article/guia-completo-de-templates-da-meta-no-whatsapp-e8mpp9/).

### Template com vídeo, imagem ou documento no cabeçalho

Na campanha, o cabeçalho do template sai **com a mídia que foi enviada quando o template foi criado e aprovado**. Por isso, o passo **Mensagem** não mostra campo para anexar ou trocar o vídeo: a escolha da mídia acontece na criação do template.

Isso é diferente do envio individual pela conversa (**Enviar template**), em que você anexa o arquivo na hora.

Para usar na campanha um vídeo diferente do que está no template (por exemplo, uma versão menor do arquivo):

1. Prepare o vídeo em **MP4** com **até 16 MB**. Um arquivo maior pode até ser aceito na criação do template, mas não é entregue aos contatos.
2. Abra **Templates Meta** (ou **Configurações > Números > Gerenciar templates**, no GronerZap) e crie um **novo template** com o mesmo texto, escolhendo **Vídeo** no cabeçalho e anexando o arquivo novo.
3. Aguarde o status **Aprovado**.
4. Na campanha, no passo **Mensagem**, selecione o template novo. Se a campanha já estava salva como rascunho com o template antigo, abra o rascunho e troque o template antes de iniciar.
5. Em **Prévia e teste**, envie o teste para um celular da sua equipe e confira no WhatsApp se o vídeo e o texto chegaram juntos.
6. Só então inicie a campanha.

Lembre que cada teste para um número novo também conta no limite diário de contatos da Meta para o seu número.

## Problemas comuns e perguntas frequentes

### O botão Ver prévia está desabilitado

Na origem **Negócios do CRM**, o botão depende de uma busca com pelo menos um negócio com telefone e, quando houver marcadores na mensagem, do preenchimento de todas as **Variáveis**.

1. Confira se os filtros representam quem deve receber. Para incluir negócios sem venda, retire **Data da venda**; **Critério: Todos** não cancela esse filtro.
2. Deixe **Buscar por nome ou contato (opcional)** vazio para buscar pelos filtros, ou informe o nome se quiser restringir a um contato.
3. Clique em **Buscar**, mesmo quando não tiver digitado um nome.
4. Aguarde e confira a quantidade de **negócios com telefone** abaixo dos filtros.
5. Preencha todas as **Variáveis**, se aparecerem. Ao escolher **Texto fixo**, preencha também o texto.
6. Clique em **Ver prévia**. Essa ação abre a conferência das mensagens e não dispara a campanha.

Se aparecer **Nenhum negócio com telefone encontrado com esses filtros**, a busca terminou sem destinatários. Revise as datas, o funil e o status, retire o filtro que não se aplica e clique em **Buscar** novamente. Confira também se o contato tem celular cadastrado e se o negócio está disponível para o seu usuário.

Se aparecer **Não foi possível buscar os negócios**, a busca não foi concluída. Tente **Buscar** novamente; se persistir, informe ao suporte a mensagem exibida.

Se a tela já mostrar negócios com telefone e todas as variáveis estiverem preenchidas, mas **Ver prévia** continuar desabilitado, informe ao suporte a quantidade exibida e a mensagem que aparecer.

### Quero enviar apenas a imagem, mas não consigo continuar

Preencha também **Mensagem** e **Nome da campanha**. Para QR Code, selecione **Imagem** e informe **URL pública da mídia**. A imagem não substitui o preenchimento do texto.

### A imagem não chegou no teste

Confirme que **Mídia (opcional)** está em **Imagem** e que o link abre a imagem sem login. Corrija o link e use **Enviar teste** novamente. Não dispare para a lista inteira antes de conferir o resultado no celular.

### Não encontro onde anexar o vídeo do template na campanha

Na conexão oficial, a campanha usa a mídia que está no próprio template. Para trocar o vídeo, crie um novo template com o arquivo desejado (MP4, até 16 MB) e selecione-o na campanha. Veja o passo a passo em **Template com vídeo, imagem ou documento no cabeçalho**, acima.

### Como saber se o teste do template foi entregue

Nos números da conexão oficial, depois de **Enviar teste** a tela acompanha a entrega por até 2 minutos, logo abaixo do botão:

- **Teste aceito pelo WhatsApp… Aguardando a confirmação de entrega:** o WhatsApp recebeu o pedido e ainda não confirmou a entrega no celular. Aguarde.
- **Teste entregue** (ou **entregue e lido**): a mensagem chegou ao celular. Abra o WhatsApp e confira se a mídia e o texto estão como esperado.
- **O teste não foi entregue**, em vermelho: o WhatsApp recusou a entrega, e o motivo aparece em seguida. Não dispare a campanha antes de corrigir.
- **Ainda sem confirmação de entrega:** passaram 2 minutos sem resposta do WhatsApp. Confira no celular e, se a mensagem não chegou, não dispare.

![Teste entregue, logo abaixo do botão Enviar teste](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/01-teste-entregue_sjkxcg.png)

![Aviso em vermelho quando o WhatsApp recusa a entrega do teste](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/02-teste-nao-entregue_q4if3q.png)

### O teste do template com vídeo não foi entregue

Se aparecer **O teste não foi entregue** com o aviso de que o WhatsApp não conseguiu entregar a mídia:

1. Não inicie a campanha.
2. Confira o tamanho do vídeo que está no template. Acima de 16 MB, crie um novo template com uma versão menor do vídeo (MP4).
3. Abra a campanha, selecione o template novo no passo **Mensagem** e envie um novo teste.
4. Se o aviso continuar, informe ao suporte o nome do template, o horário do teste e o número remetente (não é preciso enviar a lista de contatos).

### A lista tem menos clientes do que eu esperava

Confira os filtros, a busca por nome e as permissões do usuário. A seleção pelo CRM considera negócios com telefone. Observe o aviso de corte em 5.000 negócios e divida a seleção se necessário. Depois do envio, consulte também os destinatários ignorados e seus motivos.

### A campanha não começou no horário escolhido

Confira a **Janela de envio comercial**, os dias permitidos, a conexão do número e os limites diários. Um horário agendado fora da janela não autoriza envios fora dela.

### Posso usar isso para um comunicado de segurança?

Sim, você pode usar texto fixo e a mesma imagem na campanha. Prepare o conteúdo com informações confirmadas pela sua empresa, confira os destinatários e faça o teste. A imagem e seu link público não devem conter dados pessoais de clientes. A entrega da campanha não comprova, por si só, que todas as pessoas receberam ou leram o aviso.

### As mensagens contam na produtividade dos atendentes?

As mensagens da campanha não são atribuídas a um atendente para compor sua produtividade. As respostas dos clientes podem seguir a opção definida em **Quando o contato responder**.

### O QR Code garante que o número não será bloqueado?

Não. Intervalos, limites e o medidor de risco ajudam a orientar o envio, mas não garantem ausência de bloqueio nem entrega a todos os destinatários.

<!-- groner-suporte:veja-tambem:inicio -->

## Veja também

- [Guia do GronerZap: API oficial do WhatsApp e conexão por QR Code](https://ajuda.groner.app/pt-br/article/guia-do-gronerzap-api-oficial-do-whatsapp-e-conexao-por-qr-code-775y6e/)
- [Como reconectar seu número no GronerZap](https://ajuda.groner.app/pt-br/article/como-reconectar-seu-numero-no-gronerzap-149bpww/)
- [Guia completo de templates da Meta no WhatsApp](https://ajuda.groner.app/pt-br/article/guia-completo-de-templates-da-meta-no-whatsapp-e8mpp9/)
- [Bloqueios e Banimentos no WhatsApp (Atualização 2025)](https://ajuda.groner.app/pt-br/article/bloqueios-e-banimentos-no-whatsapp-atualizacao-2025-1cm8oc3/)

<!-- groner-suporte:veja-tambem:fim -->