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. Você pode conectar seus números de duas formas: pela API Oficial do WhatsApp (a plataforma oficial da Meta) ou pela API Não-Oficial, com QR Code. Este guia explica as duas, mostra o passo a passo de cada uma, compara vantagens e limites e traz as boas práticas para operar com segurança.

Índice

1. O que é o GronerZap
2. As duas formas de conectar um número
3. Como conectar pela API Oficial
4. O que muda depois de conectar pela API Oficial
5. Como conectar pela API Não-Oficial (QR Code)
6. API Oficial x QR Code: qual escolher
7. O GronerZap no dia a dia
8. Boas práticas e cuidados
9. Solução de problemas

1. O que é o GronerZap

Em vez de manter o WhatsApp aberto numa 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 em que você gerencia seus negócios. Quando um cliente manda mensagem, você vê ao lado da conversa a etapa do funil, a proposta, as tarefas e as atividades daquele negócio. E como o histórico fica salvo no Groner, a memória do atendimento não depende de um aparelho nem se perde quando alguém troca de telefone ou sai da empresa.

Principais recursos

• Lista de conversas unificada: as conversas do número selecionado em um só lugar, com filtros, etiquetas e status.
• Painel do negócio ao lado da conversa: dados do negócio e do contato, responsáveis, tarefas, proposta e atividades, com os botões Mover, Ganho e Perda.
• Mensagens rápidas: digite "/" no campo de mensagem para escolher um texto pronto.
• Follow-up por IA: o botão Gerar follow-up por IA sugere a próxima mensagem de retomada. Esse recurso consome créditos.
• Encaminhar mensagens para outra conversa.
• Vários números: a quantidade de números depende do que a sua empresa contratou.
• Aplicativo instalável: o GronerZap pode ser instalado na tela inicial do celular, com notificações. Veja como no Android e no iOS.

O acesso ao GronerZap usa o mesmo login do Groner CRM: não há cadastro nem senha separados.

2. As duas formas de conectar um número

Ao adicionar um número, o GronerZap pergunta o Tipo de conexão:

• API Oficial: o número é conectado à WhatsApp Business Platform, a plataforma oficial da Meta (empresa dona do WhatsApp). A conexão é autorizada na sua conta da Meta, sem QR Code. É o caminho em conformidade com as regras da Meta, com risco de bloqueio mínimo quando você segue as políticas do WhatsApp.
• API Não-Oficial: o GronerZap vira um "dispositivo conectado" de um WhatsApp que já está no celular, como o WhatsApp Web. A conexão é feita lendo um QR Code. É rápida e sem verificação, mas depende do celular ligado e tem risco de bloqueio em automação pesada ou disparos em massa.

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 API Não-Oficial resolve.

Antes de começar

1. Permissão: a tela de números (Configurações > Números) aparece só para usuários com perfil de administrador.
2. Número disponível no seu plano: a quantidade de números que você pode cadastrar depende do que foi contratado. Se o limite já foi atingido, o GronerZap mostra "Você atingiu o número máximo de números cadastrados" e o botão Contratar novo número.
3. O número de WhatsApp que você vai conectar, com os requisitos de cada forma de conexão (veja as seções 3 e 5).

3. Como conectar pela API Oficial

3.1. O que preparar

1. Conta na Meta com acesso ao gerenciador de negócios (Meta Business). Você faz login com ela durante a conexão. Se a sua empresa ainda não tem uma conta comercial, é possível criá-la no próprio fluxo da Meta.
2. Saber como o número vai funcionar. O GronerZap oferece três modos (detalhados no passo 6 abaixo). No modo recomendado, Coexistência, o número continua funcionando no aplicativo WhatsApp Business do celular.
3. O celular do número à mão, para confirmar o que a Meta pedir durante o processo.
4. Pop-ups liberados no navegador, porque a conexão abre uma janela da Meta.

3.2. Passo a passo

