Guia do GronerZap: API oficial do WhatsApp e conexão por QR Code

O GronerZap é a central de atendimento por WhatsApp embutida no Groner CRM: cada conversa fica ligada ao negócio do cliente e todo o histórico fica salvo no Groner. A grande novidade é a possibilidade de conectar seu número pela API oficial do WhatsApp, o caminho oficial e em conformidade oferecido pela Meta. Este guia explica o que é o GronerZap, detalha a conexão pela API oficial (a forma recomendada), mostra também a conexão tradicional por QR Code, compara as duas e traz a rotina de uso e as boas práticas para operar com segurança.

Índice

1. O que é o GronerZap
2. A novidade: conexão pela API oficial do WhatsApp
3. Como conectar pela API oficial
4. Como conectar pelo método tradicional (QR Code)
5. API oficial vs QR Code: vantagens e tradeoffs
6. O GronerZap no dia a dia
7. Boas práticas e cuidados

1. O que é o GronerZap

O GronerZap é a central de atendimento por WhatsApp embutida dentro do Groner CRM. Em vez de manter o WhatsApp aberto em uma aba separada, o celular na mão do vendedor e o CRM em outro lugar, o GronerZap traz a conversa para dentro do mesmo sistema onde você já gerencia seus negócios. Cada conversa fica ligada ao negócio correspondente, e todo o histórico de mensagens fica salvo no Groner.

Na prática, isso muda a forma de atender. Quando um cliente manda mensagem, você não está só respondendo um contato solto: você está conversando com um negócio que tem etapa no funil, propostas, atividades e tarefas. Tudo isso aparece ao lado da conversa. E porque o histórico fica salvo no Groner, a memória do atendimento não depende de um aparelho específico nem se perde quando alguém troca de telefone ou sai da empresa.

Principais recursos

• Inbox unificado: todas as conversas dos seus números de WhatsApp em um só lugar, dentro do Groner.
• Painel lateral do negócio: ao lado de cada conversa você vê os dados do lead, as propostas, as atividades e as tarefas daquele negócio, e pode movê-lo de etapa do funil ou marcar perda sem sair da tela.
• Mensagens rápidas: textos prontos disparados ao digitar "/" seguido do comando da mensagem, para responder o que se repete sem reescrever.
• Follow-up sugerido por inteligência artificial: o GronerZap sugere a próxima mensagem de retomada do contato. Esse recurso consome créditos.
• Encaminhar mensagens: repasse uma mensagem recebida para outra conversa.
• Vários números (instâncias): opere mais de um número de WhatsApp na mesma central, conforme o seu plano.
• Aplicativo instalável (PWA): instale o GronerZap no computador e no celular, com notificações de novas mensagens.

Duas formas de conectar um número

O GronerZap oferece duas maneiras de conectar um número de WhatsApp, e a escolha entre elas é uma das decisões mais importantes ao começar:

• Conexão pela API oficial do WhatsApp (WhatsApp Business Platform, da Meta): a forma oficial e em conformidade, com o número hospedado na nuvem da Meta. Não depende de um celular ligado e tem risco de bloqueio mínimo quando se seguem as políticas. Você conecta pelo botão "Conectar WhatsApp Business", que abre o onboarding oficial da Meta, sem escanear QR Code.
• Conexão tradicional por QR Code (ou código de pareamento): vincula o GronerZap como um dispositivo de um WhatsApp ou WhatsApp Business já existente no celular. Setup rápido e sem verificação de negócio, com texto livre a qualquer hora e suporte a grupos, mas depende do celular conectado à internet e tem risco de bloqueio se houver automação pesada ou disparos em massa.

As duas formas são detalhadas nas próximas seções deste guia. Se você ainda não sabe qual escolher, a regra simples é: para atendimento profissional e em escala, prefira a API oficial; para começar rápido com um número que já está em uso, a conexão por QR Code resolve.

Pré-requisitos para usar

Antes de conectar o primeiro número, garanta que você tem:

1. Plano compatível: a disponibilidade do GronerZap, o número de instâncias e alguns recursos dependem do seu plano no Groner.
2. Login do Groner: o acesso ao GronerZap é o mesmo do Groner CRM. Não há cadastro nem senha separados.
3. Um número de WhatsApp: o número que você vai conectar à central. Dependendo da forma de conexão escolhida, há requisitos adicionais para esse número, detalhados nas seções de conexão.

2. A novidade: conexão pela API oficial do WhatsApp

Esta é a grande novidade do GronerZap: agora você pode conectar seu número usando a API oficial do WhatsApp, a plataforma que a própria Meta (empresa dona do WhatsApp) oferece para empresas atenderem clientes em escala, com estabilidade e dentro das regras. Ela é conhecida como WhatsApp Business Platform e roda na nuvem da Meta.

Até então, a forma de ligar um número ao GronerZap era a conexão tradicional por QR Code, em que o sistema se conecta a um WhatsApp que já está rodando no seu celular. Esse método continua disponível e é muito útil em vários casos. Mas a conexão pela API oficial muda o jogo para quem quer um atendimento sério, profissional e confiável.

O que é a API oficial, em linguagem simples

Pense na diferença entre "pendurar" o GronerZap em um celular versus colocar o seu número direto na infraestrutura da Meta.

• Na conexão por QR Code, o seu número continua morando no aparelho. O GronerZap age como um dispositivo a mais conectado àquele WhatsApp, parecido com o WhatsApp Web. Se o celular desligar, ficar sem internet ou for reiniciado, a conexão pode cair.
• Na API oficial, o seu número passa a ser hospedado na nuvem da Meta. Ele não fica mais dependente de um aparelho ligado. O GronerZap conversa diretamente com a plataforma da Meta para enviar e receber mensagens.

