NicoChatNicoChatDocumentaçãoBuscar na documentação…
Entrar

VK Metrics

Conecte o VK Metrics ao NicoChat para enviar leads, vendas e pesquisas e consultar origem, compras e score dos contatos nos seus fluxos.

2026-10-30

O miniapp VK Metrics liga os fluxos do NicoChat à sua conta do VK Metrics nos dois sentidos:

  • Enviar ao VK o que acontece na conversa: lead, venda, respostas de pesquisa, eventos e entrada ou saída de grupos de WhatsApp.
  • Consultar no VK o que se sabe do contato e usar isso para decidir o próximo passo do fluxo: de onde ele veio, o que já comprou, o score dele e se o carrinho está aberto.

Como integrar o VK Metrics

Siga as etapas abaixo para instalar o VK Metrics, informar sua organização e autorizar a conexão com o NicoChat.

1. Abra a loja de NicoApps

Na workspace do NicoChat, abra Integrações → NicoApps (MiniApps). Depois, clique em Instalar NicoApp, no canto superior direito.

Acesse Integrações → NicoApps (MiniApps) e clique em Instalar NicoApp.

2. Selecione o VK Metrics

Digite VK Metrics na busca. No aplicativo encontrado, clique em Selecionar.

Pesquise por VK Metrics e clique em Selecionar.

3. Abra a integração de leads no VK Metrics

No VK Metrics, acesse Fontes de dados → Leads e clique em Integrar.

No VK Metrics, abra Fontes de dados → Leads e clique em Integrar, no canto superior direito.

4. Copie o Código da Organização

Localize a seção Integração via Webhook. No campo Endpoint, copie o valor que aparece depois de oid=: esse é o Código da Organização. Use o código da sua própria conta.

Na seção Integração via Webhook, o Código da Organização é o valor depois de oid= no endpoint. Use o código da sua própria conta na instalação do miniapp.

5. Preencha o código no NicoChat

Volte às configurações do VK Metrics no NicoChat e cole o código no campo Código da Organização VK (oid). Em seguida, clique em Faça login para conectar.

Preencha Código da Organização VK (oid) e clique em Faça login para conectar.
Você também pode colar a URL inteira
O campo aceita o código da organização, a URL completa do endpoint ou o script do pixel. O miniapp extrai o código automaticamente. Esse preenchimento é necessário para as ações de envio.

6. Inicie a autorização da conta

Na página Conectar o VK Metrics, clique em Autorizar no VK Metrics. Se solicitado, entre na sua conta do VK Metrics.

Na página Conectar o VK Metrics, clique em Autorizar no VK Metrics.

7. Selecione a organização

Na tela de autorização do VK Metrics, selecione a organização que deseja conectar e clique em Continuar.

Confira o nome do aplicativo
As capturas das próximas duas etapas exibem “Autorizar acesso ao Claude”. Confira o aplicativo identificado na tela antes de aprovar o acesso.
Na tela de autorização enviada, selecione a organização e clique em Continuar. O nome exibido nessa captura é Claude.

8. Revise e autorize o acesso

Confira as permissões apresentadas pelo VK Metrics e clique em Autorizar para concluir a conexão.

A tela seguinte apresenta as permissões e o botão Autorizar. O nome exibido nessa captura é Claude.
Validade da conexão
A autorização vale por 90 dias. Após esse prazo, conecte a conta novamente para continuar usando as ações de consulta.

9. Use as ações no seu fluxo

No construtor de fluxos, adicione as ações das pastas Enviar dados ao VK e Consultar o contato, detalhadas a seguir. Configure os campos da ação e use a saída de sucesso para definir o próximo passo do fluxo.

Quase todas as ações identificam o contato pelo e-mail ou pelo telefone. Esses campos já vêm preenchidos com os dados do contato. Se a ação depender do e-mail, colete essa informação antes de executá-la.

Pasta 1 — Enviar dados ao VK

Ação
O que faz
O que precisa
01 Enviar lead
Cria o lead no VK, no lançamento certo
E-mail e a URL da página de captura (ou o ID do lançamento)
02 Enviar venda
Registra uma venda ligada ao lead
ID e nome do produto, e o e-mail ou o telefone
03 Enviar resposta de pesquisa
Envia as respostas da pesquisa, que alimentam o lead scoring
E-mail e as respostas
04 Enviar evento
Registra um evento personalizado (ex.: agendou_call)
Nome do evento, e o e-mail ou o telefone
05 Entrada ou saída de grupo de WhatsApp
Registra que o contato entrou ou saiu de um grupo
"entrou" ou "saiu", e o telefone