1. No GronerZap, clique no menu ⋮ (dica "Configurações") no topo da lista de conversas e escolha Configurações.
2. Clique em Números.
3. Clique em Adicionar Número (ou em um item Número disponível, se a sua empresa já tiver linhas contratadas e livres).
4. Em Tipo de conexão, escolha API Oficial. Leia o aviso de cobrança: os custos da API Oficial são cobrados diretamente pela Meta, separados da sua assinatura.
5. Em Método de cadastro, deixe Conectar com Meta (recomendado).
6. Em Como este número vai funcionar?, escolha uma opção. A tela mostra as vantagens e desvantagens de cada uma, e trocar depois exige recadastrar o número na Meta:
7. • Coexistência (recomendado): o número continua funcionando no app WhatsApp Business do celular. Importa o histórico das conversas ao conectar, as mensagens enviadas pelo celular aparecem no CRM e os contatos do aparelho são sincronizados. Não permite ligações de voz pela API oficial.
   • Número dedicado à API: o número passa a ser exclusivo da API oficial e sai do app WhatsApp Business. É o único modo com ligações de voz pela API oficial, mas o CRM começa sem histórico e o WhatsApp Business deixa de funcionar no celular.
   • Número já na API oficial: para migrar um número que já está registrado na API oficial em outra plataforma. Só autoriza a sua conta comercial, sem cadastrar número novo.
7. Clique em Conectar WhatsApp. A janela da Meta se abre.
8. Na janela da Meta, faça login com a sua conta, autorize o acesso e selecione (ou crie) a sua conta comercial e o número do WhatsApp. Siga as etapas que a Meta apresentar até o fim.
9. De volta ao GronerZap, aparece a mensagem "Code recebido. Confirme abaixo para finalizar o cadastro.".
10. • Se a sua conta tiver mais de uma conta comercial, escolha qual conectar em Escolha a Business Account (WABA).
    • Se a conta escolhida tiver mais de um número, escolha em Escolha o número.
10. Se quiser, preencha o Apelido (o nome que aparece na lista de números; se ficar vazio, o GronerZap usa o identificador do número na Meta).
11. Clique em Salvar.

Pronto: o número aparece na lista de Números com a etiqueta Meta. O status pode mostrar Conectado ao Meta ou Conectado - Aguardando revisão. O aviso de revisão, sozinho, não confirma uma análise pendente na Meta: veja como conferir na seção de solução de problemas abaixo.

Em nenhum momento você escaneia QR Code. Ao abrir o número na lista, a tela WhatsApp Cloud API (Meta) confirma: "a conexão é gerenciada diretamente pelo Meta — não há QR Code nem código de pareamento".

3.3. Usar token existente (opção avançada)

Se a sua equipe técnica já tem um token de usuário de sistema da Meta, escolha Usar token existente em Método de cadastro e preencha Phone Number ID, WhatsApp Business Account ID (WABA) e Access Token. O token precisa ter os escopos indicados na própria tela. Na dúvida, use Conectar com Meta (recomendado).

4. O que muda depois de conectar pela API Oficial

Com a API Oficial passam a valer algumas regras da própria Meta. Entendê-las evita achar que é limitação do GronerZap.

Janela de 24 horas e templates

• Sempre que o cliente manda uma mensagem, abre-se uma janela de 24 horas. Dentro dela você responde com texto livre, normalmente. O campo de mensagem mostra quanto tempo resta ("Janela de 24h aberta — resta ... para enviar mensagens livres").
• Para iniciar uma conversa, ou depois que a janela fecha, só é possível enviar um template (modelo de mensagem) aprovado pela Meta. O campo mostra o aviso Janela de 24h encerrada e passa a servir para escolher o template. Com a janela aberta, digite "#" no campo para abrir a lista de templates.

Para criar e acompanhar templates, abra Configurações > Números, clique no número e use Gerenciar templates. Na tela Templates do WhatsApp (Meta) você cria um Novo template, filtra por Status (Aprovado, Pendente, Rejeitado, Pausado, Desativado) e Categoria (Utilidade, Marketing, Autenticação). Todos os detalhes estão no Guia completo de templates da Meta.