Na prática, é a diferença entre um número "emprestado" de um celular e um número que pertence, de forma oficial e registrada, à sua empresa dentro do ecossistema do WhatsApp. Um exemplo do dia a dia: se o vendedor leva o celular para o almoço fora da empresa e a bateria acaba, na conexão por QR Code o atendimento para; na API oficial as mensagens continuam chegando normalmente, porque o número não depende daquele aparelho.

Como conectar pela API oficial no GronerZap

A conexão é feita por um assistente guiado, sem QR Code e sem precisar mexer no celular. Em resumo, você escolhe a opção "Conectar WhatsApp Business", faz login com a sua conta Meta, autoriza o GronerZap, escolhe ou cria a sua conta Meta Business e a sua conta WhatsApp Business (WABA), e registra o número de telefone. Ao final, o número fica conectado pela plataforma oficial da Meta, sem que em nenhum momento você precise escanear um QR Code. O passo a passo completo, com pré-requisitos e dicas, está na seção 3.

O que muda na prática

A conexão pela API oficial traz mudanças concretas no dia a dia do atendimento:

• Estabilidade real, sem depender de celular ligado. Como o número fica na nuvem da Meta, ele não cai porque o aparelho descarregou, ficou sem sinal ou foi reiniciado. O atendimento não para por causa de um celular.
• Conformidade e risco de bloqueio mínimo. Este é o caminho que a própria Meta oferece e recomenda. Seguindo as políticas do WhatsApp, o risco de o número ser bloqueado é mínimo. Você atende com tranquilidade, sem o medo de perder o número de uma hora para outra.
• Conta de empresa verificada. A API oficial permite que sua empresa passe pela verificação de negócio e exiba um perfil de empresa verificada, transmitindo mais confiança ao cliente.
• Caminho oficial de longo prazo. É a base correta para crescer o atendimento, integrar com mais ferramentas e operar com previsibilidade.

O que você precisa saber antes de migrar

A API oficial é poderosa, mas tem algumas regras próprias da Meta que valem conhecer desde já. Em resumo, você vai precisar de uma conta Meta Business, de um número adequado (o número não pode estar ativo no app comum do WhatsApp; se já estiver em uso ali, será preciso migrá-lo) e da verificação de negócio para crescer os limites de envio. No uso diário, para iniciar conversas ou falar fora da janela de 24 horas entram os modelos de mensagem (templates), há um custo por mensagem de modelo cobrado pela Meta, os limites de envio sobem em faixas e a API oficial não envia mensagens em grupos. Todos esses pontos estão detalhados na seção 3.3.

Em resumo

Comparando os dois caminhos em poucas linhas:

• Onde o número fica: na API oficial, hospedado na nuvem da Meta, sem depender de celular ligado; no QR Code, vinculado ao seu celular.
• Estabilidade e bloqueio: a API oficial é mais estável e tem risco de bloqueio mínimo seguindo as políticas; o QR Code pode cair e corre mais risco em automação pesada.
• Liberdade de mensagem: o QR Code envia texto livre a qualquer hora e suporta grupos; a API oficial exige modelos de mensagem para iniciar conversa ou falar fora das 24h e não envia em grupos.
• Custo e setup: a API oficial tem custo por mensagem de modelo e mais etapas no início; o QR Code não tem cobrança da Meta e o setup é rápido.

A tabela comparativa completa, ponto a ponto, está na seção 5.

Por que a API oficial é a forma recomendada

Para a maioria das empresas que levam o atendimento a sério, a API oficial é a melhor escolha porque entrega o que mais importa no dia a dia: um número estável, que não cai junto com o celular, e a segurança de operar dentro das regras da Meta, com risco de bloqueio mínimo. Some a isso o perfil de empresa verificada e você tem uma operação mais profissional e confiável aos olhos do cliente.

A conexão tradicional por QR Code continua sendo uma ótima opção para quem precisa começar rápido, atende em volume menor, conversa muito por texto livre e eventualmente usa grupos. Mas, se o objetivo é construir um atendimento robusto e duradouro, a recomendação é conectar pela API oficial do WhatsApp.

3. Como conectar pela API oficial

A conexão pela API oficial do WhatsApp (a WhatsApp Business Platform da Meta) é a forma recomendada de ligar um número ao GronerZap. Em vez de vincular o seu celular lendo um QR Code, você autoriza o GronerZap diretamente na Meta, e o número passa a funcionar pela infraestrutura oficial da própria Meta. Isso significa que o número fica hospedado na nuvem da Meta e não depende de um aparelho ligado e online o tempo todo, além de ser o caminho em conformidade, com risco mínimo de bloqueio quando você segue as políticas.

Esta seção mostra exatamente como fazer essa conexão, o que preparar antes, e o que muda no seu dia a dia depois que o número estiver conectado.

3.1. Pré-requisitos

Antes de começar, confira estes três pontos. Eles evitam a maioria dos problemas durante a conexão:

1. Conta Meta Business. Você precisa de uma conta Meta Business (o gerenciador de negócios da Meta) ou de permissão para usar uma já existente da sua empresa. Se não tiver, você consegue criar uma durante o próprio processo de conexão.
2. Um número que não esteja ativo no WhatsApp comum. O número que você vai conectar não pode estar em uso no aplicativo comum do WhatsApp (o WhatsApp consumidor, de uso pessoal). Você tem duas opções:

