Como ativar o GronerZap

O GronerZap permite conectar seu número de WhatsApp ao CRM para centralizar atendimentos, registrar conversas e otimizar o relacionamento com seus clientes.
Siga o passo a passo abaixo para realizar a ativação:

Antes de começar: verifique a versão e suas permissões

Este passo a passo é da nova versão do GronerZap. Se você ainda estiver na versão antiga, é necessário realizar a migração antes de configurar o número. Após a migração, atualize seu usuário e a página com CTRL + F5 para exibir corretamente o ícone da nova versão.

Para acessar a configuração de números, seu usuário precisa ser administrador no CRM.

QR Code ou API Oficial: qual escolher

Ao conectar um número no GronerZap você escolhe entre duas formas de conexão. Vale entender a diferença antes de começar.

Conexão por QR Code

• O número fica pareado a um aparelho com WhatsApp instalado, no mesmo esquema de "aparelhos conectados" do WhatsApp Web.
• Usa uma conta de WhatsApp comum. A ativação é rápida e o próprio administrador faz sozinho.
• A conexão pode cair em situações como queda de internet, celular desligado ou logout no aparelho. Em volume muito alto de mensagens, há risco de bloqueio pelo WhatsApp.
• Não há cobrança por conversa.

Escolha o QR Code quando: você quer começar rápido, tem volume baixo ou médio de mensagens, o atendimento é principalmente reativo (o cliente manda a mensagem primeiro) e você não quer passar por um processo de habilitação.

Conexão pela API Oficial

• O número passa a operar como uma conta na plataforma oficial do WhatsApp para empresas (WhatsApp Business Platform), gerenciada pelo Business Manager.
• O número deixa de funcionar no aplicativo comum do WhatsApp (não pareia celular).
• É mais estável, mas segue regras próprias da plataforma: para iniciar uma conversa (ou responder depois de 24h da última mensagem do cliente) é preciso usar um modelo de mensagem previamente aprovado. Existem categorias de modelo, limites de envio por faixa e uma nota de qualidade do número.
• Há cobrança por conversa (tarifa da plataforma oficial, à parte da mensalidade do GronerZap).
• Pré-requisitos: conta no Business Manager, número verificado e modelos de mensagem aprovados.
• Não é self-service: a API Oficial não é ativada pelo administrador sozinho. É necessário abrir a solicitação com a equipe da Groner, que cuida da criação da conta, da verificação do número e dos modelos.

Escolha a API Oficial quando: você precisa de estabilidade, tem volume alto de mensagens, faz disparos ativos com modelos ou tem exigência de operar no formato oficial.

ℹ️ A mensalidade da linha no GronerZap é a mesma nos dois caminhos. O que muda é a cobrança por conversa (só na API Oficial) e o processo de ativação.

1. Acesse o ícone do GronerZap

Clique no ícone localizado no canto inferior esquerdo da tela.

2. Acesse as configurações

Após abrir o GronerZap, clique nos três pontinhos (⋮) no canto superior da tela e, em seguida, selecione a opção Configuração.

3. Se a opção “Números” não aparecer

A opção Números e o procedimento de ativação estão disponíveis somente para usuários com perfil de administrador. Se você é uma vendedora interna ou não possui esse nível de acesso, solicite ao administrador da conta que faça a ativação.

Se você possui mais de um número disponível e precisa acessar outro que já está funcionando, use a opção Trocar de número e selecione o número desejado.

4. Clique em “Números”

Dentro das configurações, clique na opção "Números" para abrir a tela de conexão do WhatsApp.

Permissão necessária

Para acessar a opção Números e editar ou remover um número antes de conectá-lo, o usuário precisa ser Administrador no CRM. Usuários que não são administradores, como vendedores internos, devem solicitar que o administrador realize o procedimento.

5. Adicione ou selecione o número

Se ainda não houver um número cadastrado, clique na opção para adicionar um número. Se o número já existe e você só precisa conectá-lo, selecione-o na lista.

Ao adicionar ou editar um número, há dois campos que costumam gerar confusão — e eles são diferentes:

Nome do número

• Campo obrigatório e de texto livre: você digita o que quiser.
• Serve apenas como identificação do número nas listas e seletores do sistema (histórico de conversas, escolha de número ao enviar modelos, etc.). Não influencia o roteamento de leads, a mensalidade nem os relatórios.
• Dica: use uma identificação fácil de reconhecer, como Comercial, Matriz SP ou Suporte. Não precisa ser o nome de uma loja cadastrada.

Lojas

• Campo opcional. Aqui você seleciona uma ou mais lojas já cadastradas em Configurações > Equipe > Lojas — é uma escolha a partir de uma lista, você não digita o nome.
• Esse campo tem efeito prático: a loja do lead define por qual número conectado saem as mensagens automáticas dele, e a configuração do bot também é feita por loja. Ou seja, ao vincular a(s) loja(s) certa(s), esse número passa a atender os leads daquelas lojas.
• Como preencher: se a sua conta tem apenas uma loja, pode deixar em branco; se você trabalha com várias lojas, selecione a(s) loja(s) que esse número deve atender.