Custos

Os custos da API Oficial são definidos e cobrados diretamente pela Meta, separados da sua assinatura do Groner, de acordo com a forma de pagamento cadastrada na Meta. O valor varia conforme a categoria do template (marketing, utilidade ou autenticação). Consulte a tabela oficial de preços da WhatsApp Business Platform para o Brasil.

Limites e verificação do negócio

• A Meta limita quantos clientes novos o número pode abordar por dia, em faixas que sobem conforme o uso e a qualidade do número (poucos bloqueios e denúncias).
• A verificação do negócio na Meta (comprovar que a empresa é real, com documentos como o CNPJ) é o que permite subir para as faixas maiores e exibir o perfil de empresa verificada. Recomendamos iniciá-la logo após conectar.

Grupos

Pela API Oficial, o GronerZap trabalha com grupos criados pelo próprio número. Não é possível entrar em grupos de outras pessoas por link de convite nem sair de um grupo pela API Oficial. Se a sua operação depende de participar de grupos de terceiros, avalie a API Não-Oficial.

Desconectar

Na tela do número, Desconectar (mantém histórico) apenas pausa o recebimento pela Meta: conversas e mensagens são mantidas e o número pode ser reconectado depois por Reconectar via Meta.

5. Como conectar pela API Não-Oficial (QR Code)

Este é o jeito mais rápido de colocar um número para funcionar. O GronerZap se conecta ao WhatsApp ou WhatsApp Business que já está no celular, como um dispositivo conectado. Não há conta Meta, verificação de negócio nem cobrança da Meta. Em troca, o celular precisa continuar ligado e com internet.

5.1. Cadastrar o número

1. Abra Configurações > Números e clique em Adicionar Número.
2. Em Tipo de conexão, escolha API Não-Oficial.
3. Em Provedor, escolha o provedor da conexão. UAZAPI (recomendado) é o padrão. A opção Z-API acrescenta um valor por número na mensalidade, informado na própria tela.
4. Preencha o Nome do número (por exemplo, "Loja 2") e clique em Salvar.

5.2. Conectar pelo QR Code

1. Em Configurações > Números, clique no número que você acabou de cadastrar.
2. Clique em Gerar QR Code.
3. No celular, abra o WhatsApp, toque em Menu, Perfil ou Configurações, selecione Dispositivos conectados e depois Conectar dispositivo.
4. Aponte a câmera para o QR Code exibido no GronerZap.
5. Aguarde até a tela mostrar WhatsApp conectado e Online.

Se você desistir no meio, use Interromper conexão.

5.3. Conectar pelo código de pareamento (só UAZAPI)

Use quando não for possível escanear o QR Code (câmera com defeito, celular longe da tela, reflexo). Esta opção aparece apenas em números com o provedor UAZAPI.

1. Na tela do número, em Conectar com código de pareamento, informe o número do WhatsApp com DDI e DDD, só com dígitos (exemplo: 5541999999999).
2. Clique em Gerar código.
3. No celular, abra o WhatsApp, vá em Dispositivos conectados > Conectar dispositivo e, em vez de escanear o QR Code, selecione Conectar com número de telefone.
4. Digite o código mostrado no GronerZap. Ele tem validade curta: faça isso logo depois de gerar.

Para entender melhor a diferença, veja QR Code vs. pareamento por número.

5.4. Pontos de atenção da API Não-Oficial

• O celular do número precisa ficar ligado, carregado e com internet. Se ficar muito tempo offline, a conexão cai e é preciso reconectar (veja Como reconectar seu número no GronerZap).
• Não remova o GronerZap da lista de Dispositivos conectados do celular: isso encerra a conexão.
• Você envia texto livre a qualquer momento, sem templates.
• Por ser uma conexão não oficial, automação pesada e disparos em massa podem levar ao bloqueio do número pelo WhatsApp. Leia Bloqueios e banimentos no WhatsApp.