• usar um número novo, que nunca foi ativado no WhatsApp comum; ou
• migrar um número que já está no WhatsApp comum, apagando-o do aplicativo do celular para liberá-lo para a plataforma oficial.

  
  

  
  Tenha esse número à mão, pois você vai receber um código de confirmação nele (por SMS ou ligação). Observação: para números que hoje estão no aplicativo WhatsApp Business, a Meta possui em muitos casos um recurso de coexistência que permite manter o mesmo número no app e na plataforma oficial ao mesmo tempo. A disponibilidade depende do tipo de conexão e do onboarding; siga o que o assistente da Meta apresentar durante o processo.

3. Verificação do negócio (Business Verification). A conexão funciona mesmo sem a verificação concluída, mas, enquanto ela não é feita, a conta fica limitada a um patamar inicial (em torno de 250 novos contatos por dia) e não progride para faixas maiores. A verificação do negócio, em que você comprova que a empresa é real (com documentos como CNPJ, por exemplo), é a condição para subir de faixa, e não apenas um acelerador. Por isso, recomendamos iniciar essa verificação logo após conectar.

3.2. Passo a passo da conexão

1. No GronerZap, abra a tela de números/instâncias e clique em "Conectar WhatsApp Business".
2. Será aberto o onboarding oficial da Meta. Faça login com a sua conta Meta (a mesma que você usa no Facebook/gerenciador de negócios). Se aparecer uma tela de permissões, autorize o GronerZap a gerenciar o WhatsApp em nome da sua empresa.
3. Escolha ou crie a conta Meta Business. Se a sua empresa já tem uma, selecione-a. Se não tem, use a opção de criar uma nova ali mesmo, informando o nome da empresa.
4. Escolha ou crie a conta do WhatsApp Business (WABA). A WABA é a conta dentro da Meta que vai abrigar o seu número. Selecione uma existente ou crie uma nova.
5. Registre o número de telefone. Digite o número que será conectado (o que atende ao pré-requisito de não estar ativo no app comum). A Meta enviará um código de confirmação por SMS ou ligação.
6. Confirme o número digitando o código recebido.
7. Conclua o fluxo. A janela da Meta se fecha e você volta ao GronerZap. Em alguns instantes o número aparece como conectado pela plataforma oficial.

Observe que em nenhum momento você escaneia um QR Code nem vincula o seu celular. A autorização acontece toda na conta Meta.

3.3. O que esperar depois de conectar

Depois que o número está conectado pela API oficial, algumas regras da própria Meta passam a valer. Vale entendê-las para não se frustrar achando que é limitação do GronerZap. Esta é a referência completa dessas regras; outras seções do guia apenas remetem a ela.

Modelos de mensagem (templates) e a janela de 24 horas

Esta é a diferença mais importante em relação à conexão por QR Code.

• Janela de 24 horas. Sempre que um cliente te envia uma mensagem, abre-se uma janela de 24 horas. Dentro dessa janela você pode responder livremente, com texto livre, como em qualquer conversa normal (conforme o suporte do canal a outros formatos).
• Fora da janela ou para iniciar a conversa. Se você quer ser o primeiro a falar com o cliente, ou se já se passaram mais de 24 horas desde a última mensagem dele, você não pode mandar texto livre. Nesse caso é obrigatório usar um modelo de mensagem (template) aprovado pela Meta.
• O que é um modelo aprovado. É um texto pré-cadastrado e submetido à Meta para aprovação. Ele pode ter partes variáveis (como o nome do cliente). Depois de aprovado, fica disponível para envio. A aprovação é feita pela Meta e o prazo varia; muitas vezes sai em poucas horas, mas pode demorar mais.

Resumindo a lógica de quando você pode mandar cada coisa:

Outros pontos da plataforma oficial

• Custo por mensagem de modelo (template). A Meta cobra por mensagem de modelo entregue, e não uma taxa única pela conversa de 24 horas. O valor varia conforme a categoria do modelo: marketing, utilidade ou autenticação. Já as mensagens de serviço (texto livre que você envia em resposta ao cliente dentro da janela de 24 horas) não têm custo. Os modelos de utilidade enviados dentro da janela de 24 horas também são gratuitos. Esse custo é da Meta e independe do GronerZap. Os valores variam por país e categoria e são definidos pela Meta; consulte a tabela oficial de preços do WhatsApp Business Platform para o Brasil para conferir a ordem de grandeza.
• Limites de envio em faixas (tiers). Você começa com um limite de quantos clientes novos pode iniciar conversa por dia. Sem a verificação do negócio, esse limite fica travado em torno de 250 novos contatos por dia. Concluída a verificação, o limite sobe em faixas (1.000, 10.000, 100.000 e mais) conforme você usa o número com boa qualidade (sem muitos bloqueios ou denúncias).
• Perfil de empresa verificada. O número pode exibir um selo/identidade de empresa verificada, o que passa mais confiança ao cliente.
• Grupos não são suportados. Pela API oficial não é possível enviar nem participar de grupos do WhatsApp. Se você depende de grupos, considere a conexão tradicional por QR Code.

3.4. Dicas de solução de problemas (troubleshooting)

