Pular para o conteúdo
Abrir o Leadz

WhatsApp por QR Code

Conecte um número de WhatsApp por QR Code ou código, com suporte a grupos e sem templates.

No Leadz:ConexõesIntegraçõesCanais Abrir esta tela
Nesta página

O WhatsApp por QR Code conecta um número ao Leadz do mesmo jeito que o WhatsApp Web: como um aparelho conectado. Você atende no Chat de conversas, usa funis e disparos em texto livre e fala em grupos, sem templates e sem janela de 24 horas. Na tela, o cartão deste canal se chama WhatsApp · não oficial.

#Antes de começar

  • Seja administrador do workspace (a conta da empresa dentro do Leadz).
  • Tenha em mãos o celular com o WhatsApp do número que vai conectar.
  • Confira se o seu plano ainda tem número disponível neste canal.

#Conectar o número

  1. Abra Conexões › Integrações, na aba Canais.
  2. No cartão WhatsApp · não oficial, clique em Conectar.
  3. Escolha como ligar o número: Escanear QR code ou Usar o número de telefone.
  4. Siga o caminho escolhido, descrito abaixo.
  5. Quando a tela mostrar WhatsApp conectado, a conta já aparece no cartão com o nome e a foto do perfil do WhatsApp.

#Pelo QR Code

  1. No celular, abra o WhatsApp e vá em Aparelhos conectados.
  2. Toque em Conectar um aparelho.
  3. Aponte a câmera para o QR Code na tela do Leadz.

O QR Code expira em cerca de 2 minutos. Se a imagem ficar inválida, clique em Novo QR.

#Pelo número de telefone

Use quando não dá para apontar a câmera, por exemplo quando o Leadz está aberto no mesmo celular.

  1. Em Número com DDI, digite o número completo, só com dígitos. Exemplo: 5511999999999.
  2. Clique em Obter código. O Leadz mostra um Código de vinculação de 8 dígitos.
  3. No celular, abra o WhatsApp e vá em Aparelhos conectados › Conectar um aparelho › Conectar com número de telefone.
  4. Digite o código.

Se o código vencer, clique em Gerar novo código.

#Gerenciar os números

No cartão, clique em Configurar contas. A janela Configurar WhatsApp · não oficial tem duas abas.

Números conectados. Lista os números, cada um com:

Botão O que faz
Reparar recebimento Refaz a ligação que traz as mensagens para o Leadz. Use quando o número envia mas não recebe. Não derruba a conexão.
Reconectar Abre de novo a escolha entre QR Code e código, para religar um número que caiu.
Chave Liga ou pausa o recebimento no Chat de conversas.
Remover Apaga a conta do workspace.

Para ligar outro número, clique em Adicionar número.

Nome e ícone. Controla o que o número mostra:

  • Mostrar nome do perfil e Mostrar ícone / foto: definem o que aparece na lista de números dentro do Leadz.
  • Foto de perfil no WhatsApp e Recado no WhatsApp: mudam a privacidade no próprio WhatsApp, para os seus contatos ou para ninguém.

#Grupos

Com o número conectado por QR Code, os grupos de que ele participa entram no Leadz.

  • No Chat de conversas, as mensagens de grupo aparecem como conversas de grupo. Ao abrir uma, o Chat avisa: «Grupo WhatsApp via API não oficial. Texto livre sem janela de 24h.»
  • No funil, o bloco do WhatsApp não oficial tem a ação Enviar mensagem em grupo, para avisos e lembretes programados.
  • Se o grupo só aceita mensagens de administradores, o número conectado precisa ser administrador do grupo para enviar.

#Cuidados para não perder o número

  • Não remova o Leadz da lista de Aparelhos conectados no celular. Isso derruba a conexão.
  • Evite volume alto para quem nunca falou com você. É o que mais leva o WhatsApp a travar ou bloquear um número.
  • Quando um envio for recusado, não insista. Repetir a tentativa prolonga a trava (veja o erro 463 abaixo).
  • Use um número que você pode arriscar. Para o número principal da empresa, prefira a API oficial.

#Reconexão