6. API Oficial x QR Code: qual escolher

Escolha a API Oficial quando: o WhatsApp é um canal central da empresa, você quer estabilidade sem depender de celular, quer operar em conformidade e aceita usar templates e pagar à Meta pelos envios.

Escolha a API Não-Oficial quando: você quer colocar o atendimento no ar em minutos, o uso é manual e sem disparos em massa, ou precisa participar de grupos de terceiros.

Uma forma simples de decidir: se você pretende escalar, vá de API Oficial. Se o uso é leve, comece pela API Não-Oficial e migre quando a operação amadurecer. Para decidir entre um número por vendedor ou um número da empresa, veja Número exclusivo ou compartilhado no GronerZap.

7. O GronerZap no dia a dia

7.1. A tela de conversas

• Lista de conversas (esquerda): as conversas do número selecionado, com a prévia da última mensagem e a contagem de mensagens não lidas. No topo ficam o nome e o telefone do número em uso, o botão Trocar número, a busca Pesquisar conversas e o botão Filtrar conversas. Veja Como usar os filtros no GronerZap.
• Conversa aberta (centro): o histórico e o campo de mensagem.
• Painel do negócio (direita): os dados do negócio ligado à conversa.

7.2. Responder uma conversa

1. Clique na conversa na lista da esquerda.
2. Leia o histórico no centro da tela.
3. Escreva no campo de mensagem e envie (Shift + Enter cria uma nova linha).
4. Em número da API Oficial, fique atento ao aviso da janela de 24 horas (seção 4).

7.3. Painel do negócio

Ao lado da conversa você encontra as seções Negócio, Contato, Qualificação, Responsáveis, Tarefas, Proposta e Atividades. Na seção Negócio:

• Mover: muda o negócio de etapa do funil.
• Ganho: abre o negócio no CRM para registrar o ganho.
• Perda: registra a perda do negócio, com o motivo.

Use o painel para conferir com quem você fala, retomar de onde parou, criar ou concluir tarefas e manter o funil atualizado sem sair da conversa.

7.4. Mensagens rápidas, follow-up e encaminhar

• Mensagens rápidas: digite "/" no campo de mensagem e escolha o texto. Ajuste o que precisar antes de enviar. Veja Como criar uma mensagem rápida.
• Follow-up por IA: clique em Gerar follow-up por IA para receber uma sugestão de retomada. Leia e ajuste antes de enviar. Cada sugestão consome créditos.
• Encaminhar: abra o menu da mensagem, escolha Encaminhar e selecione o destino.

7.5. Vários números

Cada número conectado tem a sua própria lista de conversas. Para atender outro número, clique em Trocar número no topo da lista e escolha um número conectado. Confira sempre qual número está em uso (nome e telefone no topo da lista) antes de responder.

8. Boas práticas e cuidados

8.1. Evite disparos em massa

• Na API Não-Oficial, o risco é o bloqueio do número. Muitas mensagens iguais, em sequência, para quem nunca falou com você, são o padrão que o WhatsApp pune.
• Na API Oficial, disparos de baixa relevância derrubam a qualidade do número, reduzem os limites de envio e custam caro, porque cada template é cobrado pela Meta.

Fale com quem demonstrou interesse, personalize a mensagem, respeite quem pede para parar e aumente o volume aos poucos.

8.2. Mantenha o número saudável

• API Não-Oficial: celular ligado e com internet; não remova o GronerZap dos dispositivos conectados.
• API Oficial: conclua a verificação do negócio na Meta e cuide da qualidade do número.

8.3. Escreva bons templates

• Diga logo no início quem é a sua empresa.
• Escolha a categoria correta (marketing, utilidade ou autenticação): categoria errada é motivo comum de reprovação e muda o custo.
• Evite excesso de links, texto todo em maiúsculas e promessas exageradas.
• Confira as variáveis (nome, valor, data) para o texto fazer sentido com qualquer dado.

8.4. Centralize as conversas no GronerZap