• "Este número já está em uso" ou o número não é aceito. O número provavelmente ainda está ativo no WhatsApp comum. Abra o WhatsApp nesse aparelho, apague a conta desse número nas configurações do app e tente conectar de novo. Para um número totalmente novo, confirme que ele nunca foi ativado no app.
• Não recebi o código de confirmação. Verifique se o número foi digitado com o código do país (no Brasil, +55) e DDD corretos. Tente a opção de receber por ligação em vez de SMS. Espere um ou dois minutos antes de pedir um novo código, para não bloquear o reenvio.
• A janela da Meta fechou no meio do processo ou deu erro de login. Refaça desde o início clicando novamente em "Conectar WhatsApp Business". Garanta que está logado na conta Meta certa (a que tem acesso à conta Meta Business da empresa). Se possível, use um navegador atualizado e desative bloqueadores de pop-up, pois o processo abre uma janela da Meta.
• Sem permissão para a conta Meta Business. Se você não consegue selecionar a conta da empresa, é porque o seu usuário não tem acesso a ela. Peça ao administrador da conta Meta Business para te conceder acesso e tente de novo.
• Conectou, mas não consigo iniciar conversa com clientes. Isso é esperado: para iniciar conversa você precisa de um modelo de mensagem aprovado. Cadastre e aprove pelo menos um modelo antes de começar a abordar clientes.
• Meus limites de envio estão baixos. Aumente a qualidade do número (evite denúncias e bloqueios) e conclua a verificação do negócio na Meta, que é o que destrava as faixas maiores de envio.
• Preciso de grupos ou de envio livre sem aprovação de modelos. A API oficial não atende esses casos. Avalie usar a conexão tradicional por QR Code, lembrando que ela tem outras limitações e maior risco de bloqueio em uso intenso.

4. Como conectar pelo método tradicional (QR Code)

Este é o jeito mais rápido de colocar um número para funcionar no GronerZap. Você vincula o número como um aparelho de um WhatsApp ou WhatsApp Business que já existe num celular, do mesmo modo que você usa o WhatsApp no computador. O GronerZap gera um QR Code (ou um código de pareamento) e o seu celular faz a leitura para autorizar a conexão.

Diferente da API oficial do WhatsApp, aqui não há onboarding da Meta, não precisa de conta Meta Business, não há verificação de negócio e não há cobrança da Meta. Em compensação, o celular precisa continuar ligado e conectado à internet, e a conexão é do tipo dispositivo vinculado (não oficial), então automação pesada ou disparos em massa podem levar o número a ser bloqueado pelo WhatsApp.

4.1. Quando usar QR Code e quando usar código de pareamento

As duas opções conectam exatamente o mesmo número, do mesmo jeito. A diferença está apenas em como o celular confirma a conexão.

Na dúvida, comece pelo QR Code, que é o caminho mais comum. Se a leitura não funcionar, troque para o código de pareamento sem sair da tela.

4.2. Antes de começar

• Tenha o celular com o número que você quer conectar em mãos, desbloqueado.
• Garanta que o celular esteja conectado à internet (Wi-Fi ou dados móveis).
• Confirme que é o número certo. Esse número continuará funcionando normalmente no celular e ficará espelhado no GronerZap.
• No GronerZap, abra a tela de conexão do número. Ela mostra o QR Code e a opção de código de pareamento.

4.3. Passo a passo pelo QR Code

No GronerZap, deixe a tela com o QR Code aberta. No celular, faça o seguinte:

1. Abra o WhatsApp no seu celular
2. Toque no ícone de "Menu", "Perfil" ou "Configurações"
3. Selecione "Dispositivos conectados"
4. Selecione "Conectar dispositivo"
5. Aponte a câmera para o QR Code apresentado na tela do GronerZap
6. Aguarde alguns segundos até aparecer "Conectado". Pode fechar a janela.

Quando o status mudar para "Conectado", o número já está vinculado e pronto para enviar e receber mensagens dentro do GronerZap.

4.4. Passo a passo pelo código de pareamento

Use este caminho quando não for possível escanear o QR Code. Siga os passos 1 a 4 da seção 4.3 e, no lugar de escanear o QR Code:

5. Selecione "Conectar com numero de telefone" e depois "Insira o codigo de pareamento apresentado"
6. Aguarde alguns segundos até aparecer "Conectado". Pode fechar a janela.

O GronerZap mostra na tela um código (normalmente uma sequência de letras e números). Digite esse código no celular exatamente como aparece. Faça isso com calma, pois o código tem validade curta.

4.5. Solução de problemas

O QR Code ou o código expirou

Por segurança, tanto o QR Code quanto o código de pareamento têm validade curta e se renovam de tempos em tempos. Se aparecer aviso de expiração ou se o código não funcionar:

1. Volte para a tela de conexão no GronerZap.
2. Gere um novo QR Code ou um novo código de pareamento (atualize a tela se necessário).
3. Tenha o celular já na etapa "Conectar dispositivo" antes de iniciar a leitura, para não perder tempo.

A conexão está demorando para concluir

Se após a leitura o status não mudar para "Conectado":

1. Confirme que o celular e o computador estão com internet ativa e estável.
2. Aguarde alguns segundos. A primeira sincronização pode levar um instante.
3. Se não concluir, gere um novo código e refaça a leitura.
4. Evite trocar de rede (sair do Wi-Fi para dados móveis) durante o processo.

Não tenho câmera ou a câmera não lê o QR Code

Use o código de pareamento. Na etapa "Conectar dispositivo", selecione "Conectar com numero de telefone" e depois "Insira o codigo de pareamento apresentado", e digite no celular o código mostrado na tela do GronerZap. Esse caminho dispensa totalmente a câmera.

A conexão caiu e o número parou de funcionar