Dicas de envio:

  • Lead: a URL da página de captura é o que coloca o lead no lançamento certo. Ela precisa combinar com as páginas de captura cadastradas no lançamento do VK, e o lead precisa entrar no período de captação. Sem https://, o app completa. Até 5 campos personalizados vão no corpo com o nome que você der, e um campo JSON aceita mais.
  • Venda: o status pode ser approved, waiting_payment ou canceled, e vazio vale approved. Use o ID real da venda em "ID da transação": reenviar o mesmo ID com outro status atualiza a venda. Em branco, cada execução vira uma venda nova. Valores aceitam 1.497,90 ou 1497.90.
  • Pesquisa: o nome de cada pergunta precisa ser igual, letra por letra, ao nome da pergunta no VK (ex.: faixa_etaria, cargo). Um nome diferente vira uma pergunta nova no VK, que o lead scoring não reconhece. São 10 pares de pergunta e resposta, e o campo "Mais respostas (JSON)" aceita quantas mais você quiser:
json
{"faixa_etaria":"{{faixa_etaria}}","urgencia":"{{urgencia}}"}
  • Evento: use sempre o mesmo nome para o mesmo evento. Os detalhes opcionais vão em JSON.
  • Grupo: informe o nome do grupo e da campanha, para o VK separar as métricas de cada grupo.

Pasta 2 — Consultar o contato

Ação
Pergunta que responde
Saídas principais
01 Origem do contato
De onde esse contato veio?
Canal, campanha, criativo, ID do anúncio, página, data do cadastro
02 Compras do contato
Ele já comprou? O quê?
Já comprou, comprou o produto X, último produto, total gasto, pagamento pendente ou recusado, reembolso, assinatura
03 Carrinho aberto?
O lançamento está vendendo agora?
Carrinho aberto, fase, datas de abertura e fechamento
04 Resposta do contato no cadastro ou pesquisa
O que ele respondeu em um campo?
A resposta e de onde ela veio
05 Próximo produto a oferecer
O que oferecer a quem comprou o produto X?
Produto sugerido e outras sugestões
06 O que o anúncio do contato dizia
Qual foi a promessa do anúncio que trouxe o contato?
Resumo, gancho e transcrição
07 O que a página de cadastro dizia
O que a página prometia?
Título, chamada, oferta, preço
08 Score do contato
Esse lead é quente?
Score, faixa (A, B, C ou D), chance de conversão, pontos positivos e negativos

O score é calculado pela própria ação. Ela lê o modelo de lead scoring do VK e soma os pesos das respostas da pesquisa do contato. Por isso, o contato precisa ter respondido a pesquisa. A faixa A é a de maior chance.

Exemplos de fluxo

  • Atendimento por faixa: rode a "08 Score do contato" e mande a faixa A para o comercial e as faixas C e D para a nutrição automática.
  • Não vender de novo para quem já comprou: rode a "02 Compras do contato" antes da oferta. Se ele já comprou, ofereça o produto da "05 Próximo produto a oferecer".
  • Conversa no tom do anúncio: rode a "01 Origem do contato" e passe o ID do anúncio para a "06 O que o anúncio do contato dizia". A IA do fluxo responde com o gancho que trouxe o contato.
  • Carrinho fechado: rode a "03 Carrinho aberto?" e, fora do período de vendas, leve o contato para a lista de espera.
  • Pesquisa pelo WhatsApp: faça as perguntas no fluxo e envie as respostas com a "03 Enviar resposta de pesquisa". O score do contato passa a contar essas respostas.
  • Grupo de lançamento: ao confirmar a entrada no grupo, rode a "05 Entrada ou saída de grupo de WhatsApp". O VK mostra as entradas por campanha.

Limites

  • A conexão vence em 90 dias. Depois disso, as ações de consulta falham até alguém conectar de novo.
  • O contato é achado pelo e-mail ou pelo telefone. Sem um dos dois, as consultas não têm por onde procurar.
  • As ações de envio dependem do Código da Organização. Elas usam o webhook do VK, não a conexão.
  • O VK pode levar alguns segundos para processar o que foi enviado. Uma consulta logo depois de um envio pode ainda não ver o dado novo.