[{"content":"1.1 Em uma frase É o medidor de WhatsApp: ele liga cada clique de anúncio (Meta, Google ou bio do Instagram) à conversa que nasce no WhatsApp e ao resultado dela (ganhou/perdeu + valor). No fim, você vê quanto cada campanha e cada criativo trouxe de leads, vendas e retorno.\n1.2 Por que o Pixel e o Google Analytics não bastam Pixel e GA enxergam até o clique. A sua venda termina no chat — e isso é caixa-preta pra eles. O martec costura os dois lados com um código invisível que viaja do link até o WhatsApp, e é isso que permite dizer \u0026ldquo;este criativo gerou 18 leads, 5 vendas, R$ 2.450\u0026rdquo; — algo que o Gerenciador de Anúncios sozinho não sabe.\n1.3 O que ele responde do seu método Direto no placar: qual campanha, criativo, público e fonte trouxe mais vendas e com menor custo — via Leads, Ganhos, Conversão, Receita, Custo, CPL e ROAS. O que ele não responde sozinho (continua na sua análise): ciclo de venda, região e desejos do cliente — coisas que dependem de você registrar ou observar.\n🖥️ Tela — O placar por criativo (o coração da medição)\nPlacar por criativo / ICP ┌─────────────────────────────────────────────────────────────────────┐ │ Criativo│ICP/Público│Leads│Ganhos↓│Conversão│Receita│Custo│CPL │ROAS │ │ video-A │ lookalike │ 18 │ 5 │ 27,8% │R$2.450│R$600│R$33│4,08×│ │ Sem atr.│ Sem atrib.│ 3 │ 1 │ amostra │sem val│ — │ — │ — │ └─────────────────────────────────────────────────────────────────────┘ Como ler: cada linha é um criativo cruzado com um público. CPL = custo ÷ leads (quanto custou cada lead). ROAS = receita ÷ custo (retorno). Onde falta dado, aparece \u0026ldquo;—\u0026rdquo; (nunca \u0026ldquo;R$ 0\u0026rdquo;). \u0026ldquo;Sem atribuição\u0026rdquo; significa que a medição não chegou ali — ver §5.6 e §11 itens 1–4.\n","permalink":"https://faq.martec.app/pt/faq/conceitos/","summary":"O que o martec.app faz e como ele se liga ao seu método.","title":"1. O que é o martec.app e como ele se liga ao seu método"},{"content":"2.1 Como recebo acesso Você recebe um convite por e-mail (enviado pelo admin, pela agência ou pelo time). Não há auto-cadastro — é proposital, por segurança. O convite expira em 72 horas.\n🖥️ Tela — Definir senha e entrar (pelo convite)\n+--------------------------------------------+ | [ MARTEC LOGO ] | | Definir senha e continuar | | Nova senha [ ........ ] | | Confirmar [ ........ ] | | ○ Mínimo 8 caracteres | | ○ As senhas conferem | | [ Definir senha e continuar ] | +--------------------------------------------+ ✅ Clique no link do e-mail → defina a senha → entre. Se o link disser que expirou, peça um novo convite a quem te convidou.\n2.2 Esqueci minha senha 🖥️ Tela — Esqueci minha senha\nESTADO inicial: DEPOIS de enviar: +---------------------------+ +---------------------------+ | Esqueci minha senha | | Verifique seu e-mail | | E-mail [ ............ ] | | Se cadastrado, você | | [ Enviar instruções ] | | receberá instruções... | | Voltar ao login | | [ Voltar ao login ] | +---------------------------+ +---------------------------+ ✅ Login → \u0026ldquo;Esqueci minha senha\u0026rdquo; → informe o e-mail. A confirmação aparece sempre igual (mesmo que o e-mail não exista) — é proteção de privacidade. Se você é cadastrado, chega um link que expira em 1 hora e vale uma vez só. Ao redefinir, todas as suas sessões caem e você entra de novo.\n2.3 Minha senha é temporária (1º acesso de operador) Quando o admin cria ou redefine sua conta, ela vem com senha temporária e o sistema força a troca no primeiro acesso.\n🖥️ Tela — Trocar senha\n+--------------------------------------------+ | Trocar senha | | Sua senha atual é temporária... | | Senha atual [ ........ ] | | Nova senha [ ........ ] | | Confirmar nova senha[ ........ ] | | ✓ Mínimo 8 caracteres | | ✗ Diferente da senha atual | | [ Trocar senha ] | +--------------------------------------------+ ✅ Digite a senha temporária + a nova (mín. 8 caracteres, diferente da atual). Esqueceu a temporária? Peça ao admin pra redefinir seu acesso em Operadores.\n2.4 Meu perfil 🖥️ Tela — Meu perfil (só consulta)\nMeu perfil ┌ Empresa atual ─────────────┐ ┌ Sua conta ─────────────┐ │ Nome ..... Loja Exemplo │ │ Nome .. Maria Silva │ │ Slug ..... loja-exemplo │ │ E-mail maria@exemplo │ │ Timezone . America/Sao_Paulo│ │ │ │ Seu papel Admin │ │ │ └────────────────────────────┘ └────────────────────────┘ 💡 Esta tela é só de consulta — nome/e-mail/papel são alterados pelo admin; senha, pela tela de senha.\n","permalink":"https://faq.martec.app/pt/faq/acesso/","summary":"Entrar, recuperar senha e gerenciar seu perfil.","title":"2. Acesso \u0026 conta"},{"content":"3.1 Meu painel 🖥️ Tela — Painel do operador (celular)\nOlá, João ┌ Disponíveis na fila ───────┐ │ 8 +2 vencidos 📥 │ │ [ Próximo lead ] │ │ 3 em atendimento com você │ └────────────────────────────┘ 🕐 Hoje: 5 tratados · 2 ganhos [ Atribuídos 12 ][ Ganhos 4 ][ Conv 33% ] ┌ Meu ranking (privado) ─────┐ │ 2º de 5 · sua conv 40% │ └────────────────────────────┘ ⚠ 2 leads parados há mais de 5 dias Foco em ação: a fila, o que está com você, o resultado de hoje, seu ranking (só você vê) e alerta de leads parados há mais de 5 dias.\n3.2 Pegar o próximo lead ✅ Clique em \u0026ldquo;Próximo lead\u0026rdquo;. O sistema te atribui o próximo da fila — a partir daí ele é seu. O botão só aparece se seu usuário tem perfil de operador ativo.\n3.3 Atender um lead 🖥️ Tela — Detalhe do lead\n← Voltar pra leads Maria Souza [ Botão primário ] [ ⋯ ações ] +55 (11) 9xxxx-xxxx · maria@exemplo.com [ ●Novo ] · Atribuído: Op. Ana · Criado 2h · Origem: Meta Ads Identidades [ Telefone | E-mail | fbclid | Meta lead ID | WA ID ] Histórico ◉ Lead criado ◉ Atribuído ◉ Estágio alterado Touches recentes Canal | Status | Tracking link | Campanha | Quando O botão grande muda conforme o estágio e a posse (Pegar / Iniciar atendimento / Marcar resultado…). No menu ⋯ ficam as ações secundárias (editar, agendar retorno, transferir, devolver à fila, mesclar).\n3.4 ⚠️ \u0026ldquo;A tela do lead está só leitura, sem botão\u0026rdquo; Quase sempre significa que o lead é de outro operador. Se deveria ser seu, peça ao admin pra transferir ou devolver à fila — aí você pega pelo \u0026ldquo;Próximo lead\u0026rdquo;. É o controle que evita dois operadores no mesmo atendimento.\n","permalink":"https://faq.martec.app/pt/faq/operador/","summary":"O dia a dia de quem atende: painel, pegar e atender leads.","title":"3. Operador — o dia a dia de quem atende"},{"content":"4.1 Ler o dashboard 🖥️ Tela — Painel do admin\nOlá, Maria [ ⃝? Como funciona ] Painel operacional [ Hoje | Ontem | 7d | 30 | 90 ] ┌ Funil: Cliques → Leads → % conversa → Ganhos ┐ ┌ Ranking operadores ┐ ┌ Saúde do time ──┐ │ 1º Ana · conv 42% │ │ Parados: 3 · ...│ └────────────────────┘ └─────────────────┘ ┌ Métricas por campanha (lifetime) ───────────┐ │ Camp | Leads | CPL | Receita | ROAS [custo▼] │ │ Promo Verão | 12 | R$166,67 | R$3.200 | 1,50 │ └──────────────────────────────────────────────┘ O filtro de período afeta o funil, o ranking e a saúde do time. As Métricas por campanha são lifetime (acumulado de vida) — não mudam com o filtro. O botão \u0026ldquo;Como funciona\u0026rdquo; explica cada bloco com as fórmulas.\n4.2 ⚠️ \u0026ldquo;Por que duas taxas de conversão diferentes?\u0026rdquo; São duas medidas distintas: a taxa de ganho do funil (ganhos ÷ leads, toda a operação) e a Conv. do ranking (por operador, só sobre os leads que ele atendeu). Bases diferentes → números diferentes. Não é erro.\n4.3 Lista de leads 🖥️ Tela — Lista de leads (com filtros)\nLeads [ Próximo Lead ] [ ▦ Board ] [ + Criar lead ] [ 🔍 Buscar ] [ Estágio: Todos ▾ ] [ Atribuição: ▾ ] ┌──────────────────────────────────────────────────────────────┐ │ Nome │ Contato │ Estágio │ Resultado │ Atribuído │ │ Maria S│ +55(11)9xxxx-xxxx │ ●Novo │ — │ [Sem dono] │ │ João P │ +55(21)9xxxx-xxxx │ ⏱Em at. │ — │ Op. Ana │ │ Carlos │ +55(31)9xxxx-xxxx │ ✔Encerr.│ 🏆Ganho │ Op. Bruno │ └──────────────────────────────────────────────────────────────┘ « Anterior 1–30 de N Próxima » Filtros: Estágio, Resultado (só quando filtra Encerrados: Ganhos/Perdidos/Descartados), Atribuição (Meus + sem dono / Todos / Atribuídos a mim / Sem atribuição). A busca espera 300ms e a coluna \u0026ldquo;Criado\u0026rdquo; ordena.\n4.4 Board (kanban) — só admin 🖥️ Tela — Board\nBoard de leads [ Ver lista ] ⚠ Mostrando 200 de 1.250 leads (os mais recentes). Use a lista… ┌ Novos (3) ┐ ┌ Em atend.(2) ┐ ┌ Agendados(1)┐ ┌ Encerrados(4) ┐ │ Maria S │ │ João P │ │ Ana L │ │ Carlos 🏆R$1.2k│ │ Camp:Verão│ │ Camp:Black │ │ Camp:Orgân. │ │ (terminal) │ └───────────┘ └──────────────┘ └─────────────┘ └───────────────┘ Uma coluna por estágio, um card por pessoa. Arrastar move o estágio (pra Agendados abre \u0026ldquo;Agendar retorno\u0026rdquo;; pra Encerrados abre \u0026ldquo;Marcar resultado\u0026rdquo;). Cards Encerrados não voltam arrastando.\n4.5 ⚠️ \u0026ldquo;O board mostra 200 de N\u0026rdquo; O board carrega os ~200 mais recentes pra não pesar. Pra achar um lead fora disso, use a lista (tem busca e filtros).\n4.6 Operadores 🖥️ Tela — Operadores\nOperadores [ + Convidar operador ] [ Status: Todos ▾ ] 3 de 5 operadores ┌──────────────────────────────────────────────────────────┐ │ Nome | E-mail | Status | Ações │ │ Ana Souza | ana@ex.com | Disponível | ⋯ editar / blo- │ │ João Lima | joao@ex.com | Ausente | quear / redef. │ │ Beto | beto@ex.com | Convite… | senha / excluir│ └──────────────────────────────────────────────────────────┘ ✅ Convidar (manda o e-mail), Editar, Bloquear/Desbloquear, Redefinir senha (gera temporária), Excluir. 💡 O filtro de status esconde bloqueados e convites pendentes por padrão — troque pra \u0026ldquo;Todos\u0026rdquo; se faltar alguém.\n⚠️ Antes de bloquear um operador, reatribua ou desative os links dele. Bloquear não desliga os tracking links — eles continuam mandando lead pro WhatsApp de quem você desligou. Ver §11 item 5.\n4.7 ⚠️ Excluir × Eliminar dados do titular (LGPD) No menu ⋯ do detalhe do lead há duas ações vermelhas diferentes — não confunda:\nExcluir — só tira da lista. Os dados pessoais continuam no banco. Serve pra limpar a fila, não pra atender pedido de exclusão. Eliminar dados do titular — apaga de verdade (anonimiza nome, telefone e e-mail, de forma irreversível), preserva os valores de venda anônimos e registra a ação. É esta que atende o direito de exclusão da LGPD (§9.3). ","permalink":"https://faq.martec.app/pt/faq/admin-operacao/","summary":"Dashboard, lista de leads, board (kanban) e operadores.","title":"4. Admin — operação"},{"content":"A sequência: criar campanha → gerar link rastreável → usar o link como destino do anúncio (e marcar o criativo) → ler o placar.\n5.1 Criar campanha 🖥️ Tela — Campanhas + modal \u0026ldquo;Nova campanha\u0026rdquo;\nCampanhas [ + Nova campanha ] ✓ Meta Business conectado · 2 contas · expira em 47 dias ┌──────────────────────────────────────────────────────────────────┐ │ Nome │ Canal │ Status │ Tracking links │ Criada │ │ Coleção inverno… │ Meta ads │ ●Ativa │ 3 │ há 2 d │ │ Promo frete │ Google ads│ ⏸Pausada │ 1 │ há 5 d │ └──────────────────────────────────────────────────────────────────┘ ┌ Nova campanha ─────────────────┐ │ Nome [ .................. ] │ │ Canal ( Meta ▾ ) │ ← Meta / Google / Orgânico / Manual │ Status ( ● Ativa ) │ │ [ Cancelar ][ Criar ]│ └─────────────────────────────────┘ ✅ Campanhas → + Nova campanha: nome, canal, status. A campanha é o guarda-chuva dos links rastreáveis.\n⚠️ Marcar o canal \u0026ldquo;Meta\u0026rdquo; não basta pro custo entrar. O modal de criação não tem o campo do ID — depois de criar, abra Editar campanha e cole o ID da campanha do Meta (do Gerenciador) no campo \u0026ldquo;ID da campanha no canal\u0026rdquo;. Sem ele o custo nunca sincroniza (CPL/ROAS ficam \u0026ldquo;—\u0026rdquo;) e não há vínculo automático por nome. Ver §11 item 1.\n5.2 Tracking links (o link rastreável) 🖥️ Tela — Detalhe da campanha\n← Campanhas Coleção inverno 2026 [ Editar ] Meta ads · ●Ativa · Criada há 2 dias Tracking links (3) [ + Novo link ] ┌──────────────────────────────────────────────────────────────┐ │ Slug │ Operador │ Cliques │ Criado │ ⋯ │ │ martec.app/r/acme/inverno │ João S. │ 42 │ há 2d │[⋯] │ │ martec.app/r/acme/inv-az │ sem oper.│ 0 │ há 1d │[⋯] │ └──────────────────────────────────────────────────────────────┘ [⋯]: Copiar pro anúncio · Validar oferta · Editar mensagem · Desativar ✅ + Novo link gera martec.app/r/\u0026lt;empresa\u0026gt;/\u0026lt;slug\u0026gt;. Cada link aponta pra um operador (é o WhatsApp dele que recebe) e pode ter mensagem pré-escrita. Use Copiar pro anúncio — esse link é o destino (URL) do seu anúncio.\nTrês regras que evitam dor de cabeça:\nSem operador, o clique cai em \u0026ldquo;indisponível\u0026rdquo; — sempre associe um (§11 item 7). Não pause nem exclua um link com anúncio no ar — pause o anúncio primeiro (§11 item 6). Na mensagem pré-escrita, só 6 variáveis funcionam: {utm_source} {utm_campaign} {utm_content} {utm_term} {campaign_name} {tracking_link_slug}. Qualquer outra (ex.: {nome}) vai literal pro cliente (§11 item 8). 5.3 Validar oferta (sem disparar lead real) 🖥️ Tela — Validação de oferta (guia, read-only)\n← Voltar pra campanha Validação de oferta Destino do anúncio: [ Direto pro WhatsApp ] [ Landing page ] 3 passos pra medir: ① Use o link como destino [ martec.app/r/acme/inverno-vd ] [Copiar] ② Marque o criativo ▸ utm_content={{ad.name}}\u0026amp;utm_term=… ③ Confira antes de publicar Prévia da mensagem (montada de verdade, sem registrar nada) 💡 Use antes de publicar — ela monta a prévia real da mensagem sem registrar um lead de teste.\n5.4 Marcar o criativo (parâmetros de URL do Meta) ✅ No campo \u0026ldquo;Parâmetros de URL\u0026rdquo; do anúncio, cole exatamente:\nutm_content={{ad.name}}\u0026amp;utm_term={{adset.name}}\u0026amp;utm_id={{ad.id}} O Meta troca os macros sozinho: {{ad.name}} → coluna Criativo, {{adset.name}} → Público/ICP, {{ad.id}} → liga o clique ao custo. 💡 Nomeie criativos e públicos de forma legível — esses nomes aparecem cru no placar.\n⚠️ Se você usa uma landing page no meio do caminho, ela precisa repassar os parâmetros utm_* para o botão /r/. Se não repassar, o criativo chega em branco (\u0026ldquo;Sem atribuição\u0026rdquo;). Ver §11 item 4.\n5.5 Ler o placar Já mostrado em §1.3. Reforçando as fórmulas: CPL = custo ÷ leads, ROAS = receita ÷ custo. Amostra pequena ganha um selo e afunda na ordenação; ganho sem valor conta como ganho mas não soma receita.\n5.6 ⚠️ \u0026ldquo;Caiu em Orgânico\u0026rdquo; × \u0026ldquo;Sem atribuição\u0026rdquo; Orgânico = lead sem nenhum clique rastreado (entrou sem passar por link /r/). Sem atribuição = veio por link rastreável mas o anúncio estava sem os parâmetros de URL (§5.4). Evite os dois: link /r/ como destino e parâmetros de URL colados, sempre.\n","permalink":"https://faq.martec.app/pt/faq/campanhas/","summary":"Criar campanhas, tracking links, validar oferta e ler o placar.","title":"5. Admin — captação \u0026 campanhas"},{"content":"6.1 Bio (link-in-bio) 🖥️ Tela — Editor da bio (admin)\nBio [ ⃝? Como funciona ] [ Ver bio pública ↗ ] ┌ Detalhes: nome / tagline / publicada / tema / cores / foto ┐ ┌ 🔗 Botões da bio (arrastar pra ordenar, ligar cada um) ────┐ 🖥️ Tela — Bio pública (o que o cliente vê)\n┌──────────────────────────┐ │ ( ◯ avatar ) │ │ Loja Exemplo │ │ Atendimento via WhatsApp │ │ ┌──────────────────────┐ │ │ │ Falar no WhatsApp │ │ ← liga num link /r/ rastreável │ │ Ver promoções │ │ │ └──────────────────────┘ │ │ feito com martec.app → │ └──────────────────────────┘ ✅ Monte os botões e ligue cada um a um destino. Cada botão pode ser um link rastreável, então o tráfego do Instagram também entra no funil.\n⚠️ Não publique a bio sem botões — ela fica com cara de abandonada (só cabeçalho e rodapé). Adicione ao menos um botão antes (§11 item 17).\n6.2 Por que o link /r/ mostra uma tela de contagem 🖥️ Tela — Redirect rastreado\n┌──────────────────────────┐ │ [ MartecLogo ] │ │ Conectando você ao │ │ atendente │ │ Redirecionado em 3 seg. │ │ via WhatsApp · (11)9999… │ │ [ Ir agora ]→ wa.me │ └──────────────────────────┘ Não é um redirect instantâneo — é nesse passo que o martec registra o clique, filtra robôs, aplica limite de cliques e gera o código que costura clique↔conversa. É de propósito: é o coração da medição.\n6.3 ⚠️ \u0026ldquo;Cliquei e não contou no funil\u0026rdquo; Dois motivos legítimos: bot/preview (a pré-visualização de link no WhatsApp/Slack abre a página e é redirecionada, mas não conta) e limite de cliques (o mesmo IP clicando muito — 10 em 60 segundos — é segurado). Cliente real conta. Se está testando, seu F5 repetido pode bater no limite (§11 item 18).\n6.4 A planilha-isca A página /recursos/planilha é uma isca de marketing estática: oferece um .xlsx grátis sem pedir e-mail; a atribuição vai por UTM dentro do próprio arquivo. Boa pra SEO.\n","permalink":"https://faq.martec.app/pt/faq/paginas-publicas/","summary":"Bio (link-in-bio), a tela /r/ de contagem e a planilha-isca.","title":"6. Páginas que o seu cliente vê"},{"content":"7.1 Conectar o Meta Business 🖥️ Tela — Banner do Meta (4 estados) em Campanhas\nA) ✗ Meta desconectado [ Conectar Meta Business ] (só leitura: ads_read) B) ✓ Meta conectado · 2 contas · expira em 47 dias [ Reconectar ] [ Desconectar ] C) ⚠ Sincronização falhou [ Reconectar ] D) ⏰ Token expira em \u0026lt;7 dias [ Reconectar ] ✅ Campanhas → \u0026ldquo;Conectar Meta Business\u0026rdquo; → autorizar no Facebook → conceder ads_read + business_management (são só leitura — o martec não cria nem pausa anúncios). O token dura ~60 dias.\n⚠️ Conectou mas não veio nenhuma conta de anúncio? Você entrou no Facebook com um usuário sem acesso à conta de anúncios. Reconecte com o usuário que enxerga a conta no Gerenciador (§11 item 12).\n7.2 CAPI — devolver os eventos ao Meta ✅ A Conversions API devolve ao Meta os eventos que acontecem fora do site: Lead e Purchase (venda). Só o identificador de clique do Meta (fbc) é enviado — zero dado pessoal. Você liga e gerencia o CAPI na área de conexão do WhatsApp (Oficial/Cloud) → \u0026ldquo;Gerenciar conexão / Envio CAPI\u0026rdquo;. Ele fica ativo quando a credencial está habilitada + verificada (por um evento de teste) + não-revogada. Desconectar o Meta desliga o CAPI.\n⚠️ CAPI parou de enviar sem alarme se a credencial for desabilitada, perder a verificação ou for revogada — ou se você desconectar o Meta. Confira \u0026ldquo;Envio CAPI: Ativo\u0026rdquo; depois de mexer no Meta (§11 item 10).\n7.3 ROAS — o que fecha automático e o que depende de quê Precisa de dois lados: custo (vem do Meta, de madrugada — ~05–06h — e é gasto lifetime) e receita (cada venda registrada). Então ROAS = receita ÷ custo. Sem Meta conectado, CPL/ROAS ficam \u0026ldquo;—\u0026rdquo;; se o token expira, o custo congela; Google ainda não traz custo automático (§7.6).\n7.4 Conectar o WhatsApp 🖥️ Tela — Conectar WhatsApp\nConectar WhatsApp ── Conectado (Oficial/Cloud) ── ◉ WhatsApp conectado [ Oficial Meta ] Número +55 11 9 9999-0000 Consentimento Aceito · v2 / Pendente / Reconsentir Envio CAPI Ativo / Inativo [ Gerenciar conexão ] ── Conectado (WhatsApp Web / Evolution) ── ✓ Conectado [ Trocar ] [ Desconectar ] + banner azul \u0026#34;Oficial Meta disponível [ Migrar ]\u0026#34; ── Nada conectado ── [ Conectar via WhatsApp Oficial ] Prefere WhatsApp Web (não-oficial)? → expande Evolution (QR Code) Dois caminhos: Oficial (Cloud/Meta) — login do Facebook, libera templates e o envio CAPI, recomendado pra quem roda pago; e WhatsApp Web (Evolution) — QR Code, mais simples, não-oficial. Pode começar na Evolution e migrar depois.\n⚠️ Migrou e ficou com duas conexões? A Evolution não desliga sozinha. Depois de confirmar a Oficial, desconecte a Evolution manualmente (§11 item 15).\n7.5 Consentimento do WhatsApp (LGPD) Antes de conectar você aceita um termo versionado. O que é coletado: telefone e nome do remetente + metadados; não se guarda conteúdo de mensagem; o dado pessoal é anonimizado em 30 dias. Estados: Pendente / Aceito · v\u0026lt;N\u0026gt; / Reconsentir (quando o texto do termo muda, pede reaceite). Papéis: sua empresa = Controladora, martec = Operador.\n7.6 Google Ads — o que funciona hoje O martec lê a origem Google (clique com gclid → origem paga do Google). Ainda não importa custo nem faz devolução de conversão. 💡 Use o link /r/ como URL final do anúncio; trate CPL/ROAS de Google como parciais (leads/ganhos contam; custo, não).\n","permalink":"https://faq.martec.app/pt/faq/integracoes/","summary":"Meta, CAPI, ROAS, WhatsApp, consentimento e Google Ads.","title":"7. Integrações"},{"content":"8.1 Minha carteira 🖥️ Tela — Minha carteira (cockpit + branding)\nSua carteira [⌘K] [ + Nova empresa ] ┌──────────────────────────────────────────────────────────────────┐ │ Empresa │ Ativação │ Alerta │ Ações │ │ Loja do João │ [chip] │ ⚠ Sem WhatsApp │ [ Entrar → ] │ │ Café Aurora │ [chip] │ ✓ Sem alertas │ [ Entrar → ] │ └──────────────────────────────────────────────────────────────────┘ ┌ Branding do relatório ───────────────────────────────────────────┐ │ Nome de exibição [ Minha Agência ] (vazio = nome da carteira) │ │ URL do logo [ https://exemplo.com/logo.png ] │ │ Prévia: [ 🖼 logo ] [ Salvar branding ] │ └───────────────────────────────────────────────────────────────────┘ O chip de ativação mostra quanto cada empresa completou; o alerta aponta o que falta; \u0026ldquo;Entrar →\u0026rdquo; te coloca no contexto dela.\n8.2 \u0026ldquo;Entrar como\u0026rdquo; — operar pelo cliente ✅ \u0026ldquo;Entrar →\u0026rdquo; te deixa operar como admin da empresa (montar campanha, bio, conectar integrações). Um banner de contexto mostra em qual empresa você está atuando, e o acesso é auditado.\n8.3 Branding do relatório ✅ Defina Nome de exibição e URL do logo — é o que aparece no relatório que você entrega, com prévia ao vivo. Nome vazio usa o nome da carteira.\n8.4 Relatório do cliente (lifetime) 🖥️ Tela — Relatório white-label\nRelatório do cliente [ Salvar como PDF ] Cliente [ Selecione… ▾ ] ───────────────────────────────────────────────────────────────── [🖼 logo] Minha Agência · Relatório de resultados · Loja do João Valor de vida: [Receita R$12.340][Clientes 87][Recompradores 21] [LTV médio R$141,83][Taxa recompra 24%] ROAS por campanha: Campanha|Leads|Ganhos|Custo|Receita|CPL|ROAS Criativo × público: Black Friday → … O entregável white-label: valor de vida, ROAS por campanha (com CPL = custo ÷ leads) e Criativo × Público, com \u0026ldquo;Salvar como PDF\u0026rdquo;. 💡 Acesso hoje: pela rota /dashboard/partner/report — ainda sem entrada no menu (chegue pela URL direta).\n8.5 ⚠️ \u0026ldquo;Um cliente sumiu da minha carteira\u0026rdquo; Em geral o acesso do parceiro àquela empresa foi revogado — a empresa não foi apagada, você é que perdeu a visão. Confirme com o time se foi intencional; se não, peça o re-vínculo.\n","permalink":"https://faq.martec.app/pt/faq/parceiros/","summary":"Carteira, entrar como cliente, branding e relatório lifetime.","title":"8. Parceiros \u0026 agências (white-label)"},{"content":"9.1 Isolamento Cada empresa só vê os próprios dados; cada parceiro só vê a própria carteira. A separação é garantida no banco, não só na tela.\n9.2 Retenção (executada automaticamente, todo dia) Eventos técnicos temporários: 90 dias. Dados que identificam a pessoa (telefone, nome do remetente): anonimizados em 30 dias. Telemetria técnica de clique (prefixo de IP, navegador): anonimizada em 180 dias. Histórico de fusões de leads: 365 dias. Dados de negócio (leads, vendas, agregados): não expiram por tempo — só saem por eliminação sob demanda (§9.3) ou remoção da conta. Anonimizar a telemetria não muda seus números — funil e placar não dependem das colunas anonimizadas.\n9.3 Eliminar dados a pedido do titular O titular pode pedir exclusão; o admin executa pela ação \u0026ldquo;Eliminar dados do titular\u0026rdquo; no detalhe do lead (§4.7) — não confunda com \u0026ldquo;Excluir\u0026rdquo;, que só tira da lista e mantém o dado. A eliminação anonimiza o dado pessoal de forma irreversível, preserva os valores anônimos e fica auditada.\n9.4 Consentimento versionado Os termos sensíveis são versionados: quando o texto muda, o aceite anterior cai e o sistema pede reconsentimento, com data registrada.\n9.5 Credenciais cifradas e auditoria As credenciais de integração (tokens do Meta/Google, conexão de WhatsApp) são cifradas e nunca aparecem em logs. O acesso de parceiro via \u0026ldquo;Entrar como\u0026rdquo; é auditado.\n","permalink":"https://faq.martec.app/pt/faq/dados-lgpd/","summary":"Isolamento, retenção, eliminação a pedido do titular e auditoria.","title":"9. Dados, privacidade \u0026 LGPD"},{"content":" Lead — pessoa que entrou em contato e foi registrada. Oportunidade — uma chance de venda ligada ao lead; o placar conta oportunidades. Touch — cada clique rastreado no /r/. Atribuição — ligar um lead à campanha e ao criativo de origem. Origem / Canal — precedência: fbclid (Meta pago) \u0026gt; gclid (Google pago) \u0026gt; UTM (orgânico) \u0026gt; referrer \u0026gt; direto. Match token — código gerado na tela de redirect que costura o clique com a conversa. CPL — Custo Por Lead = custo ÷ leads. CAC — Custo de Aquisição por Cliente = custo ÷ ganhos. LTV — valor de vida do cliente (no relatório do parceiro). ROAS — retorno = receita ÷ custo. Placar — a tabela Criativo × Público com Leads/Ganhos/Conversão/Receita/Custo/CPL/ROAS. Funil — a sequência Cliques → Leads → % conversa → Ganhos no painel do admin. Claim — o operador \u0026ldquo;pegar\u0026rdquo; o próximo lead da fila. Entrar como — parceiro/plataforma assumindo o contexto de uma empresa pra operar por ela (com banner de contexto e acesso auditado). Modo casa — o lead entra sem dono e é assumido por claim no \u0026ldquo;Próximo Lead\u0026rdquo;. É sobre posse, não roteamento: o link /r/ vai pro WhatsApp do operador do link. CTWA (Click to WhatsApp) — anúncio do Meta que leva direto à conversa, sem URL de destino. Atribuído como Meta pago, mas sem custo nem detalhe de criativo (não passa pelo /r/); só na conexão Oficial/Cloud. Ver §11 item 13. CAPI — Conversions API: devolve ao Meta os eventos (Lead/Purchase) enviando só o fbc, sem dado pessoal. ","permalink":"https://faq.martec.app/pt/faq/glossario/","summary":"Todos os termos do martec.app em uma página.","title":"10. Glossário"},{"content":" Índice canônico. A medição quase nunca quebra por bug — quebra por configuração errada que não dá aviso. Cada linha: sintoma → causa → o que fazer. Itens 🔴 falham silenciosamente (nenhum erro na tela; o número só não fecha).\n11.1 Captação \u0026amp; anúncio # Sintoma Causa O que fazer 1 🔴 CPL/ROAS ficam \u0026ldquo;—\u0026rdquo; numa campanha que roda no Meta Canal ≠ Meta, OU canal Meta sem o ID da campanha preenchido. O custo só sincroniza com canal Meta e o ID do Gerenciador Garanta canal Meta e abra Editar campanha → cole o ID da campanha do Meta. Não há vínculo automático por nome (§5.1) 2 🔴 Tudo cai em \u0026ldquo;Sem atribuição\u0026rdquo; no placar Anúncio sem os parâmetros de URL Cole utm_content={{ad.name}}\u0026amp;utm_term={{adset.name}}\u0026amp;utm_id={{ad.id}} (§5.4) 3 🔴 Nada rastreado; tudo \u0026ldquo;Orgânico\u0026rdquo; O destino do anúncio não é o link /r/ Use o link /r/ como destino (§5.2) 4 🔴 Criativo em branco mesmo com a landing certa Sua landing não repassa os utm_* ao botão /r/ Garanta o repasse, ou aponte o anúncio direto pro /r/ (§5.4) 5 🔴 Leads chegando no WhatsApp de quem você desligou Bloqueou o operador, mas os links dele continuam roteando Reatribua/desative os links antes de bloquear (§4.6) 6 Visitante vê \u0026ldquo;este link expirou ou não existe\u0026rdquo; Link pausado/excluído com o anúncio ainda apontando Pause o anúncio primeiro; só então mexa no link (§5.2) 7 Clique cai em \u0026ldquo;indisponível\u0026rdquo; Tracking link sem operador Associe um operador ao link (§5.2) 8 🔴 Cliente recebe \u0026ldquo;Olá {nome}\u0026rdquo; cru Placeholder inválido (só 6 funcionam) Use só os 6: {utm_source} {utm_campaign} {utm_content} {utm_term} {campaign_name} {tracking_link_slug} (§5.2) 9 Não consigo salvar o WhatsApp do operador (ou número legado rotearia errado) O cadastro exige celular BR válido (DDD + 9 — +55 DD 9XXXX-XXXX); não-BR/malformado é rejeitado na criação/edição com erro. Só dado legado escaparia e rotearia errado Informe um número BR válido; não-BR não é suportado hoje. Suspeita de dado legado? Edite o operador e re-salve 11.2 Integrações # Sintoma Causa O que fazer 10 🔴 CAPI parou de enviar conversão Credencial desabilitada/não-verificada/revogada, OU Meta desconectado Cheque \u0026ldquo;Envio CAPI: Ativo\u0026rdquo;; reconecte o Meta se preciso (§7.2) 11 🔴 Custo congelado / ROAS desatualizado Token Meta expirou e ninguém reconectou (banner estado D) Reconecte antes do token vencer (\u0026lt;7 dias avisa) (§7.1) 12 🔴 Conectou o Meta mas não veio conta de anúncio Usuário do Facebook sem acesso à conta (banner estado C) Reconecte com o usuário que enxerga a conta no Gerenciador (§7.1) 13 🔴 Leads de CTWA sem custo, CPL/ROAS nem criativo CTWA entra como Meta pago no funil, mas sem custo/criativo (não passa pelo /r/); ativo só na Cloud Pra ter custo e criativo, use o link /r/ como destino em vez do CTWA nativo (§5.4) 14 🔴 As conversas de um operador não correlacionam Operador cadastrado com WhatsApp diferente do número conectado — o casamento é por número Cadastre o operador com o mesmo número conectado em WhatsApp connect (§7.4) 15 Duas conexões de WhatsApp no mesmo número Migrou Evolution→Oficial; a Evolution não desliga sozinha Desconecte a Evolution manualmente após confirmar a Oficial (§7.4) 16 Custo de campanha Google não aparece Esperado: Google ainda não tem import de custo Trate CPL/ROAS de Google como parciais (§7.6) 11.3 Públicas \u0026amp; operação # Sintoma Causa O que fazer 17 Bio publicada parece abandonada Publicada sem botões Adicione ao menos um botão antes de publicar (§6.1) 18 Meu teste de clique não conta Bot/preview ou limite de cliques (10/60s no mesmo IP) Teste do celular, sem recarregar várias vezes; o clique real conta (§6.3) 19 \u0026ldquo;Hoje/Ontem\u0026rdquo; parecem deslocados Fuso da empresa errado Ajuste o timezone da empresa 20 Custo aparece só no dia seguinte Esperado: sync de custo roda de madrugada (~05–06h) Aguarde o próximo ciclo; se persistir \u0026gt;1 dia, cheque canal (§5.1) e banner Meta (§7.1) 11.4 Roteiro de \u0026ldquo;ativação sem buraco\u0026rdquo; (faça nesta ordem) Crie a campanha no canal certo (Meta, se roda no Meta) — item 1. Crie o tracking link com operador e mensagem só com os 6 placeholders — itens 7, 8. Confira o WhatsApp do operador no padrão BR e igual ao número conectado — itens 9, 14. No anúncio, use o link /r/ como destino e cole os parâmetros de URL — itens 2, 3, 4. Use Validar oferta pra conferir destino + mensagem + marcação antes de publicar (§5.3). Conecte o Meta com o usuário certo, confirme o banner verde, e cole o ID da campanha do Meta em cada campanha (Editar campanha) — senão o custo não fecha — itens 11, 12, 1. Se usa CAPI, confirme \u0026ldquo;Envio CAPI: Ativo\u0026rdquo; — item 10. Publique. Não pause/exclua o link nem bloqueie o operador sem antes tratar os anúncios no ar — itens 5, 6. ","permalink":"https://faq.martec.app/pt/faq/erros-config/","summary":"Sintoma -\u0026gt; causa -\u0026gt; solução para o que quebra a medição em silêncio.","title":"11. Erros de configuração que quebram a medição"}]