Como este método depende do celular, a sessão pode cair se o aparelho ficar muito tempo desligado, sem internet ou com bateria esgotada. Para reconectar:

1. Verifique se o celular está ligado, com internet e com o WhatsApp aberto pelo menos uma vez.
2. No GronerZap, abra novamente a tela de conexão do número.
3. Refaça o passo a passo do QR Code ou do código de pareamento, do mesmo jeito da primeira vez.
4. Aguarde até aparecer "Conectado".

Para manter a conexão estável no dia a dia, deixe o celular do número sempre ligado, carregado e conectado à internet. Se este número for usado para muito volume de atendimento, considere a conexão pela API oficial do WhatsApp, que não depende de um celular ligado e tem menor risco de bloqueio.

4.6. Pontos de atenção deste método

• O celular precisa permanecer ligado e conectado à internet para o número continuar funcionando.
• A sessão pode cair e exigir uma nova conexão, seguindo os mesmos passos acima.
• Você envia mensagens de texto livre a qualquer momento, sem precisar de modelos de mensagem aprovados.
• Este método suporta grupos.
• O setup é rápido e não exige verificação de negócio.
• Por ser uma conexão não oficial de dispositivo vinculado, automação pesada e disparos em massa correm risco de bloqueio do número pelo WhatsApp. Para esses casos, avalie a conexão pela API oficial do WhatsApp.

5. API oficial vs QR Code: vantagens e tradeoffs

Existem duas formas diferentes de conectar um número de WhatsApp ao GronerZap, e elas não são apenas "dois botões para o mesmo fim". Cada uma usa uma tecnologia diferente por baixo e, por isso, muda o que você pode fazer no dia a dia, o quanto a conexão é estável e até se você paga ou não pelo envio. Entender essa diferença antes de conectar evita frustração depois.

De forma resumida:

• API oficial do WhatsApp (a novidade): seu número fica hospedado na própria nuvem da Meta, dentro da WhatsApp Business Platform. Você conecta pelo onboarding oficial da Meta, sem QR Code. É o caminho oficial e em conformidade.
• Conexão tradicional por QR Code (o método clássico): você vincula ao GronerZap um WhatsApp ou WhatsApp Business que já existe no seu celular, como se o GronerZap fosse mais um aparelho conectado àquela conta. É rápido de ligar, mas é uma conexão de dispositivo vinculado, não oficial.

A seguir, o comparativo honesto entre as duas, ponto a ponto.

5.1. Como cada uma conecta, em uma frase

• API oficial: você usa a opção "Conectar WhatsApp Business", faz login na sua conta Meta, escolhe ou cria a conta Meta Business e a conta WhatsApp Business (WABA), e registra o número. O número passa a viver na plataforma da Meta. Não há QR Code.
• QR Code: o GronerZap mostra um QR Code (ou um código de pareamento) e você lê esse código pelo seu celular, em "Dispositivos conectados". O número continua sendo o do seu aparelho; o GronerZap vira só mais um ponto de acesso a ele.

5.2. Tabela comparativa

5.3. Entendendo os pontos que mais geram dúvida

Alguns itens da tabela merecem um pouco mais de contexto, porque é onde a maioria das pessoas se confunde.

A janela de 24 horas e os modelos de mensagem. Na API oficial, dentro da janela de 24 horas você responde com texto livre; fora dela, ou para iniciar a conversa, é preciso um modelo de mensagem aprovado. Essa regra existe para proteger o usuário de spam, e é da plataforma oficial, não do GronerZap. A lógica completa está na tabela da seção 3.3.

O custo do envio. Na API oficial, a Meta cobra por mensagem de modelo (template) entregue, com valor que depende da categoria (marketing, utilidade ou autenticação); mensagens de serviço dentro da janela de 24h não têm custo. Isso significa que, em uma operação de volume, há um custo variável que não existe na conexão por QR Code. Em compensação, você ganha estabilidade, conformidade e a tranquilidade de não ter o número bloqueado por estar fazendo o uso correto. Os detalhes e o caminho para consultar valores estão na seção 3.3.

O risco de bloqueio na conexão por QR Code. A conexão tradicional é prática, mas é uma conexão de dispositivo vinculado, pensada para uso pessoal/atendimento manual. Quando ela é usada para automação intensa ou disparos em massa, o próprio WhatsApp pode interpretar como comportamento abusivo e bloquear o número. Por isso, quanto mais profissional e em volume for a sua operação, mais vale a pena estar na via oficial.

O número que você vai usar. Para a API oficial, o número precisa não estar ativo no app comum do WhatsApp (ou você precisa migrar esse número para a plataforma oficial); números do aplicativo WhatsApp Business podem, em muitos casos, coexistir com a plataforma oficial. Já no QR Code, você conecta exatamente o número que já está no seu celular, sem mexer em nada.

Grupos. Este costuma ser o fator decisivo para muita gente: a API oficial não envia mensagens em grupos. Se a sua operação depende de grupos de WhatsApp, a conexão por QR Code é a única que atende.

5.4. Quando escolher cada uma

Não existe opção "melhor" no abstrato. Existe a opção certa para o seu momento e o seu tipo de uso.

Escolha a API oficial do WhatsApp quando:

1. Sua operação é séria, profissional e tende a crescer em volume.
2. Você quer estabilidade total, sem depender de um celular ligado e sem risco de a sessão cair.
3. Você quer ficar em conformidade e com risco de bloqueio mínimo.
4. Faz sentido enviar mensagens iniciando conversas (com modelos aprovados) e você aceita o custo por mensagem de modelo cobrado pela Meta.
5. Ter um perfil de empresa verificada agrega valor à sua marca.
6. Você não depende de enviar mensagens em grupos.

