> ## Documentation Index > Fetch the complete documentation index at: https://docs.octasend.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Cookies e LGPD > Banner de consentimento, scanner de cookies e documentos jurídicos (política de cookies, privacidade e termos) para o seu site, com a prova de cada decisão do visitante O módulo **Cookies (LGPD)** ajuda o seu site a pedir o consentimento dos visitantes e a provar que pediu. Ele reúne três partes: * **Banner de consentimento:** o aviso e a central de preferências que aparecem no seu site, com as quatro categorias de cookies, bloqueio dos serviços até o aceite e registro de cada decisão. * **Scanner de cookies:** uma varredura automática das páginas do seu site que lista os cookies e os serviços de terceiros que ele realmente usa. * **Documentos:** a política de cookies, a política de privacidade e os termos de uso, gerados de modelos, editados por você e publicados numa página pública. > [!NOTE] > > **Módulo opcional.** Se o item **Cookies (LGPD)** não aparecer no menu ou a tela mostrar "Módulo não liberado", fale com a OctaSend para ativar. A aba **Documentos** é liberada à parte: sem ela, a tela mostra só as demais abas. > [!WARNING] > > Os documentos partem de modelos da OctaSend e **não substituem orientação jurídica**. Revise o texto com quem cuida da parte jurídica da sua empresa antes de publicar. ## Onde fica No menu **Cookies (LGPD)**. A tela tem sete abas: | Aba | Para que serve | | - | - | | **Sites** | Cadastrar os sites, os domínios de cada um e o código de instalação. | | **Banner** | Aparência, comportamento e textos do banner, com prévia ao vivo. Aqui também fica o botão **Publicar**. | | **Cookies e serviços** | Marcar os serviços que o site usa e declarar os que não estão no catálogo. | | **Consentimentos** | Consultar e exportar a prova de cada decisão dos visitantes. | | **Métricas** | Acompanhar exibições e decisões do banner. | | **Scanner** | Varrer o site e decidir o que fazer com o que foi encontrado. | | **Documentos** | Gerar, editar e publicar as políticas e os termos. | Quase tudo é por **site**: escolha o site na lista do topo da tela para ver cada aba. Cada site tem o próprio banner, serviços, registros, varreduras e documentos. ## Como o consentimento funciona O banner segue o modelo de **opt-in**: nada além do necessário roda antes de o visitante aceitar. | Categoria | O que cobre | Pode ser recusada? | | - | - | - | | **Necessários** | O que o site precisa para funcionar. | Não, fica sempre ativa. | | **Funcionais** | Recursos como chat e preferências. | Sim | | **Analytics** | Medição de audiência e comportamento. | Sim | | **Marketing** | Anúncios e remarketing. | Sim | * O visitante tem três botões de mesmo peso visual: **aceitar todos**, **rejeitar** e **personalizar**. * Os scripts e iframes de serviços do catálogo (como Google Analytics, Meta Pixel, YouTube e Google Maps) ficam **bloqueados** até a categoria deles ser aceita. Num conteúdo bloqueado, o visitante vê um aviso com o botão **Aceitar e ver**, que libera só aquela categoria. * A escolha fica gravada no cookie `octa_consent`, no domínio principal do site, pelo prazo que você definir (de 1 a 12 meses). Depois disso, o banner volta a aparecer. * O script já envia o **Google Consent Mode v2**: o padrão é "negado" e a atualização acontece na decisão. Os eventos `octa_consent_default` e `octa_consent_update` vão para o `dataLayer`, para você usar no Google Tag Manager. * Os módulos da OctaTag respeitam a escolha: o assistente e o carrinho abandonado dependem da categoria **Funcionais**, e a telemetria de tours e avaliações depende de **Analytics**. Em sites sem o banner, tudo continua funcionando como antes. ## Cadastrar o site e instalar **1. Crie o site** Na aba **Sites**, clique em **Novo site** e preencha o **Nome** e os **Domínios**, um por linha. Use `*.minhaloja.com.br` para incluir todos os subdomínios. Cada domínio só pode pertencer a um site da conta, e o limite é de 50 domínios por site. **2. Copie o script** Em **Instalação**, copie o **Script do banner**. O mesmo código serve para todos os sites da conta. Se a conta ainda não tem a tag, o botão **Gerar em Instalação** leva à tela certa. **3. Cole no site** Cole o script como o **primeiro script do ``**, antes do Google Tag Manager e de pixels. Scripts que carregarem antes dele não podem ser bloqueados. **4. Confirme** Abra o site. Em **Domínios e instalação**, o domínio passa a mostrar "Visto há…" quando o script carrega. Se o script rodar num endereço que nenhum site cobre, ele aparece em **Domínios vistos sem site**. Se a sua conta usa a lista de sites autorizados em **Configurações → Instalação**, o curinga `*.dominio` não entra nela sozinho: inclua cada subdomínio à mão. Veja [OctaTag](https://docs.octasend.com.br/plataforma/octatag.md). O script termina a configuração do banner em segundo plano. Se ele falhar ou demorar, o site funciona normalmente, sem bloqueio. ## Configurar o banner Na aba **Banner**, as alterações são salvas automaticamente como **rascunho**. O indicador no topo mostra **Rascunho salvo**, **Salvando…** ou **Não foi possível salvar**. O banner no ar só muda quando você **publica**. | Campo | O que define | | - | - | | **Layout** | **Barra inferior**, **Caixa no canto** ou **Modal central**. | | **Tema** | **Claro**, **Escuro** ou **Automático**. | | **Cor de destaque** | Cor dos três botões, no formato `#rrggbb`. A tela avisa quando o contraste com o fundo é baixo. | | **Arredondamento** | De 0 a 24 px. | | **URL do logo** | Opcional, só `https://`. | | **Ícone flutuante** | Deixa o visitante reabrir as preferências a qualquer momento. | | **Esconder o ícone depois do consentimento** | Opção do ícone flutuante. | | **URL da política de privacidade** | Opcional, só `https://`. Os documentos publicados podem preencher este campo. | | **Validade da escolha** | De 1 a 12 meses. | | **Idiomas** | Português (Brasil), Inglês e Espanhol. O banner abre no idioma do navegador, se estiver ativo; senão, no **Idioma padrão**. | | **Textos** | Título, descrição, botões, rótulos e o nome e a descrição de cada categoria, por idioma. Campo vazio usa o texto padrão mostrado nele. | A **Prévia** mostra o banner ou a central de **Preferências**, no idioma e no tema que você escolher. Ela não registra decisões. Os serviços aparecem na prévia depois de declarados. Para o visitante reabrir as preferências, o site pode usar o link `#octa-cookies` ou a chamada `octasend('cookies', 'abrir')`. ## Cookies e serviços Na aba **Cookies e serviços**, marque os serviços do catálogo que o site usa. Eles aparecem no banner, na categoria de cada um, e o script libera cada serviço só depois do consentimento. Use **Buscar serviço** para encontrar um. Para um serviço que não está no catálogo, clique em **Adicionar serviço manual** e informe nome, categoria, descrição, os cookies (nome, duração e finalidade) e os domínios do script. O limite é de 100 serviços por site. > [!NOTE] > > Só os serviços do **catálogo** são bloqueados automaticamente. Para um serviço manual, marque o script no seu site com `type="text/plain"` e `data-octa-categoria="..."`. Sem a marcação, ele carrega mesmo sem consentimento. A tela mostra o trecho pronto para copiar. ## Publicar Clique em **Publicar** na aba **Banner**. Cada publicação cria uma **versão** nova, que fica no histórico e não pode ser alterada. O diálogo mostra o que muda nos serviços (novos, removidos e que mudaram de categoria) e a opção **Pedir novo consentimento aos visitantes**: * Ela vem marcada quando há serviço novo ou mudança de categoria, porque os visitantes precisam decidir de novo. * Deixe desmarcada para manter as escolhas atuais. Não dá para publicar sem pelo menos um domínio cadastrado e com o rascunho do banner válido. A lista **Versões publicadas** mostra o histórico e em quais versões foi pedido novo consentimento. ## Consentimentos: a prova de cada decisão Cada decisão do visitante gera um registro, guardado por 5 anos. Na aba **Consentimentos**: * **Buscar por ID do consentimento:** cole o ID (UUID) para ver todas as decisões daquele visitante, da mais antiga para a mais recente. * **Lista por período:** data e hora, ação (**Aceitou tudo**, **Rejeitou tudo**, **Personalizou** ou **Revogou**), categorias, versão do banner, idioma, URL e ID. O período máximo é de 366 dias. * **Exportar CSV:** gera o arquivo do período escolhido. Exige a permissão de exportar. Para proteger o visitante, o endereço de rede não é guardado em claro: só uma versão codificada dele, e a URL é registrada sem parâmetros. ## Métricas A aba **Métricas** mostra, para 7, 30 ou 90 dias: **Exibições do banner**, **Decisões**, **Taxa de aceite total**, **Taxa de rejeição** e **Visitantes com decisão no mês**, além do gráfico diário, do **Aceite por categoria** e da tabela **Por dia**. As revogações são contadas à parte: não entram nas decisões nem nas taxas. ## Scanner de cookies O scanner visita as páginas do seu site com um navegador, **antes e depois do aceite**, e lista os cookies, o armazenamento local e os serviços de terceiros que encontra. Ele serve para descobrir o que o site realmente grava, sem depender da memória de quem montou a lista. ### Endereços verificados Na aba **Scanner**, em **Endereços verificados**, informe até 10 páginas do site. Inclua as que carregam scripts diferentes, como checkout e blog. Sem endereços salvos, a tela sugere a página inicial de cada domínio do site. Clique em **Salvar endereços**. Os endereços precisam ser públicos e estar nos domínios do site. A tela recusa, com a explicação: * endereços de rede interna, IP literal, porta, usuário e senha; * endereços fora dos domínios cadastrados no site. ### Executar uma varredura * **Escanear agora** inicia uma varredura. Cada site pode ter **uma varredura manual a cada 24 horas**; depois dela, a tela mostra quando a próxima será liberada. Não dá para iniciar outra enquanto uma está em andamento. * A **Última varredura** mostra o andamento ("N de M páginas") e a situação: **Na fila**, **Em andamento**, **Concluída**, **Parcial** (algumas páginas não puderam ser verificadas; os resultados consideram só as que deram certo) ou **Falhou**. * **Últimas varreduras** lista o histórico, com a origem (**Manual** ou **Mensal**), a data e as páginas com e sem erro. ### Configurações | Opção | O que faz | | - | - | | **Varredura mensal** | Uma vez por mês, o scanner verifica o site sozinho. | | **Relatório por e-mail** | Envia o relatório depois da varredura mensal, só para quem pode editar cookies e só quando há novidade. | ### Achados Os resultados ficam em **Achados**, em quatro grupos: | Grupo | O que significa | | - | - | | **Novos** | Serviços conhecidos que ainda não estão na sua lista. | | **Não identificados** | Cookies e domínios sem serviço conhecido. Classifique ou ignore. | | **Já na lista** | Achados que você já adicionou ou classificou. | | **Sumiram** | Não apareceram na última varredura. Confira se ainda são usados. | Cada achado mostra o tipo (**Cookie**, **Armazenamento** ou **Domínio de terceiro**), a origem (**Varredura** ou **Visitantes**), as ocorrências, quando foi visto por último e a marca **Gravado antes do aceite** quando apareceu antes de o visitante aceitar os cookies. As ações são: * **Adicionar:** inclui o serviço conhecido no rascunho da lista de serviços. Publique o banner para valer. * **Classificar:** registra a categoria de um achado não identificado no seu histórico. Para ele aparecer no banner, cadastre um serviço manual em **Cookies e serviços**. * **Ignorar:** tira o achado da lista. > [!NOTE] > > Quem só pode visualizar vê os resultados, mas só quem pode editar cookies escaneia, muda os endereços e decide sobre os achados. ## Documentos legais A aba **Documentos** gera e publica três documentos por site: **Política de cookies**, **Política de privacidade** e **Termos de uso**, em português, inglês e espanhol. ### 1. Identidade jurídica Preencha uma vez, no topo da aba. Vale para todos os sites da conta e é **obrigatória antes de publicar** qualquer documento. | Campo | Observação | | - | - | | **Tipo de documento** | **CNPJ** ou **CPF**, com validação do número. | | **Razão social** ou **Nome completo** | Conforme o tipo escolhido. | | **Logradouro, número, complemento, bairro, cidade, UF, CEP** | O endereço do controlador dos dados. | | **E-mail de contato** | Para onde os titulares mandam pedidos sobre os dados. | | **Telefone** | Opcional. | | **Encarregado (DPO)** | Opcional. Se preencher nome e e-mail, a política de privacidade ganha a seção do encarregado. | Estes dados aparecem nas páginas públicas dos documentos, visíveis para qualquer visitante. Eles são salvos automaticamente. ### 2. Endereço público Defina o **Endereço do site**: de 2 a 60 caracteres, só letras minúsculas, números e hífen. Ele forma o link dos documentos e **não muda depois da primeira publicação** (a tela mostra a marca **Endereço fixo**). Se a tela avisar que a sua conta ainda não tem endereço público, fale com o suporte da OctaSend para configurar o endereço da conta. ### 3. Criar, editar e publicar **1. Crie o rascunho** No cartão do documento, clique em **Criar rascunho**. Ele parte do modelo da OctaSend, preenchido com a sua identidade jurídica. **2. Edite o texto** Clique em **Editar**. O editor tem negrito, itálico, subtítulos, listas, citação e links (`https://`, `mailto:` ou `#âncora`). Cada seção editada por você ganha a marca **Editada**. Um aviso fixo lembra que o texto é um modelo. **3. Confira a prévia** Em **Visualizar**, veja como a página pública vai ficar com o rascunho atual. **4. Publique** Clique em **Publicar**. O diálogo mostra o endereço do documento e o que falta resolver, se houver. Confirme em **Publicar documento**. Antes de publicar, a tela cobra: * a identidade jurídica completa; * o banner do site publicado (a tabela de cookies vem dele); * que o texto não use marcadores (como `{{empresa}}`) que não existem. Detalhes do editor: * A **tabela de cookies** da política de cookies é montada na publicação, a partir dos serviços do banner publicado. Ela não é editada à mão: para mudar a tabela, altere os serviços e publique o banner. * Quando a OctaSend lança um modelo mais novo, o cartão avisa "Há um modelo mais novo". **Aplicar modelo mais novo** troca o texto das seções que você **não** editou; as editadas ficam como estão, e a tela lista quais. * O cartão mostra **Desatualizada** quando há modelo novo ou quando os serviços do banner mudaram desde a publicação. Publique de novo para atualizar. * Se um título de seção ficar inválido (vazio, com `<` ou `>`, ou muito longo), o rascunho para de ser salvo até você corrigir. ### Ajuste de tom por IA No menu do cartão ou no editor, **Ajustar tom** reescreve os parágrafos do idioma aberto com a IA, sem mudar dados, marcadores nem a tabela de cookies. | Tom | Resultado | | - | - | | **Padrão do modelo** | O texto original do modelo. | | **Formal** | Linguagem jurídica e impessoal. | | **Claro e direto** | Frases curtas, sem jargão. | | **Amigável** | Próximo, falando com "você". | * O resultado cai no **rascunho**: confira antes de publicar. * Se o texto ajustado de alguma seção mudar dados ou marcadores, essa seção é descartada e mantém o texto anterior, e a tela lista quais. * O ajuste consome o uso de IA da conta. Se o limite do mês acabou, a tela avisa "O limite de uso de IA do mês acabou" e o rascunho não é alterado. ### Página pública Cada documento publicado ganha um endereço próprio, sem login: | Documento | Endereço | | - | - | | Política de cookies | `https://octasend.com.br/p/{conta}/{site}/politica-de-cookies` | | Política de privacidade | `https://octasend.com.br/p/{conta}/{site}/politica-de-privacidade` | | Termos de uso | `https://octasend.com.br/p/{conta}/{site}/termos-de-uso` | * A página mostra a versão **vigente**; acrescentando `/historico` ao endereço, o visitante acessa as versões anteriores. * O idioma muda pelo parâmetro `?lang=` (por exemplo, `?lang=en`). * O PDF sai pelo próprio navegador (imprimir como PDF), com folha de estilo própria. * A página usa o seu logo e a cor de destaque do banner, com tema claro e escuro automáticos. * **Copiar link** e **Abrir** ficam no cartão do documento. Na publicação, **Usar este link no banner** coloca o link da política de cookies no campo de política do rascunho do banner (vale depois que você publicar o banner). * Cada publicação cria uma **versão imutável**. **Versões** no cartão lista as publicadas, com a vigente marcada. ## Quem pode usar O acesso é controlado pelos [perfis de acesso](https://docs.octasend.com.br/plataforma/configuracoes.md) (página **Cookies (LGPD)**): | Permissão | O que libera | | - | - | | **Visualizar** | Ver todas as abas e dados do módulo. Sem ela, o item some do menu. | | **Editar** | Criar e editar sites, banner, serviços, varreduras, achados, identidade jurídica e rascunhos dos documentos, e ajustar o tom. | | **Publicar** | Publicar o banner e os documentos. | | **Exportar** | Exportar o CSV de consentimentos. | ## Limites desta versão * Iframes e scripts de serviços do catálogo são bloqueados automaticamente; serviços manuais dependem da marcação no seu site. * Scripts do catálogo que carregam **antes** do script do banner não podem ser bloqueados. * O portal para o titular (pedidos LGPD) e o aviso ao encarregado por e-mail ainda não existem neste módulo. * Os modelos de documento não substituem a revisão jurídica. ## Solução de problemas > [accordion] O banner não aparece no site > > Confira se há uma versão publicada para o site (aba **Sites** mostra "Versão N no ar"), se o domínio está cadastrado no site e se o script está no ``. Sem versão publicada, o site funciona sem bloqueio e sem banner. Se a sua conta usa a lista de domínios autorizados da OctaTag, o domínio também precisa estar nela. > [accordion] O banner volta a aparecer para quem já decidiu > > Isso acontece quando a validade da escolha acabou, quando o visitante limpou os cookies ou quando você publicou com **Pedir novo consentimento aos visitantes** marcada. > [accordion] Não consigo escanear agora > > Cada site aceita uma varredura manual a cada 24 horas e uma por vez. Confira também se há ao menos um endereço salvo e se você tem a permissão de editar. > [accordion] Não consigo publicar o documento > > A tela lista o que falta em "Resolva antes de publicar": identidade jurídica incompleta, banner do site ainda não publicado ou marcadores inexistentes no texto. > [accordion] O cartão do documento mostra Desatualizada > > Os serviços do banner mudaram depois da última publicação, ou existe um modelo mais novo. Publique o banner (se mudou serviços), aplique o modelo novo se quiser e publique o documento de novo. ## Veja também > [card] [OctaTag](https://docs.octasend.com.br/plataforma/octatag.md) > > A tag única do site e os módulos que respeitam o consentimento. > [card] [Popups personalizadas](https://docs.octasend.com.br/plataforma/popups.md) > > A navegação só é registrada com o consentimento de marketing. > [card] [Configurações](https://docs.octasend.com.br/plataforma/configuracoes.md) > > Perfis de acesso e domínios autorizados. > [card] [Web Push](https://docs.octasend.com.br/guias/web-push.md) > > Notificações no navegador, com permissão própria. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.