Conversar por fora (no celular pessoal ou em outro aparelho) quebra o histórico do negócio. Se o cliente chamar no número pessoal de alguém, traga a conversa de volta para o GronerZap o quanto antes.

9. Solução de problemas

Na conexão pela API Oficial

• A janela da Meta não abriu: libere pop-ups para o GronerZap no navegador e clique de novo em Conectar WhatsApp.
• "Você cancelou o Embedded Signup": a janela da Meta foi fechada antes do fim. Clique em Conectar WhatsApp e conclua todas as etapas.
• Não consigo escolher a conta comercial da empresa: o seu usuário da Meta não tem acesso a ela. Peça ao administrador da conta Meta Business para conceder acesso.
• "Sua conta tem mais de uma WABA autorizada" ou "A WABA selecionada tem mais de um número": escolha a conta e o número nos campos que aparecem e clique em Salvar.
• A Meta diz que o número é inválido: veja Por que a API da Meta informa que o número conectado é inválido.
• Conectei, mas não consigo iniciar conversa: é a regra da janela de 24 horas. Crie e aprove um template antes de abordar clientes.
• Os limites de envio estão baixos: conclua a verificação do negócio na Meta e evite denúncias e bloqueios.

O aviso de revisão da Meta não muda

Se aparecer Conectado - Aguardando revisão ou a mensagem de que a Meta conectou, mas ainda não revisou a conexão, não conclua apenas por esse aviso que existe uma solicitação em análise. Esse aviso também pode aparecer quando a qualidade do número ainda não foi informada. Qualidade do número, aprovação do nome de exibição e verificação da empresa são informações diferentes.

1. No GronerZap, abra Configurações > Números e clique no número com o aviso. Confira qual número está sendo consultado.
2. Peça ao administrador da conta comercial para consultar o mesmo número no Gerenciador do WhatsApp da Meta. Selecione a conta comercial que possui o número.
3. Confira separadamente o status do número, o nome de exibição e qualquer solicitação de documentos ou ação indicada pela Meta. Não confunda a qualidade do número com a aprovação do cadastro.
4. Se a Meta apresentar uma pendência, siga a orientação exibida na própria conta. Para uma análise que permanece pendente, consulte a Central de Suporte para Empresas da Meta; as opções de atendimento dependem da conta.
5. Se a Meta indicar que o número está conectado, mas o GronerZap continuar mostrando revisão, informe ao suporte o status que aparece na Meta. Diga também se o número consegue enviar e receber mensagens, sem compartilhar senhas, códigos de confirmação ou tokens.

Não exclua nem recadastre o número apenas para tentar remover o aviso. Primeiro identifique qual etapa realmente está pendente. O GronerZap não permite aprovar uma revisão da Meta nem definir o prazo de conclusão dela.

Na conexão por QR Code

• O QR Code ou o código expirou: gere um novo e tenha o celular já na tela Conectar dispositivo antes de ler.
• A conexão não conclui: confira a internet do celular e do computador, evite trocar de rede durante o processo e gere um novo código.
• A conexão caiu: veja Como reconectar seu número no GronerZap.

A mensagem aparece no celular, mas não no GronerZap

1. Clique em Atualizar conversas (ícone de atualizar ao lado da busca) ou atualize a página com Ctrl + F5.
2. Confira se você está no número certo (nome e telefone no topo da lista).
3. Se o problema afeta só um contato, confira se o telefone do cliente está correto.
4. O envio e o recebimento dependem do provedor da conexão. Uma instabilidade nele pode atrasar mensagens mesmo com o WhatsApp funcionando no celular. Nesses casos, a normalização depende do provedor; se persistir, fale com o suporte informando um exemplo de contato afetado.

Veja também

• O que é o GronerZap (Antigo/Novo)
• Como ativar o Gronerzap (Novo)
• Como ativar o GronerZap (Antigo)
• GronerZap | QR Code vs Pareamento por Número

Atualizado em: 28/10/2026