Escolha a conexão tradicional por QR Code quando:

1. Você quer fazer um teste rápido ou colocar o atendimento no ar em poucos minutos.
2. O uso é pequeno, manual, sem automação pesada nem disparos em massa.
3. Você precisa enviar mensagens em grupos.
4. Você quer usar exatamente o número que já está no seu celular, sem migrar nada e sem verificação de negócio.
5. Você não quer ter custo de envio da Meta e topa, em troca, o risco e a menor estabilidade da conexão não oficial.

Uma forma simples de decidir: se o WhatsApp é um canal central da sua empresa e você pretende escalar, vá de API oficial. Se é um uso leve, exploratório ou que depende de grupos, comece pela conexão por QR Code, e migre para a oficial quando a operação amadurecer.

6. O GronerZap no dia a dia

Esta seção mostra a rotina prática de quem atende: como abrir e responder conversas, como usar o painel do negócio que fica ao lado da conversa, como agilizar respostas e como aproveitar os recursos do dia a dia sem perder o foco no atendimento.

6.1 Onde tudo acontece: o inbox unificado

O inbox é a tela principal do GronerZap. Ele reúne, em um só lugar, todas as conversas dos seus números conectados (cada número conectado é uma instância). Em vez de pular de aparelho em aparelho ou de aplicativo em aplicativo, você trabalha tudo de dentro do Groner, e cada conversa fica salva e ligada ao negócio do cliente.

A tela costuma ter três áreas:

1. Lista de conversas (esquerda): todas as conversas, ordenadas pela mais recente, com prévia da última mensagem e indicador de mensagens não lidas.
2. Conversa aberta (centro): o histórico de mensagens trocadas e o campo para escrever e enviar.
3. Painel lateral do negócio (direita): os dados do cliente e do negócio ligado àquela conversa.

Dica: o GronerZap pode ser instalado como aplicativo no computador e no celular (PWA), com notificações. Assim você é avisado de novas mensagens mesmo sem estar com a aba aberta. O login é o mesmo do Groner CRM, então não há senha nova para decorar. A disponibilidade dos recursos depende do seu plano.

6.2 Abrir e responder uma conversa

1. No inbox, clique na conversa desejada na lista da esquerda.
2. Leia o histórico no centro da tela. Tudo o que já foi trocado naquele número aparece ali, inclusive mensagens de atendimentos anteriores.
3. Escreva no campo de mensagem e envie. Você conversa com texto livre, como em um WhatsApp comum.
4. Ao enviar, a mensagem sai pelo número conectado e fica registrada no histórico do negócio dentro do Groner.

Atenção à janela de 24 horas (números conectados pela API oficial): se o número foi conectado pela API oficial do WhatsApp, você só responde com texto livre dentro da janela de 24 horas, ou seja, até 24 horas depois da última mensagem que o cliente enviou. Passou desse prazo, ou você quer iniciar a conversa do zero, é preciso usar um modelo de mensagem (template) aprovado pela Meta. Para números conectados pela conexão tradicional por QR Code, não existe essa restrição: você envia texto livre a qualquer hora. A lógica completa está na tabela da seção 3.3.

6.3 A conversa ligada ao negócio

A força do GronerZap está em manter cada conversa amarrada a um negócio. Assim, o que você conversa vira histórico do cliente, e qualquer pessoa da equipe entende o contexto depois.

• Cada conversa fica ligada ao negócio do cliente, e o painel lateral mostra os dados desse negócio ao lado da conversa.
• Com isso, a partir do momento em que você atende, tudo o que for trocado fica organizado no negócio certo, sem depender de um aparelho específico nem se perder com troca de pessoa no atendimento.

6.4 O painel lateral do negócio

Com a conversa ligada ao negócio, o painel da direita vira sua central de trabalho. Sem trocar de tela, você vê e age sobre o negócio enquanto conversa. O que você encontra ali:

Como usar no dia a dia:

1. Confira o lead antes de responder, para chamar o cliente pelo nome e já saber com quem fala.
2. Olhe as propostas e atividades para retomar de onde parou e não repetir perguntas.
3. Mova de etapa assim que a conversa avançar (por exemplo, quando o cliente aceita receber uma proposta), para o funil refletir a realidade.
4. Crie ou conclua tarefas para não deixar nenhum follow-up cair no esquecimento.
5. Marque perda quando o cliente desistir ou sumir de vez, sempre com o motivo, para alimentar os relatórios e liberar seu foco.

6.5 Mensagens rápidas com "/comando"

Para não reescrever as mesmas mensagens o dia inteiro, use as mensagens rápidas.

1. No campo de mensagem, digite "/" (barra).
2. Aparece a lista de mensagens rápidas cadastradas. Continue digitando o nome do comando para filtrar.
3. Selecione a mensagem desejada. O texto é inserido no campo, pronto para enviar.
4. Antes de enviar, ajuste o que precisar (um nome, um valor, um detalhe).

Mensagens rápidas são ideais para saudações, respostas a perguntas frequentes, instruções de pagamento, pedidos de documento e qualquer texto que você repete sempre. Padronizam o atendimento e economizam tempo.

6.6 Follow-up sugerido por inteligência artificial

Quando você não sabe bem como retomar um cliente parado, ou quer uma resposta mais bem escrita, o GronerZap pode sugerir um follow-up com inteligência artificial. A IA lê o contexto da conversa e propõe um texto para você dar sequência ao atendimento.

