Pular para conteúdo

Configuração pelo cliente

Duas coisas que só o cliente pode fazer, e sem as quais o que já está construído não mede nada: configurar o rastreamento e providenciar as credenciais do Instagram.

Esta página é a lista, em ordem, com o motivo de cada item. Onde uma etapa depende de uma decisão de negócio, ela está marcada como decisão — não como configuração.

Parte 1 — O que precisa estar configurado para o rastreamento funcionar

O módulo está em produção desde 13/09/2026. Ele não começa a medir sozinho: a cadeia abaixo precisa estar inteira, e ela quebra no elo mais fraco.

flowchart LR
  A[Peça cadastrada] --> B["Link /l/CODIGO"]
  B --> C[Link usado na bio, no anúncio, no story]
  C --> D[Clique contado]
  D --> E[Conversa amarrada ao clique]
  E --> F[Lead com origem]
  F --> G[Venda com origem]

O elo que costuma faltar é o terceiro

Cadastrar a peça e gerar o link não mede nada. Só o link usado produz clique. Um anúncio que aponta para o wa.me direto, ou uma bio com o link antigo, continua invisível — e aparece no dashboard como lacuna de rastreamento, não como erro.

A sequência

  • 1. Cadastrar a taxonomia — Tracking › Taxonomia
  • 2. Gerar os links — Tracking › Links rastreáveis
  • 3. Trocar os links em uso — bio, anúncios, stories, assinatura de e-mail
  • 4. Escolher o modelo de atribuição — Configurações › Tracking e atribuição
  • 5. Conferir os papéis das etapas do funil — Comercial › Etapas do Pipeline
  • 6. Cadastrar os motivos de perda
  • 7. Cadastrar o provedor de IA (opcional) — Configurações › Inteligência artificial
  • 8. Liberar as telas por perfil — Configurações › Perfis

1. Taxonomia

Três níveis, e a ordem importa porque cada um vive dentro do anterior:

Nível Exemplo Para que serve
Canal Instagram, YouTube, E-mail De onde a pessoa veio
Campanha Turma Setembro, Black Friday Qual esforço a trouxe
Peça Reels da bio, Anúncio 01 Qual conteúdo, exatamente

A peça é obrigatória para gerar link. Não existe link sem peça — é a peça que dá sentido à pergunta "qual conteúdo traz quem compra".

Na mesma tela ficam os tipos de evento (já vêm cadastrados; só mexer para acrescentar) e as origens de lead (a lista que aparece no cadastro manual).

Item desativado nunca é apagado

Desativar tira o item dos seletores e preserva o histórico — a campanha de março continua creditada nas vendas de março. Apagar não é oferecido de propósito.

Escolhe-se canal → campanha → peça e o destino:

Destino Quando usar
WhatsApp O clique cai na conversa, e a conversa nasce amarrada ao clique
URL Página de vendas, formulário, qualquer endereço

O sistema devolve um endereço curto — /l/CODIGO — curto de propósito: ele vai na bio, no anúncio, e às vezes é ditado por telefone.

Sem cookie, e sem casar horário

A amarração entre o clique e a conversa não usa cookie nem "quem clicou por último". É por isso que ela funciona mesmo quando a pessoa clica no celular e responde no computador.

O passo de operação, não de sistema. Toda entrada que hoje aponta direto para o WhatsApp ou para o site precisa passar a apontar para o link gerado. Enquanto isso não acontece, a cobertura no dashboard mostra o tamanho exato da lacuna.

4. Modelo de atribuição

É decisão de negócio, e muda quais peças parecem boas:

Modelo Responde Escolha quando
Último toque "O que fechou a venda" O foco é conversão e remarketing
Primeiro toque "O que traz gente nova" O foco é aquisição e topo de funil

Trocar o modelo muda o crédito na requisição seguinte, sem reprocessar dado e sem deploy — é leitura derivada dos eventos, não número gravado. Ver AD-021.

Na mesma tela fica o destaque de espera: a partir de quantos segundos uma conversa na fila ganha destaque.

5. Papéis das etapas do funil

Cada etapa do pipeline tem um papel, e dois deles têm consequência no rastreamento:

Papel O que dispara
ganho Registra a venda e credita a origem
perdido Exige o motivo antes de mover, e registra a perda com ele

Funil sem etapa de papel ganho não credita venda nenhuma

O dashboard mostraria clique, conversa e lead — e receita zero. Vale conferir antes de cobrar número do dashboard.

6. Motivos de perda

São o que a etapa de papel perdido exige. Sem lista cadastrada, a etapa trava quem tenta usá-la.

