Explicação técnica · Kommo CRM

Como funciona o qrzaps

Como um clique no link do WhatsApp encontra o lead dele no CRM, quais campos são preenchidos e por que às vezes não escrevemos nada. Para quem já entendeu a ideia e quer os detalhes.

A página do qrzaps dentro do Kommo: leads atribuídos com origem e campanha

Para que serve

O qrzaps responde à pergunta que o WhatsApp não responde: de qual anúncio veio este cliente. A pessoa toca no seu link no Instagram, no site ou num QR impresso, o WhatsApp abre — e o rastro acaba ali. No CRM entra um lead sem origem, e a verba é dividida no escuro.

A integração fecha essa lacuna: o clique no link do qrzaps e a primeira conversa no Kommo ficam ligados, e na ficha do lead entram utm_source, utm_medium, utm_campaign e as demais etiquetas — os mesmos campos que os relatórios de origem do próprio Kommo já leem.

Para quem é: para quem paga por tráfego que termina no WhatsApp — anúncios da Meta e do Google, criadores, link na bio, QR na vitrine e na embalagem. Se tudo que entra chega como um único fluxo indistinguível de "WhatsApp", é para você.

Como funciona

O mecanismo se apoia num truque simples: à mensagem já escrita entra um protocolo curto, único para cada clique.

  1. O clique. Alguém abre o seu link qrzaps.com/w/XXXXXX. Guardamos o clique com tudo o que ele carrega: origem, campanha, dispositivo, país e de qual página veio.
  2. A inserção. O WhatsApp abre com o seu texto e mais uma linha: «Protocolo: 74-185231». Cada clique tem o seu.
  3. A mensagem. O cliente envia essa primeira mensagem como está — com o número junto.
  4. A ligação. O Kommo cria o lead, a integração lê a primeira mensagem, acha o número e pergunta ao qrzaps a qual clique ele pertence.
  5. A gravação. As etiquetas daquele clique vão para o lead. Num cabinet real, da mensagem aos campos preenchidos passam uns dez segundos.
Por que um número e não algo mais esperto. O clique em wa.me não revela o telefone do visitante, e o WhatsApp não passa ao CRM nem o referrer nem os parâmetros do link. A única coisa que sobrevive ao pulo para o mensageiro é o texto da mensagem. Por isso a chave mora no texto.

O número parece um protocolo de atendimento de verdade, e não um #a1b2c3 aleatório — é exatamente por isso que raramente é apagado. São oito dígitos: sete sorteados e um de verificação.

O que entra no lead

A integração escreve nos campos de UTM do próprio Kommo, não em cópias particulares: são eles que os relatórios nativos de origem leem, junto com qualquer outra integração já configurada no cabinet.

  • utm_source, utm_medium, utm_campaign, utm_content, utm_term — as etiquetas do link;
  • utm_referrer — a página de onde veio o clique;
  • «Tipo de atribuição» — o único campo nosso: por protocolo ou por janela de tempo.

Além disso: uma nota no histórico do lead assinada por qrzaps (origem, campanha, link) e a tag de serviço qrzaps-attributed para filtrar. As duas coisas se desligam nas configurações.

O que já está preenchido não é sobrescrito. Se um formulário do site ou outra integração já colocou a origem, não mexemos: quem escreveu primeiro sabia tanto quanto nós.

Precisão: três desfechos em vez de palpite

Atribuição ou é exata ou é prejudicial. Separamos três casos e mostramos qual valeu.

  • Por protocolo — o número apareceu na mensagem. É a maior parte e é acerto exato: um clique específico, uma campanha específica.
  • Por janela de tempo — o cliente apagou o texto, mas nos minutos antes do lead houve exatamente um clique. É a reserva e liga nas configurações.
  • Nada — não há número e a janela tem vários cliques. Os campos ficam vazios.
Por que vazio é melhor que "mais ou menos". Em cima de uma origem errada o gestor remaneja verba entre canais — e manda para o canal errado. Uma lacuna no relatório aparece e não mente; uma origem falsa não aparece e mente.

Um número da mensagem que não pertence a nenhum clique seu é simplesmente ignorado: a busca só acontece dentro da sua conta, então um número de pedido alheio ou um telefone não têm como coincidir por acaso.

Os links são criados no painel qrzaps.com/app: o número do WhatsApp, a mensagem pronta e um rótulo para você. As UTMs são montadas ali mesmo, com atalhos para Google Ads e Facebook, sem digitar parâmetro na mão.

Cada link tem QR code (vitrine, embalagem, cartão) e um interruptor: acabou a campanha, o número para de abrir a conversa e o link com toda a estatística continua guardado.

O idioma do protocolo

A linha com o número quem lê é o seu cliente, não você. Por isso o idioma dela é escolhido à parte do idioma da interface: «Protocolo», «Ticket no.», «N.º de solicitud» ou «Номер обращения».

O padrão é definido uma vez na aba Kommo do painel, e cada link pode ter o seu. Antes de criar o link você vê a linha exata que vai junto com a mensagem.

O que os relatórios mostram

Dentro do Kommo — a aba da integração: quantos leads foram atribuídos em 30 dias, quantos por protocolo, quantos estão na fila, e os últimos leads atribuídos com link direto para a ficha.

No painel do qrzaps — estatística por link: aberturas por dia, origens, dispositivos e países, todos os cliques linha a linha e exportação em CSV. Na lista de links, ao lado das aberturas, aparece quantas chegaram ao CRM — essa é a conversão do link em conversa.

O que ele não faz

Os limites ditos na cara, para ninguém esperar o impossível.

  • Não captura 100% das conversas. Tem gente que apaga o texto todo antes de enviar; algumas entradas (QR lido no desktop, certas versões do iOS) perdem o texto pronto. Esses leads ficam sem origem, e não com uma origem inventada.
  • Não acompanha a conversa. Ele lê a primeira mensagem para achar o número, e o interesse dele pelo diálogo acaba aí.
  • Não substitui analytics de ponta a ponta. Ele responde "de onde veio este lead", não "quanto a campanha rendeu" — a segunda conta já é feita no CRM, em cima das vendas.

Instalação

  1. 1Instale direto do painel do qrzaps, no botão «Conectar o Kommo». A conta se liga sozinha, sem copiar chave nenhuma.
  2. 2Ou instale pelo marketplace do Kommo e depois cole a chave de API do seu painel qrzaps nas configurações da integração.
  3. 3Pronto: a partir daí seus links passam a levar o protocolo e os leads novos chegam com a origem.

Outras integrações

Todas as integrações >

Campos Avançados

Agrupa campos, converte interruptores em controles práticos e adiciona unidades de medida.

Peresmenka

Gestão de turnos de agentes e distribuição automática de negócios. Carga equilibrada, estatísticas em tempo real.

Criação em massa de negócios

Cria negócios em massa para ligações a partir de contatos selecionados. Tarefas agendadas no horário comercial.

Diagnóstico do espaço

Auditoria automática da saúde do CRM: funis, negócios, tarefas, atividade — com recomendações de IA.

Fale conosco

Dúvidas sobre a integração?

Deixe uma solicitação: ajudamos com a instalação, a configuração e a escolher os widgets para o seu processo no Kommo CRM.

ou escreva
pelos mensageiros
+1