• O texto sugerido é um ponto de partida: leia, ajuste ao seu tom e ao caso antes de enviar.
• Esse recurso consome créditos. Cada sugestão usa créditos da sua conta, então use quando realmente agregar.
• A disponibilidade depende do seu plano.

6.7 Encaminhar mensagens

Precisa repassar para um colega o que o cliente mandou, ou reaproveitar uma mensagem em outra conversa? Use o encaminhar.

1. Localize a mensagem no histórico da conversa.
2. Acione a opção de encaminhar na mensagem.
3. Escolha a conversa ou o contato de destino.
4. Confirme o envio.

É o jeito rápido de levar uma informação, um comprovante ou um arquivo de uma conversa para outra sem precisar copiar e colar.

6.8 Trabalhar com vários números (instâncias)

Conforme o plano, sua empresa pode ter mais de um número conectado ao GronerZap (por exemplo, um para vendas e outro para suporte). Cada número conectado é uma instância.

• Todas as conversas de todos os números chegam ao mesmo inbox.
• Ao responder, confira de qual número a mensagem vai sair, para falar com o cliente pelo número certo (o número de vendas responde como vendas, o de suporte como suporte).

Trabalhar com vários números em um inbox só evita ter vários aparelhos na mesa e garante que nenhuma conversa fique perdida em um celular esquecido.

6.9 Rotina recomendada de atendimento

Para fechar a seção, um roteiro prático que junta tudo:

1. Abra o GronerZap (no computador ou no celular, pelo aplicativo instalado) e cheque as notificações.
2. Abra a conversa e leia o histórico no centro da tela.
3. Confirme no painel lateral quem é o lead e em que etapa está o negócio.
4. Responda, usando mensagens rápidas com "/" quando der, e o follow-up por IA quando precisar de ajuda para retomar.
5. Atualize o negócio: mova de etapa, crie ou conclua tarefas e, se for o caso, marque a perda com o motivo.
6. Se o número estiver na API oficial, fique atento à janela de 24 horas e use modelos de mensagem quando ela estiver fechada.
7. Repita pela lista até zerar as conversas que aguardam resposta.

Seguindo essa rotina, cada atendimento fica registrado no negócio certo, o funil reflete a realidade e nenhum cliente fica sem retorno.

7. Boas práticas e cuidados

Esta seção reúne o que faz a diferença entre um WhatsApp que vende e atende bem por anos e um número que perde alcance, cai de qualidade ou é bloqueado. Algumas práticas valem para os dois modos de conexão (API oficial e conexão tradicional por QR Code) e outras são específicas de cada um. Leia tudo antes de colocar a operação para rodar no dia a dia.

7.1. O efeito do disparo em massa em cada modo

O comportamento de envio em massa é o ponto que mais separa os dois modos de conexão na hora dos cuidados. O resto das diferenças (onde fica o número, janela de 24h, custo, grupos) está na tabela da seção 5.2.

Mesmo com regras diferentes, o objetivo é o mesmo nos dois casos: falar com quem quer ser falado, na hora certa, com mensagem útil. Quem respeita isso quase nunca tem problema.

7.2. Evite disparos em massa

Disparo em massa é o hábito mais perigoso para qualquer número de WhatsApp, independente do modo de conexão. O efeito, porém, é diferente em cada caminho.

Na conexão tradicional por QR Code. Aqui o risco é o mais grave: bloqueio do número. A conexão por QR Code é uma sessão de dispositivo vinculado, não um canal oficial de envio. Quando o WhatsApp percebe padrões de automação pesada (muitas mensagens iguais, em sequência, para contatos que não falaram com você antes, com link repetido), ele pode limitar ou banir o número. Recuperar um número banido é difícil e, muitas vezes, impossível. Como o número costuma ser o mesmo que a empresa usa há anos, o prejuízo é alto.

Na API oficial. O número não corre o risco imediato de banimento, mas três coisas são afetadas:

1. Qualidade. A Meta mede a qualidade do seu número a partir de como as pessoas reagem (bloqueios, denúncias, mensagens não respondidas). Disparo em massa de baixa relevância derruba essa nota.
2. Limites de envio. Os limites crescem em faixas conforme qualidade e uso saudável. Se a qualidade cai, você pode ser rebaixado de faixa e passar a poder iniciar menos conversas por dia.
3. Custo. Cada mensagem de modelo enviada tem custo cobrado pela Meta por categoria. Disparar para muita gente que não quer falar com você é pagar para perder reputação.

Como evitar na prática (vale para os dois):

• Fale com quem demonstrou interesse ou já é cliente; evite listas frias.
• Personalize. Mensagem útil e relevante é respondida; mensagem genérica vira denúncia.
• Respeite quem pede para parar. Saídas e bloqueios pesam contra você.
• Para comunicação em escala, use a API oficial com modelos de mensagem aprovados e na categoria correta, nunca a conexão por QR Code.
• Cresça o volume aos poucos. Subir de zero para milhares de mensagens num dia é o padrão clássico que dispara alarme.

7.3. Mantenha o número e a sessão saudáveis

Um número conectado e estável é a base de tudo. As atenções mudam conforme o modo.

Conexão tradicional por QR Code:

• O celular onde o WhatsApp está instalado precisa ficar ligado e conectado à internet. Se o aparelho fica sem rede ou desligado por muito tempo, a sessão do GronerZap cai.
• A sessão de dispositivo vinculado pode expirar ou ser derrubada (troca de celular, reinstalação do WhatsApp, limpeza de dispositivos conectados). Quando isso acontece, basta reconectar, repetindo no celular o passo a passo da seção 4.3 (ou o do código de pareamento, na seção 4.4).
• Não remova o GronerZap da lista de "Dispositivos conectados" do celular sem necessidade: isso encerra a conexão.

API oficial do WhatsApp:

• O número fica hospedado na nuvem da Meta. Não depende de celular ligado, então a estabilidade do dia a dia é muito maior.
• Use um número que não esteja ativo no app comum do WhatsApp, ou faça a migração desse número. Um número já em uso no WhatsApp comum não pode ser registrado na plataforma oficial ao mesmo tempo; já o aplicativo WhatsApp Business pode, em muitos casos, coexistir com a plataforma oficial.
• Faça a verificação do negócio (Business Verification) na conta Meta Business. Sem ela, você fica travado em um patamar inicial (cerca de 250 novos contatos por dia) e não sobe de faixa. Com ela, você progride para faixas maiores e ainda pode exibir o perfil de empresa verificada, o que aumenta a confiança do cliente.
• Cuide da nota de qualidade do número como descrito em 7.2: é ela que mantém seus limites altos.

7.4. Escreva modelos de mensagem claros e dentro das políticas

Modelos de mensagem (templates) são textos aprovados pela Meta usados para iniciar conversa com o cliente ou para falar fora da janela de 24 horas. A lógica completa de quando usar texto livre e quando usar modelo está na tabela da seção 3.3. Tudo isso vale na API oficial; na conexão por QR Code não existem modelos, mas as boas práticas de escrita continuam valendo.

Boas práticas de escrita do modelo:

• Escreva de forma clara, específica e honesta. Diga quem é você (a empresa) logo no início.
• Escolha a categoria correta ao cadastrar o modelo: marketing, utilidade ou autenticação. Categoria errada é motivo comum de reprovação e também muda o custo cobrado.
• Não disfarce marketing como utilidade. A Meta reclassifica e a reprovação prejudica a conta.
• Dê um caminho claro de saída quando for comunicação promocional (como parar de receber).
• Evite excesso de links, texto todo em maiúsculas, promessas exageradas e linguagem que pareça spam.
• Revise os campos variáveis (nome, valor, data) para que o texto faça sentido com qualquer dado preenchido.

Vale responder rápido: enquanto a janela de 24 horas está aberta, o atendimento é mais simples (texto livre, sem modelo) e, dependendo da categoria, mais barato.

7.5. Mantenha as conversas dentro do GronerZap

O GronerZap não é só um WhatsApp à parte: ele guarda o histórico e liga cada conversa ao negócio dentro do Groner. Conversar por fora (no celular pessoal, em outro aparelho ou app) quebra esse vínculo.

Por que centralizar no GronerZap importa:

• Histórico preservado. Tudo o que foi falado fica salvo no Groner e não se perde com troca de aparelho ou de pessoa no atendimento.
• Conversa ligada ao negócio. O painel lateral mostra os dados do lead, propostas, atividades e tarefas ao lado da conversa, sem precisar trocar de tela.
• Continuidade. Se outra pessoa assumir o atendimento, ela vê todo o contexto e não faz o cliente repetir tudo.
• Mais agilidade. Use as mensagens rápidas digitando "/" e o comando, encaminhe mensagens quando precisar e aproveite o follow-up sugerido por inteligência artificial (lembrando que ele consome créditos).
• Trabalhe de onde estiver. Instale o aplicativo (PWA) no computador e no celular para receber notificações e não perder mensagem. O login do GronerZap é o mesmo do Groner CRM.

Regra prática: se o cliente chamar no número pessoal de alguém, traga a conversa de volta para o GronerZap o quanto antes, para não deixar buraco no histórico.

7.6. Mantenha o negócio na etapa certa do funil

Atender bem inclui manter a organização do funil em dia. O painel lateral da conversa existe exatamente para isso: você conversa e atualiza o negócio no mesmo lugar.

• Mova de etapa assim que a situação mudar. Cliente avançou, pediu proposta, fechou? Atualize a etapa na hora, direto pelo painel ao lado da conversa.
• Marque a perda quando for o caso. Negócio perdido marcado corretamente limpa o funil e melhora seus indicadores e previsões.
• Use atividades e tarefas para não esquecer follow-up. O próximo contato combinado vira tarefa e não depende da memória de ninguém.
• Mantenha os dados do lead atualizados. Telefone, nome e informações corretas evitam erro de envio e melhoram a personalização das mensagens.

Um funil atualizado em tempo real é o que transforma as conversas do GronerZap em previsão de vendas confiável, em vez de um amontoado de mensagens soltas.

7.7. Resumo rápido

• Nada de disparo em massa: no QR Code o número pode ser bloqueado; na API oficial cai a qualidade, caem os limites e sobe o custo.
• Mantenha o número saudável: celular online no QR Code; número adequado e verificação do negócio na API oficial.
• Na API oficial, fale dentro da janela de 24 horas sempre que possível e use modelos de mensagem claros e na categoria certa fora dela.
• Centralize tudo no GronerZap para preservar histórico e o vínculo com o negócio.
• Mantenha o funil atualizado direto pelo painel lateral da conversa.

Veja também

• O que é o GronerZap (Antigo/Novo)
• Como ativar o Gronerzap (Novo)
• Como ativar o GronerZap (Antigo)

Atualizado em: 21/07/2026