7. Provedor de IA (opcional)

Configurações › Inteligência artificial. Escolhe-se o provedor — Anthropic, OpenAI, Gemini ou Grok —, o modelo (a lista vem do próprio provedor) e a chave.

A chave é do cliente, criada na conta dele, e cobrada dele. O sistema a guarda cifrada e nunca a exibe depois de salva.

Sem IA o sistema opera igual

Não cadastrar provedor não quebra tela nenhuma: some a sugestão de resposta e a classificação automática, e a operação segue. Ver AD-022.

8. Permissões por perfil

As telas novas nascem invisíveis para todo mundo, menos o Administrador. Quem precisa de cada uma:

Tela Chave Quem costuma precisar
Visão geral, Funil, Origem tracking.dashboard Coordenação
Central de Atendimento tracking.central Quem atende
Links rastreáveis tracking.links Marketing
Taxonomia tracking.taxonomia Marketing
Tracking e atribuição tracking.configuracoes Coordenação
Auditoria auditoria.historico Coordenação
Inteligência artificial configuracoes.ia Administração

Parte 2 — O que o cliente precisa providenciar para o Instagram

Aqui a comparação com o WhatsApp engana

O WhatsApp do sistema não passa pela Meta: ele vai pela Evolution API em servidor próprio, com pareamento por QR code. Nunca houve app, permissão nem revisão. O Instagram não tem equivalente — DM de Instagram só sai pela API oficial da Meta.

O que precisa existir

Item Detalhe
Portfólio empresarial Meta Business — normalmente já existe, por causa dos anúncios
Conta do Instagram Profissional (Empresa ou Criador); conta pessoal não serve
App na Meta Tipo Business, criado dentro do portfólio do cliente
Caminho de login Instagram Login — não exige Página do Facebook
Permissões instagram_business_basic, instagram_business_manage_messages, instagram_business_manage_comments
Token Longa duração (~60 dias), renovado por código

A sequência

  • 1. Portfólio empresarial no Meta Business
  • 2. Conta do Instagram convertida em Profissional
  • 3. App criado no portfólio do cliente (podemos operar o teclado; a conta é dele)
  • 4. Nossos usuários adicionados como desenvolvedores do app
  • 5. app_id e app_secret entregues à equipe
  • 6. O cliente autoriza o app na conta — o passo que só ele faz
  • 7. Repetir o item 6 para cada conta que entrar na fila

Quem faz o quê

Etapa Cliente Equipe
Criar o app Dono da conta Pode operar junto
Autorizar (OAuth) Obrigatoriamente Não pode
Guardar as credenciais — .env, nunca no banco
Renovar o token — Rotina automática

O app precisa nascer no portfólio do cliente

Se nascer no nosso, duas coisas quebram: a operação fica refém da nossa conta no dia em que o token precisar ser reautorizado, e perde-se a condição que dispensa a revisão da Meta.

Revisão da Meta: provavelmente não será necessária

A documentação da Meta dispensa App Review quando "my app is only for a business I own or manage" — app da própria empresa, servindo as contas dela. A revisão completa (verificação de negócio, screencast, 2 a 4 semanas) só entra se o sistema um dia atender outras empresas.

Duas consequências operacionais

Janela de 24 horas. Passado um dia desde a última mensagem da pessoa, a resposta é bloqueada até ela escrever de novo. Existe uma extensão para 7 dias (Human Agent), destinada a resposta humana — nunca automática.

O token expira. Diferente do QR code do WhatsApp, que pareia e esquece, o token da Meta vence em cerca de 60 dias e precisa ser renovado pelo sistema. É rotina nova, e silenciosa quando falha.

O que ainda não existe do nosso lado

O atendimento por Instagram está desenhado e não construído — fila única com abas por canal, cinco origens, comentário que vira direct. Ver Tracking › Instagram. As credenciais são pré-requisito, não o trabalho todo.

Resumo para levar à reunião

Pergunta Resposta
O rastreamento funciona sozinho? Não. Depende de taxonomia, link gerado e link em uso.
Qual a decisão de negócio pendente? Modelo de atribuição: primeiro ou último toque.
Precisamos de app na Meta para o WhatsApp? Não. Nunca precisamos.
Precisamos de app na Meta para o Instagram? Sim, obrigatoriamente.
Precisa passar por revisão da Meta? Provavelmente não, se o app for do cliente.
Quem autoriza o Instagram? O dono da conta, pessoalmente.
De quem é a chave da IA? Do cliente, na conta dele, cobrada dele.