ℹ️ O nome exato e a posição desses campos podem variar conforme a versão. Se tiver dúvida sobre onde fica cada um, procure pela seção de lojas dentro da configuração do número ou fale com o suporte.

6. Escolha a forma de conexão

Selecione se o número será conectado por QR Code ou pela API Oficial. Em caso de dúvida, veja acima a seção "QR Code ou API Oficial: qual escolher". Os passos a seguir descrevem a conexão por QR Code.

7. Gere o QR Code

Clique em Gerar QR Code.
O sistema exibirá um QR Code na tela.

8. Conecte seu WhatsApp

Agora, no seu celular:

1. Abra o WhatsApp.
2. Toque em Configurações.
3. Selecione Aparelhos conectados.
4. Toque em Conectar um aparelho.
5. Escaneie o QR Code exibido no Groner.

Após a leitura do QR Code, o número será conectado ao GronerZap e estará pronto para uso.

🔄 Substituir um número já conectado

Para trocar o número que envia mensagens pelo GronerZap, desconecte a conexão atual e conecte o novo número:

1. Acesse Configuração > Números.
2. Desconecte o número atual, se ele ainda estiver conectado.
3. Clique em Gerar QR Code.
4. No celular que possui o novo número, abra o WhatsApp > Configurações > Aparelhos conectados > Conectar um aparelho.
5. Escaneie o QR Code exibido no GronerZap e aguarde a confirmação.

O número conectado ao GronerZap é o número utilizado para enviar as mensagens. O celular que possui esse número precisa estar disponível para fazer a leitura do QR Code.

Quando o GronerZap estiver offline ou o QR Code não aparecer

1. Acesse o GronerZap pelo ícone no canto inferior esquerdo.
2. Clique nos três pontinhos (⋮), selecione Configuração e abra Números.
3. Se a conexão estiver offline, tente Gerar QR Code novamente e leia o código pelo caminho WhatsApp > Configurações > Aparelhos conectados > Conectar um aparelho.
4. Se o QR Code continuar sem aparecer, atualize a página com Ctrl+F5.
5. Se a instância tiver sido excluída, adicione uma nova e, se possível, use o mesmo nome anterior. Depois, gere o QR Code e conecte o WhatsApp novamente.
6. Após reconectar, use o botão de sincronizar conversas para recuperar a sincronização disponível no sistema.

Mensagens ou histórico não aparecem no GronerZap

Se as mensagens aparecem no WhatsApp do celular, mas não são exibidas no GronerZap, verifique se o número está conectado e se a conversa pertence ao mesmo número conectado. Quando há vários números cadastrados, a conversa pode estar vinculada a outra instância.

Se o número estiver desconectado, um administrador deve repetir a leitura do QR Code para reconectá-lo. Após a reconexão, o histórico pode permanecer carregando por alguns instantes; atualize a página e aguarde a sincronização. Mensagens que chegam durante uma instabilidade de conexão ou do WhatsApp podem aparecer posteriormente, depois da normalização.

✅ Boas práticas

• Utilize um número exclusivo para atendimento comercial.
• Evite desconectar o número pelo WhatsApp do celular após a integração. Somente em casos necessários.
• Caso o QR Code expire, basta gerar um novo código repetindo o processo.
• Se o QR Code for lido, mas continuar carregando ou não conectar, teste primeiro o acesso ao WhatsApp Web normalmente. Se o WhatsApp Web também não conectar, verifique a conexão do celular e do computador antes de tentar novamente.
• Se o pareamento por QR Code ou código falhar repetidamente, é possível migrar uma sessão já conectada do WhatsApp Web usando a extensão Session Migration Connector no Google Chrome, Microsoft Edge ou Brave:

1. Instale a extensão.
2. Acesse o WhatsApp Web e conecte o número normalmente; aguarde o carregamento completo das conversas.
3. Abra a extensão e informe o Server URL e o Instance Token da instância.
4. Clique em Migrar sessão.
5. Atualize a página do GronerZap para confirmar a conexão. Durante a migração, é normal o WhatsApp Web recarregar ou ser desconectado.

Se houver erro na conexão, verifique sua internet ou tente desconectar dispositivos antigos no WhatsApp antes de gerar um novo QR Code. Como alternativa, migre para a API oficial do Meta, que não depende do pareamento por QR Code (veja a seção QR Code ou API Oficial: qual escolher).

Se o chat continuar desconectado

Se, mesmo após reconectar pelo QR Code, você não conseguir enviar ou receber mensagens, atualize a página e tente novamente. Se o problema persistir, encaminhe a ocorrência para análise da equipe de engenharia, informando o link da página e descrevendo a ação realizada quando o erro aconteceu.

Veja também

• Como ativar o GronerZap (Antigo)
• Como conectar número no Gronerzap (Novo)
• Como alterar o número do Gronerzap (Antigo)

Atualizado em: 09/09/2026