> ## 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 ativar o Gronerzap (Novo) # Como ativar o GronerZap O [**GronerZap**](https://ajuda.groner.app/pt-br/article/o-que-e-o-gronerzap-antigonovo-34lnjm/?ref=groner-suporte) 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**. > ![](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/gronerzap-1_sk4ayq.png) ## 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**. > ![](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/groner-2_p8qom6.png) ## 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. > ![](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/groner-3_t2rk2a.png) ### 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. > ![](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/groner-4_msgm7n.png) ## 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)](https://ajuda.groner.app/pt-br/article/como-ativar-o-gronerzap-antigo-1jb9nhf/) * [Como conectar número no Gronerzap (Novo)](https://ajuda.groner.app/pt-br/article/como-conectar-numero-no-gronerzap-novo-cq08nw/) * [Como alterar o número do Gronerzap (Antigo)](https://ajuda.groner.app/pt-br/article/como-alterar-o-numero-do-gronerzap-antigo-1bdgmwa/)