O Leadz confere sozinho se os números continuam conectados. Quando um cai, o cartão mostra o selo «sem conexão» e a conta aparece com o selo Erro e o motivo.

  1. No cartão, clique em Configurar contas.
  2. Na linha do número, clique em Reconectar.
  3. Escolha QR Code ou código e repita a conexão no celular.

Reconectar mantém a mesma conta, com as conversas, os funis e os agentes de IA já ligados a ela. Não é preciso remover antes.

#Números que vêm do Sparkle Tracker

Se o workspace está ligado ao Sparkle Tracker e já existe um número conectado lá, o Leadz oferece reaproveitar a conexão. Aparece um aviso no topo da tela, com um botão Conectar e o número. Não é preciso escanear QR Code.

Um número reaproveitado do Tracker usa a mesma conexão nos dois sistemas. Por isso, nele o botão Reconectar oferece só Religar pelo Sparkle Tracker: gerar um QR Code novo derrubaria o número também no Tracker. Se o número cair nos dois, reconecte primeiro no Tracker e volte ao Leadz.

#Limites

  • A quantidade de números depende do seu plano. Veja https://sparkleleadz.com/planos.
  • O mesmo número pode ser conectado em mais de um workspace. Cada workspace recebe as próprias conversas.
  • Não há templates nem medição de qualidade pela Meta. Os limites de envio são os que o próprio WhatsApp aplica ao número.

#Problemas comuns

O celular não aceita o QR Code

O código venceu. Ele dura cerca de 2 minutos. Clique em Novo QR e escaneie de novo.

«Informe o número com DDI (ex.: 5511999999999).»

No caminho por telefone, o número precisa ter o código do país e o DDD, só com dígitos. Para o Brasil, comece com 55.

«Não foi possível obter o código. Confira o número (DDI+DDD) e tente de novo em alguns segundos.»

O número está incompleto ou o pedido foi feito rápido demais depois de outro. Confira os dígitos, espere alguns segundos e clique em Obter código de novo. Se continuar, use o QR Code.

O número envia, mas as respostas não chegam no Chat

Abra Configurar contas e clique em Reparar recebimento. Depois do aviso «Recebimento reconfigurado.», mande uma mensagem de teste para o número e confira o Chat de conversas. Não use Reconectar para este caso.

«A instância da Sparkle API está desconectada. Reconecte o número em Integrações antes de enviar.»

A conexão caiu no celular. Siga os passos da seção «Reconexão», acima.

«A instância está desconectada no WhatsApp. Clique em «Reconectar» antes de ativar.»

Você tentou ligar a chave de um número que não está conectado. Reconecte primeiro e ligue a chave depois.

«Esta conexão não existe mais na Sparkle API. Remova esta conta e conecte o número de novo.»

A conexão foi encerrada e não pode ser retomada. Clique em Remover e conecte o número outra vez com Adicionar número.

«O WhatsApp bloqueou temporariamente este número para iniciar conversas novas (erro 463)»

É uma trava do próprio WhatsApp, por volume ou qualidade de envio. Ela vale para contatos que nunca escreveram para o número; conversas em andamento continuam. Quando o WhatsApp informa o prazo, a mensagem mostra até quando a trava vai. Espere sem insistir, ou fale com esses contatos por outro número.

«O WhatsApp bloqueou este número não oficial. Envio suspenso até a conta ser liberada.»

O WhatsApp suspendeu o número. O Leadz não consegue liberar: siga as orientações do WhatsApp no próprio celular.

«Este número não existe no WhatsApp segundo a Sparkle API. Confira o telefone do contato.»

O telefone do contato não tem WhatsApp ou foi digitado errado. Corrija o número na ficha do contato.

«Este grupo só permite envio por administradores. O número conectado não é admin.»

O grupo está configurado para só administradores enviarem. Torne o número conectado administrador do grupo, pelo WhatsApp.

«Limite de 2 número(s) WhatsApp não oficial atingido neste plano.»

Você já conectou todos os números que o plano permite (o número na mensagem é o do seu plano). Remova um número que não usa ou aumente o plano.

#Veja também

Este artigo ajudou?

Mais em Canais

Ver os 10 artigos