# Permito — Plataforma de Gestão de Consentimento (CMP) e Evidências LGPD
> Gerencie banners de cookies, políticas e registros de consentimento em uma plataforma. Conheça a Permito e comece grátis, sem cartão de crédito.
## Sobre o Permito
O Permito é uma plataforma SaaS brasileira de gestão de consentimento (CMP - Consent Management Platform) voltada para empresas, equipes de marketing, produto, jurídico/compliance e agências que precisam publicar banners de cookies, hospedar políticas públicas versionadas e manter trilha auditável das decisões dos visitantes para conformidade com a LGPD (Lei Geral de Proteção de Dados - Lei nº 13.709/2018).
## Capacidades Principais
- **Banner de cookies por domínio:** escopo estrito para o domínio raiz cadastrado (`domain_root`) e seus subdomínios (`*.domain_root`), com customização visual e publicação em ação única versionada.
- **Registro auditável de consentimento:** cada escolha do visitante (aceitar tudo, recusar tudo ou personalizar categorias Essenciais, Analytics e Marketing) é registrada com data/hora, site, host, identificador do visitante, estado das categorias e versão exata da configuração publicada.
- **Políticas públicas com histórico:** publicação de Política de Privacidade, Política de Cookies e Termos com URL pública estável (`/policies/public/[slug]`) e versionamento interno.
- **Dashboard e exportação CSV:** métricas de page views, decisões, taxa de cobertura e exportação de logs em CSV com trilha em `workspace_audit`.
- **Webhooks assinados via HMAC:** envio assíncrono com retentativas automáticas para eventos `consent.created` e `consent.updated`.
- **Multi-tenant por workspace:** controle de acesso baseado em papéis (`owner`, `admin`, `user`, `viewer`) e chaves de leitura para API.
## Links Públicos Principais
- [Página Inicial](https://permito.com.br/): Visão geral comercial, funcionamento, prova de consentimento e perguntas frequentes.
- [Criar Conta Grátis](https://permito.com.br/register): Cadastro gratuito sem necessidade de cartão de crédito.
- [Central de Documentação](https://permito.com.br/docs): Guias passo a passo de configuração, snippet, webhooks, políticas e relatórios.
- [Perguntas Frequentes (Docs)](https://permito.com.br/docs/faq): Respostas diretas sobre escopo de domínio, verificação, categorias, planos e webhooks.
- [Política de Privacidade](https://permito.com.br/privacy): Tratamento de dados pessoais e direitos LGPD.
- [Termos e Condições](https://permito.com.br/terms): Regras de uso e licenciamento SaaS.
- [Política de Cookies](https://permito.com.br/cookies-policy): Categorias de cookies e integração com Google Analytics condicionada ao consentimento.
- [Política de Reembolso](https://permito.com.br/refund-policy): Regras comerciais de assinatura e cancelamento.
- [Índice LLM Compacto](https://permito.com.br/llms.txt): Mapa estruturado para agentes e mecanismos de resposta por IA.
- [Documentação LLM Completa](https://permito.com.br/llms-full.txt): Conteúdo integral da documentação em arquivo único de texto.
# Conteúdo Completo da Documentação
## Como o Permito funciona
URL: https://permito.com.br/docs/conceitos/como-o-permito-funciona
Veja a jornada de consentimento desde o painel até os logs e webhooks.
O Permito transforma uma configuração feita no painel em um banner publicado no site e em registros auditáveis de consentimento.
Você cria um site no workspace.
O Permito gera uma chave pública do site.
Você configura textos, links legais, categorias e estilo.
Um `owner` ou `admin` publica a configuração.
Você copia e instala o snippet no site.
O script do Permito carrega a configuração publicada.
O visitante aceita, recusa ou personaliza preferências.
O Permito registra logs com host, visitante, estado e versão.
Se houver webhook ativo, o evento é enviado à URL configurada.
O CMP público só deve operar no domínio raiz cadastrado e em subdomínios desse domínio. Isso evita que um snippet de um site seja usado indevidamente em outro domínio.
Exemplo:
| Domínio cadastrado | Aceito | | ------------------ | ------------- | | `empresa.com` | `empresa.com` |
| Domínio cadastrado | Aceito | | ------------------ | ----------------- | | `empresa.com` | `www.empresa.com` |
| Domínio cadastrado | Aceito | | ------------------ | ----------------- | | `empresa.com` | `app.empresa.com` |
| Domínio cadastrado | Aceito | | ------------------ | ------------------------------- | | `empresa.com` | `outraempresa.com` não é aceito |
Cada publicação aumenta ou mantém uma versão publicada da configuração. Quando um visitante toma uma decisão, o log registra a versão ativa naquele momento.
Isso ajuda a responder perguntas como:
Qual texto o visitante viu?
Quais categorias estavam disponíveis?
Qual configuração estava publicada quando o consentimento foi dado?
Para operar com segurança, mantenha cada equipe no workspace correto, use o menor perfil necessário e não compartilhe chaves, segredos de webhook ou links de convite em canais públicos.
Revise os termos principais.
## Permissões e acessos
URL: https://permito.com.br/docs/conceitos/permissoes-e-acessos
Entenda os perfis disponíveis e o que cada pessoa pode fazer no Permito.
O Permito controla acessos por workspace. O papel de cada pessoa define o que ela pode criar, editar, publicar, exportar ou apenas visualizar.
| Perfil | Indicado para | O que pode fazer | | ------- | ------------------------------------ | ------------------------------------------------------------------------------- | | `owner` | Responsável principal pelo workspace | Gerencia workspace, membros, sites, publicações, webhooks, chaves e exportações |
| Perfil | Indicado para | O que pode fazer | | ------- | -------------------------------- | -------------------------------------------------------------------- | | `admin` | Pessoa que administra a operação | Gerencia membros, sites, publicações, webhooks, chaves e exportações |
| Perfil | Indicado para | O que pode fazer | | ------ | ---------------------------- | --------------------------------------------- | | `user` | Pessoa que opera o dia a dia | Edita draft do site e visualiza métricas/logs |
| Perfil | Indicado para | O que pode fazer | | -------- | ------------------------------- | --------------------------------------------------- | | `viewer` | Pessoa que acompanha sem editar | Visualiza métricas e logs, sem alterar configuração |
| Ação | Owner | Admin | User | Viewer | | ---------- | ----- | ----- | ---- | ------ | | Criar site | Sim | Sim | Não | Não |
| Ação | Owner | Admin | User | Viewer | | ---------------------- | ----- | ----- | ---- | ------ | | Editar draft do banner | Sim | Sim | Sim | Não |
| Ação | Owner | Admin | User | Viewer | | --------------- | ----- | ----- | ---- | ------ | | Publicar banner | Sim | Sim | Não | Não |
| Ação | Owner | Admin | User | Viewer | | -------------------------- | ----- | ----- | ---- | ------ | | Desativar ou reativar site | Sim | Sim | Não | Não |
| Ação | Owner | Admin | User | Viewer | | ------------- | ----- | ----- | ---- | ------ | | Ver dashboard | Sim | Sim | Sim | Sim |
| Ação | Owner | Admin | User | Viewer | | -------- | ----- | ----- | ---- | ------ | | Ver logs | Sim | Sim | Sim | Sim |
| Ação | Owner | Admin | User | Viewer | | ----------------- | ----- | ----- | ---- | ------ | | Exportar logs CSV | Sim | Sim | Não | Não |
| Ação | Owner | Admin | User | Viewer | | -------------- | ----- | ----- | ---- | ------ | | Criar webhooks | Sim | Sim | Não | Não |
| Ação | Owner | Admin | User | Viewer | | -------------------------- | ----- | ----- | ---- | ------ | | Rotacionar API key do site | Sim | Sim | Não | Não |
| Ação | Owner | Admin | User | Viewer | | ----------------- | ----- | ----- | ---- | ------ | | Gerenciar membros | Sim | Sim | Não | Não |
| Ação | Owner | Admin | User | Viewer | | ------------------------------------ | ----- | ----- | ---- | ------ | | Criar chaves de leitura do workspace | Sim | Sim | Não | Não |
Use `viewer` para pessoas que só precisam consultar dados.
Use `user` para quem pode ajustar draft, mas não deve publicar.
Use `admin` para responsáveis por operação e integrações.
Use `owner` com cuidado e revise acessos periodicamente.
Veja status e eventos.
## Status e eventos
URL: https://permito.com.br/docs/conceitos/status-e-eventos
Entenda os status de sites, políticas, webhooks, convites e eventos de consentimento.
Status ajudam você a entender o que está ativo, pendente, publicado, falhando ou bloqueado.
| Status | O que significa | O que fazer | | --------- | ----------------------------------------------- | ----------------------------------------------- | | **Ativo** | O CMP público pode operar no domínio autorizado | Mantenha ativo enquanto o banner deve funcionar |
| Status | O que significa | O que fazer | | -------------- | ----------------------------------------------------------- | -------------------------------------- | | **Desativado** | O snippet para de operar e novos eventos CMP são bloqueados | Reative quando quiser voltar a coletar |
| Status | O que significa | O que fazer | | ------------ | ------------------------------------------ | ------------------------------------ | | **Verified** | O site recebeu pelo menos um evento válido | Use dashboard e logs para acompanhar |
| Status | O que significa | O que fazer | | -------------- | ----------------------------------------- | ----------------------------------------------- | | **Unverified** | Ainda não há evento válido para o domínio | Instale o snippet e acesse o domínio autorizado |
| Status | O que significa | O que fazer | | --------- | ----------------------------- | --------------------------------------- | | **Draft** | Documento ainda não publicado | Revise e publique quando estiver pronto |
| Status | O que significa | O que fazer | | ------------- | --------------------------------- | ------------------------------------ | | **Publicado** | Documento tem URL pública estável | Use o link público no banner ou site |
| Status | O que significa | O que fazer | | --------- | ------------------------ | --------------------------------------- | | `pending` | Entrega aguardando envio | Aguarde e acompanhe a próxima tentativa |
| Status | O que significa | O que fazer | | --------- | ------------------------------------------------- | ----------------------- | | `success` | O sistema de destino recebeu o evento com sucesso | Nenhuma ação necessária |
| Status | O que significa | O que fazer | | -------- | --------------- | -------------------------------------------------------------- | | `failed` | Entrega falhou | Verifique URL, segredo, resposta HTTP e tente **Retry falhas** |
| Evento | Quando acontece | | ------ | ----------------------- | | `boot` | O loader inicia no site |
| Evento | Quando acontece | | ----------- | ------------------------ | | `page_view` | Uma página é visualizada |
| Evento | Quando acontece | | ----------------- | ---------------------------------------- | | `consent_created` | Um visitante registra a primeira decisão |
| Evento | Quando acontece | | ----------------- | ---------------------------------------- | | `consent_updated` | Um visitante altera uma decisão anterior |
| Evento | Quando acontece | | -------------------- | --------------------------------- | | `preferences_opened` | O painel de preferências é aberto |
| Evento | Uso | | ----------------- | ----------------------------------------------------------- | | `consent_created` | Sincronizar primeira escolha do visitante com outro sistema |
| Evento | Uso | | ----------------- | ----------------------------------- | | `consent_updated` | Sincronizar mudança de preferências |
Abra o painel principal.
## Termos principais
URL: https://permito.com.br/docs/conceitos/termos-principais
Glossário rápido dos termos usados no Permito.
| Termo | Significado | Onde aparece | | --------- | ----------------------------------------------- | ------------------------------ | | Workspace | Ambiente de trabalho que separa dados e membros | Seletor lateral, Configurações |
| Termo | Significado | Onde aparece | | ----- | --------------------------------------- | ------------ | | Site | Domínio configurado para carregar o CMP | Sites |
| Termo | Significado | Onde aparece | | ------- | ------------------------------------ | ------------ | | Snippet | Código instalado no `` do site | Instalação |
| Termo | Significado | Onde aparece | | -------------- | -------------------------------------------------------- | ------------ | | Código do site | Código usado pelo snippet; rotacionar exige reinstalação | Instalação |
| Termo | Significado | Onde aparece | | ------- | --------------------------------------------- | ------------ | | Webhook | Envio de evento do Permito para outro sistema | Webhooks |
| Termo | Significado | Onde aparece | | ---------------- | ---------------------------------------------------- | -------------------------- | | Chave de leitura | Credencial para consultar dados do workspace via API | Configurações → Acesso API |
| Termo | Significado | Onde aparece | | ----------- | --------------------------------------------------- | --------------------- | | Consent log | Evidência auditável de uma decisão de consentimento | Logs de consentimento |
| Termo | Significado | Onde aparece | | ----- | ------------------------------------ | --------------- | | Draft | Alteração salva, ainda não publicada | Detalhe do site |
| Termo | Significado | Onde aparece | | ---------------- | ----------------------------- | --------------------- | | Versão publicada | Configuração ativa no snippet | Detalhe do site, logs |
Veja Status e eventos.
## Visão geral de conceitos
URL: https://permito.com.br/docs/conceitos/visao-geral
Entenda os conceitos essenciais do Permito antes de operar a plataforma.
O Permito organiza consentimento em torno de workspace, site, configuração publicada, snippet, eventos, logs, políticas e webhooks.
| Conceito | Explicação simples | Onde aparece | | --------- | ---------------------------------------------------- | ------------------------------ | | Workspace | Espaço que agrupa sites, membros, logs e integrações | Seletor lateral, Configurações |
| Conceito | Explicação simples | Onde aparece | | -------- | ------------------------------------ | ------------ | | Site | Domínio onde o banner será instalado | Sites |
| Conceito | Explicação simples | Onde aparece | | ------------ | --------------------------------------- | -------------------------- | | Domínio raiz | Domínio principal autorizado para o CMP | Novo site, detalhe do site |
| Conceito | Explicação simples | Onde aparece | | -------- | ------------------------------------------------- | ------------------ | | Snippet | Código que deve ser instalado no `` do site | Aba **Instalação** |
| Conceito | Explicação simples | Onde aparece | | -------- | ------------------------------------ | --------------------------- | | Draft | Alteração salva, ainda não publicada | Detalhe do site e políticas |
| Conceito | Explicação simples | Onde aparece | | ---------------- | ---------------------------------- | --------------------- | | Versão publicada | Configuração ativa para visitantes | Site, logs, dashboard |
| Conceito | Explicação simples | Onde aparece | | ----------- | ---------------------------------------------- | --------------------- | | Consent log | Registro auditável de uma escolha do visitante | Logs de consentimento |
| Conceito | Explicação simples | Onde aparece | | -------- | ---------------------------------------------- | -------------- | | Webhook | Envio automático de eventos para outro sistema | Site, Webhooks |
| Conceito | Explicação simples | Onde aparece | | ---------------- | ----------------------------------- | ------------ | | Política pública | Documento publicado com URL estável | Políticas |
Alguns termos aparecem na interface porque ajudam a identificar eventos e integrações:
`site_key`: chave pública que identifica o site no snippet.
`visitor_id`: identificador pseudônimo usado nos logs.
Versão da configuração: versão do banner usada quando o evento foi registrado.
Segredo do webhook: valor combinado com o sistema de destino para proteger a integração.
Sempre que esses termos aparecerem, pense neles como elementos de rastreabilidade e segurança, não como algo que você precisa programar para usar o painel.
O workspace define quem tem acesso.
O site define o domínio autorizado.
O banner define mensagem, regras e aparência.
A publicação cria uma versão ativa.
O snippet carrega essa versão no site.
Visitantes interagem com o banner.
Eventos viram logs, métricas e webhooks.
Entenda como o Permito funciona.
## Documentação para agentes
URL: https://permito.com.br/docs/documentacao-para-agentes
Use versões em texto da documentação do Permito para assistentes, agentes e ferramentas de leitura contextual.
O Permito publica versões em texto da documentação para facilitar leitura por assistentes, agentes e ferramentas que usam contexto externo.
| Arquivo | Para que serve | | ------------------------------ | --------------------------------------------------------------------------------- | | `/llms.txt` / `/docs/llms.txt` | Índice em texto com visão geral do produto e os principais links da documentação. |
| Arquivo | Para que serve | | ---------------------------------------- | ------------------------------------------------------------------------------- | | `/llms-full.txt` / `/docs/llms-full.txt` | Versão consolidada com o conteúdo completo de todas as páginas da documentação. |
Use esses arquivos quando uma ferramenta precisar entender como operar o Permito, encontrar páginas relevantes ou responder dúvidas com base na documentação pública.
Prefira `/docs/llms.txt` para descoberta rápida de páginas.
Use `/docs/llms-full.txt` quando a ferramenta precisar de contexto mais completo.
Sempre confirme ações importantes na interface do Permito antes de executá-las.
Volte para a página inicial da documentação.
## Aceitar convite
URL: https://permito.com.br/docs/equipes-e-permissoes/aceitar-convite
Entre em um workspace a partir de um link de convite.
Use o link de convite para entrar em um workspace do Permito.
Você precisa:
Ter recebido um link `/invite/[token]`.
Estar logado com o e-mail convidado ou criar conta com esse e-mail.
Usar o convite antes de expirar.
Abra o link do convite.
Verifique o nome do workspace.
Se não estiver logado, clique em **Entrar** ou **Criar conta**.
Após logar, volte ao convite.
Clique em **Aceitar convite**.
Confirme em **Aceitar e entrar**.
| Estado | O que significa | O que fazer | | -------- | ----------------------- | -------------- | | Pendente | Convite pode ser aceito | Entre e aceite |
| Estado | O que significa | O que fazer | | ------ | -------------------- | ------------------------------ | | Aceito | Convite já foi usado | Acesse o workspace normalmente |
| Estado | O que significa | O que fazer | | -------- | --------------- | ----------------- | | Expirado | Prazo terminou | Peça novo convite |
| Estado | O que significa | O que fazer | | -------- | --------------------- | ----------------- | | Revogado | Convite foi cancelado | Peça novo convite |
| Problema | Causa provável | Como resolver | | ---------------- | ----------------------------- | -------------- | | Convite inválido | Token inexistente ou removido | Peça novo link |
| Problema | Causa provável | Como resolver | | ---------------- | -------------- | ----------------- | | Convite expirado | Prazo acabou | Peça novo convite |
| Problema | Causa provável | Como resolver | | ------------- | -------------------------------- | ----------------------------------- | | E-mail errado | Você está logado com outra conta | Saia e entre com o e-mail convidado |
Depois de aceitar, comece por Navegação.
## Convidar usuários
URL: https://permito.com.br/docs/equipes-e-permissoes/convidar-usuarios
Convide uma pessoa para um workspace e escolha o perfil correto.
Convide pessoas para operar o Permito em conjunto dentro do workspace correto.
Você precisa de:
Perfil `owner` ou `admin`.
E-mail da pessoa.
Papel que será concedido.
Acesse **Configurações**.
Abra a aba **Membros**.
Informe o e-mail em **Adicionar usuário por email**.
Escolha a função.
Clique em **Convidar**.
| Papel | Indicado para | | ------------- | ------------------------------ | | Administrador | Pessoa que configura e publica |
| Papel | Indicado para | | ------- | ------------------------------------------- | | Usuário | Pessoa que edita draft e acompanha operação |
| Papel | Indicado para | | ------------ | ------------------------------ | | Visualizador | Pessoa que consulta sem editar |
Reserve o papel de responsável principal do workspace para quem já administra a conta.
Verifique se:
A mensagem de sucesso aparece.
O convite chega por e-mail.
A pessoa aceita o convite.
O usuário aparece na lista de membros.
| Problema | Causa provável | Como resolver | | ------------ | -------------------- | ----------------- | | E-mail vazio | Campo não preenchido | Informe um e-mail |
| Problema | Causa provável | Como resolver | | ------------- | ------------------------------- | ------------------------------- | | Sem permissão | Seu perfil não gerencia membros | Peça ajuda a `owner` ou `admin` |
| Problema | Causa provável | Como resolver | | -------------------------------- | ----------------- | ------------------------- | | Usuário já pertence ao workspace | Convite duplicado | Busque o usuário na lista |
Compartilhe com a pessoa a página Aceitar convite.
## Entender perfis
URL: https://permito.com.br/docs/equipes-e-permissoes/entender-perfis
Compare os perfis do workspace antes de convidar alguém.
Escolha o perfil pelo que a pessoa precisa fazer, não pelo cargo dela fora da plataforma.
| Necessidade | Perfil recomendado | | -------------------------------------------- | ------------------ | | Criar sites, publicar banner e exportar logs | `admin` |
| Necessidade | Perfil recomendado | | ---------------------------------------- | ------------------ | | Ser responsável principal pelo workspace | `owner` |
| Necessidade | Perfil recomendado | | ---------------------------------------- | ------------------ | | Editar textos e regras, mas não publicar | `user` |
| Necessidade | Perfil recomendado | | -------------------------- | ------------------ | | Consultar dashboard e logs | `viewer` |
| Necessidade | Perfil recomendado | | ---------------------------- | ------------------ | | Configurar webhooks e chaves | `admin` |
Use para a pessoa responsável pelo workspace. Esse perfil deve ser reservado para quem precisa controlar membros, configurações sensíveis e continuidade da conta.
Use para quem toca a operação: cria sites, publica alterações, exporta logs, gerencia webhooks, rotaciona chaves e convida usuários.
Use para quem edita draft e acompanha dados, mas não deve publicar nem exportar evidências.
Use para auditoria, leitura ou acompanhamento sem risco de alteração.
Se precisar retirar alguém, veja Remover acesso.
## Remover acesso
URL: https://permito.com.br/docs/equipes-e-permissoes/remover-acesso
Remova uma pessoa de um workspace quando ela não deve mais acessar a operação.
Remova membros que não fazem mais parte da equipe ou não precisam mais consultar dados do workspace.
Acesse **Configurações**.
Abra a aba **Membros**.
Localize o membro.
Clique em **Remover**.
Confirme a ação.
`owner` não pode ser removido pela lista de membros.
Você não pode remover a si mesmo.
Apenas `owner` e `admin` podem remover membros.
Veja Entender perfis.
## Equipes e permissões
URL: https://permito.com.br/docs/equipes-e-permissoes/visao-geral
Entenda como membros e papéis funcionam em um workspace.
Cada workspace tem sua própria lista de membros. O acesso é gerenciado em **Configurações → Membros**.
| Papel | O que pode fazer | | ------- | -------------------------------------------------------------------- | | `owner` | Gerencia workspace, membros, exclusão, sites, webhooks e exportações |
| Papel | O que pode fazer | | ------- | ----------------------------------------------- | | `admin` | Gerencia membros, sites, webhooks e exportações |
| Papel | O que pode fazer | | ------ | --------------------------------------------------- | | `user` | Edita configurações permitidas e acompanha operação |
| Papel | O que pode fazer | | -------- | -------------------------- | | `viewer` | Visualiza dados sem editar |
Convidar usuários
Entender perfis
Remover acesso
## Perguntas frequentes
URL: https://permito.com.br/docs/faq
Respostas rápidas para dúvidas comuns sobre o Permito.
Não. O Permito aceita o domínio raiz configurado e seus subdomínios. Outros domínios não devem operar com o mesmo site.
Quando o Permito recebe um primeiro evento válido do domínio autorizado.
A configuração atual trata categorias essenciais, Analytics e Marketing. Analytics e Marketing podem ter padrão inicial ligado ou desligado antes da publicação.
Não há um botão separado para salvar. Ao clicar em **Publicar**, o Permito salva as alterações internamente e torna a nova versão ativa para visitantes.
Somente `owner` e `admin`. A exportação gera auditoria no workspace.
Sim, se você for `owner` ou `admin` do workspace.
Sim. O workspace gratuito permite começar a usar o Permito dentro dos limites disponíveis. Para conferir capacidade, uso atual e opções pagas, abra **Planos**.
Abra **Planos** no menu lateral. A tela mostra o plano ativo, os limites disponíveis e o uso do mês para o workspace selecionado.
Abra **Planos** e siga a ação desejada. Quando necessário, o Permito envia você para o **Provedor de pagamentos** para concluir assinatura, atualização ou cancelamento.
`consent_created` e `consent_updated`.
Não. O gerador cria um ponto de partida. Revise com responsáveis legais antes de publicar.
Acesse Suporte.
## Auditar consentimentos
URL: https://permito.com.br/docs/fluxos/auditar-consentimentos
Use logs, filtros, versão de configuração e exportação CSV para revisar evidências.
Use este fluxo para encontrar registros de consentimento e preparar evidências operacionais.
Você precisa de:
Site selecionado.
Período aproximado da análise.
Host ou ação, se quiser filtrar.
Permissão de `owner` ou `admin` se precisar exportar CSV.
Acesse **Logs de consentimento**.
Selecione o site.
Defina data inicial e final.
Informe **Host**, se necessário.
Escolha a ação ou mantenha **Todas as ações**.
Clique em **Aplicar**.
Confira:
**Timestamp** do evento.
**Host** onde o evento aconteceu.
**Visitor** pseudônimo.
**Action** registrada.
Estado de **Essential**, **Analytics** e **Marketing**.
**Config** da versão publicada.
Acesse **Dashboard**.
Selecione o mesmo site.
Use o mesmo recorte aproximado.
Compare page views, decisões totais e taxas.
Volte para **Logs de consentimento**.
Mantenha filtros aplicados.
Clique em **Exportar CSV**.
A exportação fica registrada no workspace.
Você concluiu a auditoria quando:
Os registros encontrados correspondem ao período e host esperados.
A versão de configuração está visível.
O CSV foi gerado quando necessário.
As métricas agregadas são coerentes com os logs.
Peça suporte se:
Logs esperados não aparecem mesmo com filtros amplos.
Há eventos de host não reconhecido.
Exportação falha mesmo com perfil `owner` ou `admin`.
Veja Campos importantes para interpretar cada coluna.
## Configurar CMP de um site
URL: https://permito.com.br/docs/fluxos/configurar-cmp-de-um-site
Siga o passo a passo para criar, configurar, publicar e validar o CMP em um domínio.
Este fluxo leva você de um domínio novo até um CMP em operação com banner publicado e eventos chegando ao Permito.
Este guia é para responsáveis por publicar consentimento em um site da empresa, cliente ou projeto.
Confirme que você tem:
Workspace ativo.
Permissão de `owner` ou `admin`.
Domínio raiz correto.
Acesso para instalar script no site.
Links legais revisados.
Criar site.
Configurar textos.
Configurar regras.
Ajustar design.
Publicar.
Instalar snippet.
Validar eventos.
Acesse **Sites**.
Clique em **Novo site**.
Informe nome, domínio raiz e idioma.
Clique em **Criar**.
Na tela do site:
Abra **Conteudo & textos**.
Revise título, descrição e botões.
Adicione links de privacidade e cookies.
Abra **Regras**.
Defina padrões para Analytics e Marketing.
Abra **Design & preview**.
Ajuste posição, tema, lado e cores.
Revise a prévia.
Clique em **Publicar**.
Aguarde a mensagem de sucesso.
Abra **Instalação**.
Clique em **Copiar snippet**.
Cole no `` do site.
Publique o site.
Acesse o domínio autorizado.
Faça uma escolha no banner.
Verifique **Dashboard** e **Logs de consentimento**.
Você concluiu o fluxo quando:
Site está **Ativo**.
Site aparece como **Verified**.
Versão publicada aparece no detalhe do site.
Dashboard mostra page views.
Logs mostram pelo menos uma decisão.
| Problema | Causa provável | Como resolver | | ---------------------------- | ----------------------------------------- | ------------------------------ | | Site continua **Unverified** | Snippet não executou no domínio permitido | Verifique instalação e domínio |
| Problema | Causa provável | Como resolver | | --------------------- | ------------------------------ | ---------------------- | | Banner antigo aparece | Configuração não foi publicada | Clique em **Publicar** |
| Problema | Causa provável | Como resolver | | ------------------ | -------------------- | -------------- | | Eventos bloqueados | Site está desativado | Reative o site |
Depois de operar o primeiro site, configure webhooks ou publique políticas.
## Configurar webhooks
URL: https://permito.com.br/docs/fluxos/configurar-webhooks
Envie eventos de consentimento para outro sistema com assinatura HMAC.
Use webhooks quando outro sistema precisa receber eventos `consent.created` e `consent.updated`.
Você precisa de:
Permissão `owner` ou `admin`.
URL HTTPS do sistema de destino.
Secret HMAC compartilhado com esse sistema.
Acesse **Sites**.
Abra o site.
Clique em **Webhooks**.
Clique em **Novo webhook**.
Informe a URL.
Informe o secret HMAC.
Clique em **Criar webhook**.
Na lista de webhooks, abra um endpoint para ver:
entregas por período;
status `pending`, `success` e `failed`;
tentativas;
resposta HTTP;
último erro registrado.
Use HTTPS.
Valide a assinatura HMAC antes de processar o payload.
Responda `2xx` somente após processar o evento.
Monitore falhas recorrentes no detalhe do endpoint.
Veja Observabilidade de webhooks.
## Publicar alterações do banner
URL: https://permito.com.br/docs/fluxos/publicar-alteracoes-do-banner
Atualize texto, regras ou aparência do banner sem perder rastreabilidade por versão.
Use este fluxo sempre que precisar mudar a mensagem, categorias, links legais ou visual do banner.
Confirme que:
Você abriu o site correto.
Os links legais estão prontos.
Você tem permissão para editar a configuração.
Um `owner` ou `admin` está disponível para publicar, se você for `user`.
Acesse **Sites**.
Abra o site.
Edite uma ou mais abas:
**Conteudo & textos**.
**Regras**.
**Design & preview**.
Use o preview para revisar o banner.
Confira:
Título e texto do banner.
Rótulos dos botões.
URLs de privacidade e cookies.
Padrão de Analytics e Marketing.
Posição e cores.
Impacto esperado para visitantes.
Clique em **Publicar**.
Aguarde a mensagem de sucesso.
Verifique se a versão publicada foi atualizada.
Você publicou corretamente quando:
A tela mostra nova versão publicada.
O site instalado passa a carregar a nova configuração.
Novos logs registram a nova versão da configuração.
Evite publicar mudanças sem revisar links legais.
Faça alterações em pequenas etapas quando houver risco.
Use logs para confirmar a versão registrada após a publicação.
Veja Auditar consentimentos para validar os registros após a mudança.
## Publicar políticas
URL: https://permito.com.br/docs/fluxos/publicar-politicas
Gere, revise e publique políticas de cookies, privacidade ou termos para um site.
Use políticas quando precisar disponibilizar documentos legais com link público estável.
Você precisa de:
Site criado.
Permissão diferente de `viewer`.
Nome da empresa.
E-mail de contato.
País de operação.
Revisão humana do conteúdo antes da publicação.
O gerador cria um documento inicial. Revise o conteúdo com a equipe responsável antes de publicar ou usar em produção.
Abra **Sites**.
Selecione o site.
Clique em **Políticas (beta)**.
Clique em **Nova política**.
Escolha **Cookies**, **Privacidade** ou **Termos**.
Preencha empresa, e-mail, país e observações.
Clique em **Criar**.
Edite o título.
Edite o conteúdo em **Markdown**.
Revise a **Visualização segura**.
Clique em **Salvar**.
Clique em **Publicar**.
Aguarde a mensagem de sucesso.
Copie a URL pública.
Use o link no site ou nos campos legais do banner.
Você concluiu quando:
A política aparece como **Publicado**.
A URL pública abre o documento.
O histórico mostra versão publicada.
O link pode ser usado no banner.
| Problema | Causa provável | Como resolver | | ------------------------ | --------------- | -------------------- | | Botão criar desabilitado | Perfil `viewer` | Peça permissão maior |
| Problema | Causa provável | Como resolver | | -------------------- | ----------------------------------- | ------------------------------------------- | | Publicação bloqueada | Salvamento falhou antes de publicar | Corrija o conteúdo e tente salvar novamente |
| Problema | Causa provável | Como resolver | | ---------------------------- | ----------------------------------- | ---------------------------------- | | Documento errado para o site | Política não pertence ao site atual | Volte para a lista do site correto |
Depois de publicar, atualize os links legais em Publicar alterações do banner.
## Configurações e perfil
URL: https://permito.com.br/docs/guia-da-plataforma/configuracoes-e-perfil
Entenda as telas de Configurações, API Access e Perfil.
Use estas telas para revisar dados do workspace ativo, abrir gestão de membros, criar chaves de leitura e atualizar sua conta.
Onde encontrar:
A tela mostra:
| Área | O que mostra | Ação disponível | | ------------- | ------------------------------------------ | --------------- | | **Workspace** | Nome, slug, membros, criação e atualização | **Editar** |
| Área | O que mostra | Ação disponível | | ----------- | ----------------------------- | ------------------- | | **Membros** | Atalho para gestão de membros | **Abrir workspace** |
| Área | O que mostra | Ação disponível | | -------------- | ----------------------------- | -------------------- | | **API Access** | Atalho para chaves de leitura | **Abrir API Access** |
Onde encontrar:
Use esta tela quando sua equipe precisa conectar outro sistema aos dados do workspace.
Você pode:
Criar nova chave de leitura.
Copiar a chave no momento da criação.
Ver prefixo e última atividade.
Rotacionar uma chave.
Revogar uma chave.
A chave completa aparece somente no momento da criação ou rotação. Depois disso, a tela mostra apenas o prefixo.
Onde encontrar:
Use o perfil para:
Ver resumo da conta.
Atualizar nome.
Atualizar e-mail.
Definir nova senha.
Verifique se:
Configurações mostram o workspace correto.
Chaves criadas aparecem como **Ativa**.
Chaves revogadas aparecem como **Revogada**.
Perfil mostra a mensagem **Perfil atualizado com sucesso** após salvar.
Para permissões de equipe, veja Equipes e permissões.
## Detalhes do site
URL: https://permito.com.br/docs/guia-da-plataforma/detalhes-do-site
Entenda a tela de configuração do banner e instalação do snippet de um site.
A tela de detalhe do site concentra configuração do banner, publicação e instalação do snippet.
Rota:
| Área | O que mostra | Como usar | | ------- | -------------------- | --------------------------------- | | Domínio | Domínio raiz do site | Confirme que abriu o site correto |
| Área | O que mostra | Como usar | | ---------------- | ---------------------------- | ------------------------------ | | Versão publicada | Versão ativa da configuração | Use para auditoria e validação |
| Área | O que mostra | Como usar | | -------------------- | --------------------------------- | --------------------------------- | | **Políticas (beta)** | Abre políticas vinculadas ao site | Crie e publique documentos legais |
| Área | O que mostra | Como usar | | ------------ | ------------------------------------- | ----------------- | | **Webhooks** | Abre endpoints e entregas de webhooks | Investigue falhas |
| Área | O que mostra | Como usar | | ------------ | ------------------------------------------------------------- | ---------------------------- | | **Publicar** | Salva internamente as alterações e torna a configuração ativa | Restrito a `owner` e `admin` |
| Área | O que mostra | Como usar | | -------------------------------- | ------------------------------ | ---------------------------- | | **Desativar site/Reativar site** | Bloqueia ou libera CMP público | Restrito a `owner` e `admin` |
| Aba | Para que serve | | --------------------- | ----------------------------------------------- | | **Conteúdo & textos** | Editar título, descrição, botões e links legais |
| Aba | Para que serve | | ---------- | ------------------------------------------ | | **Regras** | Configurar padrão de Analytics e Marketing |
| Aba | Para que serve | | -------------------- | --------------------------------------------- | | **Design & preview** | Ajustar posição, tema, lado e cores do banner |
| Aba | Para que serve | | -------------- | -------------------------------------------- | | **Instalação** | Copiar snippet e rotacionar o código do site |
| Campo | O que significa | Dica | | -------------------- | --------------------------- | ------------------- | | **Título do banner** | Título que o visitante verá | Seja claro e direto |
| Campo | O que significa | Dica | | -------------------- | ---------------------------- | ---------------------------------- | | **Texto descritivo** | Explicação do uso de cookies | Evite linguagem jurídica excessiva |
| Campo | O que significa | Dica | | ------------------------------- | ----------------------------- | ------------------------ | | **URL política de privacidade** | Link legal mostrado no banner | Use URL pública e válida |
| Campo | O que significa | Dica | | --------------------------- | --------------------------- | ------------------------------------------ | | **URL política de cookies** | Link da política de cookies | Pode ser uma política publicada no Permito |
| Campo | O que significa | Dica | | --------------------- | ------------------------------------ | -------------------------------- | | **Analytics default** | Estado padrão da categoria Analytics | Normalmente desligado por padrão |
| Campo | O que significa | Dica | | --------------------- | ------------------------------------ | -------------------------------- | | **Marketing default** | Estado padrão da categoria Marketing | Normalmente desligado por padrão |
| Campo | O que significa | Dica | | ----------- | --------------- | ------------------------------------------ | | **Posição** | Local do banner | Escolha o formato menos intrusivo possível |
| Campo | O que significa | Dica | | ------------------ | ------------------------- | ------------------------------------- | | **Código do site** | Código usado pelo snippet | Rotacionar exige reinstalar o snippet |
Verifique se:
A publicação mostra sucesso.
A versão publicada foi atualizada.
O preview reflete os textos e cores esperados.
O snippet está disponível para cópia.
Siga o fluxo Publicar alterações do banner.
## Logs de consentimento
URL: https://permito.com.br/docs/guia-da-plataforma/logs-de-consentimento
Consulte registros auditáveis de escolhas de visitantes por site, período, host e ação.
Use **Logs de consentimento** para consultar decisões registradas pelo CMP e validar evidências por visitante, host e versão de configuração.
Rota:
Você precisa selecionar um site. A tela busca logs do site ativo e permite filtros por data, host e ação.
| Filtro | Para que serve | | ------------ | -------------------------- | | Data inicial | Define o começo do período |
| Filtro | Para que serve | | ---------- | ----------------------- | | Data final | Define o fim do período |
| Filtro | Para que serve | | ------ | -------------------------------- | | Host | Filtra por domínio ou subdomínio |
| Filtro | Para que serve | | ------ | ----------------------------------------------------------------- | | Ação | Filtra por aceitar, recusar, personalizar ou reabrir preferências |
| Coluna | O que significa | | ------------- | --------------------- | | **Timestamp** | Data e hora do evento |
| Coluna | O que significa | | -------- | ------------------------------- | | **Host** | Domínio onde o evento aconteceu |
| Coluna | O que significa | | ----------- | ------------------------------------- | | **Visitor** | Identificador pseudônimo do visitante |
| Coluna | O que significa | | ---------- | ----------------------- | | **Action** | Tipo de decisão ou ação |
| Coluna | O que significa | | --------- | ------------------------------------------------------ | | **State** | Estado das categorias Essential, Analytics e Marketing |
| Coluna | O que significa | | ---------- | -------------------------------- | | **Config** | Versão da configuração do banner |
Selecione o site.
Ajuste os filtros.
Clique em **Aplicar**.
Clique em **Exportar CSV**.
Somente `owner` e `admin` podem exportar. A exportação gera registro de auditoria no workspace.
Verifique se:
A tabela mostra registros dentro do período escolhido.
O `host` corresponde ao domínio esperado.
O `State` reflete a escolha feita pelo visitante.
A `Config` corresponde à versão publicada no momento da decisão.
Para interpretar métricas agregadas, volte ao Painel principal.
## Navegação
URL: https://permito.com.br/docs/guia-da-plataforma/navegacao
Conheça o menu lateral, troca de workspace, idioma, tema e perfil.
O menu lateral concentra as áreas operacionais do Permito e acompanha você nas telas autenticadas.
| Item | Para que serve | | ------------- | --------------------------------------------- | | **Dashboard** | Acompanhar métricas consolidadas do workspace |
| Item | Para que serve | | --------- | ------------------------------------------------- | | **Sites** | Criar sites, configurar banner e instalar snippet |
| Item | Para que serve | | ------------------------- | ----------------------------------------------- | | **Logs de consentimento** | Consultar e exportar registros de consentimento |
| Item | Para que serve | | ------------- | --------------------------- | | **Políticas** | Gerenciar documentos legais |
| Item | Para que serve | | ---------- | ------------------------------------------------- | | **Planos** | Consultar plano, limites, uso do mês e assinatura |
| Item | Para que serve | | ----------------- | ----------------------------------------- | | **Configurações** | Gerenciar workspace, membros e API Access |
Use o seletor no topo do menu lateral para alterar o workspace ativo. Ao trocar, as telas passam a mostrar os dados do workspace selecionado.
Para criar outro workspace, abra o mesmo seletor e clique em **Novo workspace**.
No rodapé do menu lateral existem botões para:
Alternar idioma entre **PT** e **EN**.
Alternar tema entre **light**, **dark** e **system**.
No rodapé do menu lateral, você encontra:
Atalho para **Perfil**.
Botão de **Sair**.
Nome ou e-mail do usuário logado.
| Estado | O que significa | O que fazer | | ------------------- | --------------------------- | ------------------------------ | | Tela pede workspace | Nenhum workspace está ativo | Selecione ou crie um workspace |
| Estado | O que significa | O que fazer | | ----------------- | --------------------------------------- | -------------------------------- | | Item indisponível | Permissão insuficiente para aquela ação | Peça ajuste a `owner` ou `admin` |
Conheça a tela de Sites.
## Painel principal
URL: https://permito.com.br/docs/guia-da-plataforma/painel-principal
Entenda o Dashboard do Permito e como acompanhar métricas de consentimento.
Use o **Dashboard** para acompanhar volume de page views, decisões e taxas de consentimento do workspace ativo.
Rota:
| Área | O que mostra | Como usar | | ------- | ----------------------- | --------------------------- | | Período | Início e fim da análise | Ajuste a janela de métricas |
| Área | O que mostra | Como usar | | ----- | -------------------------------------- | ------------------------------------- | | Sites | Todos os sites ou seleção por checkbox | Restrinja a análise quando necessário |
| Área | O que mostra | Como usar | | ---- | ---------------------------- | ---------------------------------------------- | | KPIs | Page views, decisões e taxas | Avalie adoção e comportamento de consentimento |
| Área | O que mostra | Como usar | | ------- | ------------------------------ | ----------------------------------- | | Gráfico | Série de page views e decisões | Compare atividade ao longo do tempo |
| Área | O que mostra | Como usar | | ------------------ | ------------------------------------------- | ----------------------------------- | | Resumo de escolhas | Aceitar tudo, recusar tudo e personalizados | Entenda a distribuição das decisões |
| Métrica | Significado | | -------------- | ------------------------------------------------ | | **Page views** | Quantidade de visualizações registradas pelo CMP |
| Métrica | Significado | | ------------------- | --------------------------------------------- | | **Decisões totais** | Soma de aceitações, recusas e personalizações |
| Métrica | Significado | | ------------------------------ | ----------------------------------- | | **Cobertura de consentimento** | Relação entre decisões e page views |
| Métrica | Significado | | ------------------- | --------------------------------------- | | **Acceptance rate** | Percentual de decisões com aceite total |
| Métrica | Significado | | --------------- | --------------------------------------- | | **Reject rate** | Percentual de decisões com recusa total |
| Métrica | Significado | | ------------------ | ------------------------------------- | | **Customize rate** | Percentual de decisões personalizadas |
| Ação | Para que serve | Quem pode usar | | --------------- | ---------------------------------- | -------------- | | Alterar período | Ver dados em outra janela de tempo | Todos |
| Ação | Para que serve | Quem pode usar | | ------------- | ----------------------------------- | --------------------------------------- | | Filtrar sites | Ver todos os sites ou apenas alguns | Todos os perfis com acesso ao workspace |
| Ação | Para que serve | Quem pode usar | | ----------------------- | ----------------------------------- | ------------------------------------------ | | Exportar CSV do gráfico | Baixar a série exibida no dashboard | Usuários que conseguem acessar o dashboard |
| Ação | Para que serve | Quem pode usar | | ------------------------ | ------------------------------------- | -------------- | | Ocultar série no gráfico | Comparar só page views ou só decisões | Todos |
Verifique se:
O período está correto.
O filtro de sites mostra todos os sites ou a seleção desejada.
Os cards mostram números ou `0`, não erro de carregamento.
O gráfico carrega quando há eventos.
As taxas fazem sentido para o período escolhido.
Para investigar decisões individuais, acesse Logs de consentimento.
## Políticas
URL: https://permito.com.br/docs/guia-da-plataforma/politicas
Entenda como encontrar, gerar, editar, pré-visualizar e publicar políticas por site.
As políticas ficam dentro de cada site e ajudam a publicar documentos legais com URL pública estável.
Rotas:
| Área | O que mostra | Como usar | | --------- | -------------------------------------- | -------------------------------------- | | Cabeçalho | Nome do site e botão **Nova política** | Crie documentos quando tiver permissão |
| Área | O que mostra | Como usar | | ----- | ------------------------------------ | ------------------------------ | | Busca | Campo para buscar por título ou tipo | Encontre documentos existentes |
| Área | O que mostra | Como usar | | ----- | ----------------------------- | ----------------------------- | | Lista | Título, tipo, versão e status | Abra uma política para editar |
Clique em **Nova política**.
Escolha o **Tipo de política**:
**Cookies**.
**Privacidade**.
**Termos**.
Preencha **Nome da empresa**.
Preencha **contato@empresa.com**.
Revise **País**.
Adicione observações extras, se necessário.
Clique em **Criar**.
Abra a política.
Edite o **Título**.
Edite o conteúdo em **Markdown**.
Revise a **Visualização segura**.
Clique em **Salvar**.
Clique em **Publicar**.
A tela de detalhe mostra:
URL pública em `/policies/public/[slug]`.
Botão para copiar o link.
Botão **Histórico** com versões anteriores.
Status **draft** ou **publicada**.
Veja o fluxo Publicar políticas.
## Sites
URL: https://permito.com.br/docs/guia-da-plataforma/sites
Entenda a lista de sites e como encontrar, filtrar, criar e abrir um domínio cadastrado.
Use **Sites** para gerenciar os domínios que terão banner de consentimento.
Rota:
| Área | O que mostra | Como usar | | --------- | -------------------------------------- | -------------------------------------- | | Cabeçalho | Título **Sites** e botão **Novo site** | Crie um domínio quando tiver permissão |
| Área | O que mostra | Como usar | | ----- | --------------------------------------- | -------------------------- | | Busca | Campo **Buscar por nome ou domínio...** | Encontre sites rapidamente |
| Área | O que mostra | Como usar | | ------------------ | -------------------------------------- | ----------------------------- | | Filtro de exibição | **Todos**, **Ativos**, **Desativados** | Controle quais sites aparecem |
| Área | O que mostra | Como usar | | -------------- | ------------------------------------------- | ---------------------------------- | | Lista de sites | Nome, domínio, versão, status e verificação | Clique no site para abrir detalhes |
| Ação | Para que serve | Quem pode usar | | ------------- | ---------------------- | ---------------- | | **Novo site** | Cadastrar novo domínio | `owner`, `admin` |
| Ação | Para que serve | Quem pode usar | | ------ | --------------------------- | -------------- | | Buscar | Filtrar por nome ou domínio | Todos |
| Ação | Para que serve | Quem pode usar | | -------------- | -------------------------------- | -------------- | | Filtrar status | Ver ativos, desativados ou todos | Todos |
| Ação | Para que serve | Quem pode usar | | ---------- | ------------------------------ | ----------------------------- | | Abrir site | Acessar configuração do banner | Todos com acesso ao workspace |
| Status | O que significa | | ------------ | ------------------------------------------ | | **Verified** | O site já recebeu evento válido do snippet |
| Status | O que significa | | -------------- | -------------------------------------- | | **Unverified** | O site ainda não recebeu evento válido |
| Status | O que significa | | --------- | ----------------------- | | **Ativo** | CMP público pode operar |
| Status | O que significa | | -------------- | --------------------------------------------- | | **Desativado** | CMP público fica bloqueado para novos eventos |
| Estado | O que significa | O que fazer | | ---------- | -------------------------- | ----------------------- | | Carregando | Sites estão sendo buscados | Aguarde alguns segundos |
| Estado | O que significa | O que fazer | | ------ | --------------------------------- | ------------------------------- | | Vazio | Nenhum site corresponde ao filtro | Altere o filtro ou crie um site |
| Estado | O que significa | O que fazer | | ------------------ | --------------------------------- | ------------------------------- | | Botão desabilitado | Você não tem permissão de criação | Peça ajuda a `owner` ou `admin` |
Abra Detalhes do site para configurar o banner.
## Documentação
URL: https://permito.com.br/docs
Aprenda a usar o Permito, configurar consentimento de cookies e acompanhar evidências com segurança.
O Permito ajuda sua equipe a publicar banner de consentimento por domínio, registrar escolhas de visitantes, manter trilha auditável e integrar eventos por webhook.
Se você está chegando agora, siga o fluxo de primeiros passos. Ele leva você da criação do workspace até o primeiro site publicado com snippet instalado.
Criar workspaces para separar operações, sites e membros.
Cadastrar sites por domínio raiz e controlar se o CMP está ativo.
Configurar textos, categorias, estilo e links legais do banner.
Publicar versões da configuração do banner.
Instalar um snippet no site para carregar o CMP público.
Acompanhar page views, decisões, taxa de aceite, recusa e personalização.
Consultar e exportar logs de consentimento.
Consultar plano, limites e uso do workspace.
Criar políticas de cookies, privacidade e termos com URL pública estável.
Enviar eventos `consent_created` e `consent_updated` para sistemas externos via webhooks.
Gerenciar membros, convites, permissões e chaves de leitura do workspace.
Esta documentação foi criada para usuários que precisam operar o Permito no dia a dia, mesmo sem experiência prévia com CMP, cookies, webhooks ou auditoria de consentimento.
Acesse a plataforma.
Crie ou selecione um workspace.
Crie seu primeiro site.
Configure e publique o banner.
Instale o snippet.
Acompanhe os primeiros eventos.
Verifique plano e limites.
Comece pela visão geral dos primeiros passos.
## Código do site
URL: https://permito.com.br/docs/integracoes/api-do-site
Entenda o código associado ao snippet de um site e quando rotacioná-lo.
O código do site fica associado ao snippet instalado no domínio. Ele não deve ser tratado como uma tela operacional de consulta de segredo.
Prefixo atual do código.
Botão **Rotacionar código**.
Confirmação avisando que será necessário reinstalar o snippet.
Rotacione quando:
O snippet atual pode ter sido exposto.
Uma integração será migrada.
Existe rotina de segurança periódica.
Você precisa invalidar instalações antigas.
Verifique se:
O prefixo atual mudou.
O snippet foi copiado novamente.
O snippet atualizado foi reinstalado no site.
Veja Chaves e API Access.
## Chaves de leitura
URL: https://permito.com.br/docs/integracoes/chaves-de-leitura
Crie e gerencie chaves de leitura do workspace para integrações internas.
Chaves de leitura ficam em **API Access** e são usadas por integrações internas que precisam acessar dados do workspace.
Informe um nome em **Nome da chave (opcional)**.
Clique em **Gerar chave**.
Copie a chave exibida.
Salve em local seguro.
| Ação | Resultado | | -------------- | -------------------------------------- | | **Rotacionar** | Gera nova chave e mostra uma única vez |
| Ação | Resultado | | ----------- | ---------------- | | **Revogar** | Invalida a chave |
Verifique se:
A chave aparece na tabela.
O status é **Ativa**.
O prefixo aparece.
A última atividade aparece após uso pela integração.
Leia Rotacionar chaves.
## Snippet CMP
URL: https://permito.com.br/docs/integracoes/snippet-cmp
Instale o snippet no site para carregar o banner e registrar eventos.
O snippet é o código que conecta seu domínio ao CMP público do Permito.
Use o snippet para:
Mostrar o banner de consentimento.
Carregar a configuração publicada.
Registrar page views e decisões.
Marcar o site como **Verified** após evento válido.
Acesse **Sites**.
Abra o site.
Vá para **Instalação**.
Clique em **Copiar snippet**.
Cole no `` do site.
Publique o site.
O snippet só deve funcionar para:
Domínio raiz cadastrado.
Subdomínios do domínio raiz.
Se o domínio não for permitido, eventos públicos podem ser recusados.
Verifique se:
O banner aparece.
O site está **Verified**.
O último host visto aparece no detalhe do site.
O dashboard mostra page views.
Depois da instalação, configure webhooks se precisar sincronizar eventos.
## Visão geral de integrações
URL: https://permito.com.br/docs/integracoes/visao-geral
Entenda onde configurar snippet, código do site, webhooks e chaves de leitura.
As integrações do Permito conectam o banner, os logs e eventos de consentimento aos sistemas da sua equipe.
| Integração | Onde fica | Para que serve | | ----------- | ------------------------------- | ------------------------------------ | | Snippet CMP | **Sites → [site] → Instalação** | Carregar banner e eventos no domínio |
| Integração | Onde fica | Para que serve | | -------------- | ------------------------------- | -------------------------------------- | | Código do site | **Sites → [site] → Instalação** | Rotacionar o código usado pelo snippet |
| Integração | Onde fica | Para que serve | | ---------- | ----------------------------- | ------------------------------- | | Webhooks | **Sites → [site] → Webhooks** | Enviar eventos de consentimento |
| Integração | Onde fica | Para que serve | | ----------------- | ------------------------------ | ------------------------------------ | | Chaves de leitura | **Configurações → Acesso API** | Consultar dados do workspace via API |
Crie o site.
Copie e instale o snippet.
Publique a configuração do banner.
Configure webhooks se outro sistema precisa receber eventos.
Crie chaves de leitura apenas para integrações internas autorizadas.
Veja Snippet CMP.
## Webhooks
URL: https://permito.com.br/docs/integracoes/webhooks
Configure endpoints para receber eventos de consentimento em outro sistema.
Webhooks enviam eventos do Permito para uma URL de outro sistema da sua equipe.
Use webhooks para:
Atualizar um CRM ou data warehouse.
Registrar consentimento em outro sistema da empresa.
Acionar automações após consentimento.
Auditar mudanças em tempo quase real.
Você precisa de:
URL HTTPS preparada pelo sistema de destino.
Segredo compartilhado para proteger a integração.
Permissão `owner` ou `admin`.
Alinhamento com a pessoa responsável pelo sistema que vai receber os eventos.
Acesse **Sites**.
Abra o site.
Clique em **Webhooks**.
Clique em **Novo webhook**.
Informe URL e secret HMAC.
Clique em **Criar webhook**.
Abra **Sites → [site] → Webhooks**.
Revise endpoints ativos, sucessos, falhas e backlog.
Abra um endpoint para ver entregas, respostas HTTP e erros.
Corrija o sistema de destino se houver falhas recorrentes.
Guarde o segredo compartilhado em local seguro.
Combine com a equipe técnica como a assinatura HMAC será validada.
Responda com sucesso somente quando o sistema de destino processar o evento corretamente.
Monitore status `failed`.
Veja Configurar webhooks.
## Chaves e API Access
URL: https://permito.com.br/docs/modulos/chaves-de-api
Entenda quais credenciais existem e onde gerenciá-las.
O Permito separa o código usado pelo snippet do site das chaves de leitura usadas por integrações internas.
| Tipo | Onde fica | Uso | | -------------- | ------------------------------- | ----------------------------------------- | | Código do site | **Sites → [site] → Instalação** | Identifica o snippet instalado no domínio |
| Tipo | Onde fica | Uso | | ---------------- | ------------------------------ | ----------------------------------- | | Chave de leitura | **Configurações → Acesso API** | Consulta dados do workspace via API |
Rotacione credenciais quando houver suspeita de exposição.
Copie chaves de leitura no momento da criação ou rotação.
Não compartilhe secrets de webhook ou chaves de leitura em canais públicos.
Veja Rotacionar chaves.
## Dashboard
URL: https://permito.com.br/docs/modulos/dashboard
Use o Dashboard para monitorar métricas consolidadas do workspace por período e sites selecionados.
O Dashboard mostra a saúde operacional do consentimento no workspace ativo. Por padrão, ele consolida todos os sites.
Filtrar por período.
Ver métricas de todos os sites ou de um conjunto específico.
Comparar page views e decisões de consentimento.
Exportar a série do gráfico em CSV.
Identificar padrões de aceite, recusa e personalização.
Use o botão **Sites** no topo do Dashboard para abrir o filtro avançado.
**Todos os sites** é o padrão.
Você pode marcar um ou mais sites.
Se nenhum site for selecionado, o Dashboard volta para todos.
| Métrica | Como usar | | ---------- | ---------------------------------------------- | | Page views | Confirme se o snippet está registrando visitas |
| Métrica | Como usar | | --------------- | ---------------------------- | | Decisões totais | Acompanhe volume de escolhas |
| Métrica | Como usar | | -------------------------- | ---------------------------------- | | Cobertura de consentimento | Compare decisões com visualizações |
| Métrica | Como usar | | --------------- | ---------------------- | | Acceptance rate | Avalie aceitação total |
| Métrica | Como usar | | ----------- | ---------------- | | Reject rate | Monitore recusas |
| Métrica | Como usar | | -------------- | -------------------------------------------- | | Customize rate | Veja quantos visitantes ajustam preferências |
Escolha o período.
Abra **Sites** se quiser restringir a análise.
Revise KPIs.
Compare a série do gráfico.
Use logs para investigar eventos individuais.
Compare períodos antes e depois de publicar mudanças no banner.
Use filtros de site quando precisar isolar um domínio.
Não avalie performance apenas por um único dia com baixo tráfego.
Veja Logs de consentimento.
## Logs de consentimento
URL: https://permito.com.br/docs/modulos/logs-de-consentimento
Use logs para consultar evidências auditáveis de consentimento no workspace ativo.
Logs de consentimento registram decisões de visitantes por site, host, visitante, estado e versão de configuração.
Por padrão, a tela mostra todos os sites do workspace ativo. Você pode restringir a consulta pelo filtro **Sites**.
Filtrar por período.
Filtrar por um ou mais sites.
Filtrar por host.
Filtrar por ação.
Ver estado de categorias.
Ver versão da configuração.
Exportar CSV com permissão adequada.
Use logs quando precisar:
Provar que uma escolha foi registrada.
Investigar comportamento de um domínio.
Validar nova publicação do banner.
Preparar uma conferência de consentimentos.
Conferir se eventos estão chegando.
| Perfil | Acesso | | ------- | -------------- | | `owner` | Ver e exportar |
| Perfil | Acesso | | ------- | -------------- | | `admin` | Ver e exportar |
| Perfil | Acesso | | ------ | ------ | | `user` | Ver |
| Perfil | Acesso | | -------- | ------ | | `viewer` | Ver |
Comece com um período amplo se não encontrar resultados.
Use o filtro de site para separar domínios.
Use host para diferenciar subdomínios.
Compare a versão do log com a versão publicada do site.
Exporte CSV somente quando necessário.
Veja Auditar consentimentos.
## Políticas
URL: https://permito.com.br/docs/modulos/politicas
Crie, edite, visualize e publique políticas públicas vinculadas a sites.
O módulo de políticas ajuda a criar documentos de cookies, privacidade e termos com histórico de versões.
Gerar documento inicial.
Editar conteúdo em Markdown.
Ver prévia segura.
Salvar alterações.
Publicar uma versão.
Copiar URL pública.
Consultar histórico.
| Tipo | Uso | | ------- | ------------------------------------ | | Cookies | Explicar uso de cookies e categorias |
| Tipo | Uso | | ----------- | ------------------------------------- | | Privacidade | Explicar tratamento de dados pessoais |
| Tipo | Uso | | ------ | ---------------------- | | Termos | Explicar regras de uso |
| Perfil | O que pode fazer | | ------------------------ | ---------------------------------- | | `owner`, `admin`, `user` | Criar, editar e publicar políticas |
| Perfil | O que pode fazer | | -------- | --------------------------- | | `viewer` | Visualizar lista e conteúdo |
Revise todo conteúdo antes de publicar.
Use o histórico para acompanhar mudanças.
Use a URL pública nos links legais do banner.
Não trate o documento gerado como aconselhamento jurídico final.
Siga Publicar políticas.
## Sites
URL: https://permito.com.br/docs/modulos/sites
Entenda o módulo de sites para configurar domínios, banner, snippet e integrações.
Sites são os domínios onde o CMP do Permito será instalado.
Cadastrar domínio raiz.
Ver status **Verified/Unverified**.
Ativar ou desativar operação pública.
Editar draft do banner.
Publicar configuração.
Copiar snippet.
Rotacionar a chave do site.
Criar webhooks.
Abrir políticas do site.
Use o módulo **Sites** quando precisar:
Instalar CMP em um novo domínio.
Alterar textos ou design do banner.
Publicar nova versão da configuração.
Bloquear temporariamente a coleta pública.
Integrar consentimento com sistemas externos.
| Ação | Resultado | | ------------- | ---------------------------------------------- | | **Novo site** | Cria cadastro com domínio raiz e chave pública |
| Ação | Resultado | | ------------ | ----------------------------------------------------------------------- | | **Publicar** | Salva internamente as alterações e ativa a configuração para visitantes |
| Ação | Resultado | | ------------------ | ---------------------------------------- | | **Desativar site** | Bloqueia snippet/config/eventos públicos |
| Ação | Resultado | | ------------------ | ---------------------------------- | | **Copiar snippet** | Copia código para instalar no site |
| Ação | Resultado | | --------------------- | ------------------------------ | | **Adicionar webhook** | Registra uma URL de integração |
| Perfil | O que pode fazer | | ----------------- | ---------------------------------------------------- | | `owner` e `admin` | Criar, publicar, ativar/desativar, webhooks e chaves |
| Perfil | O que pode fazer | | ------ | ------------------------------- | | `user` | Editar draft e visualizar dados |
| Perfil | O que pode fazer | | -------- | ---------------- | | `viewer` | Visualizar dados |
| Erro | Como resolver | | -------------- | ----------------------------------------- | | Site duplicado | Use o cadastro existente ou outro domínio |
| Erro | Como resolver | | ------------------------ | ------------------------------ | | Sem permissão para criar | Peça acesso `owner` ou `admin` |
| Erro | Como resolver | | -------------------------- | -------------------------------- | | Site desativado não coleta | Reative antes de validar eventos |
Siga Criar site.
## Webhooks
URL: https://permito.com.br/docs/modulos/webhooks
Gerencie endpoints e acompanhe entregas de eventos.
Webhooks enviam eventos de consentimento para outros sistemas.
| Tela | Rota | Para que serve | | ----------------- | -------------------------- | ------------------------------------- | | Lista de webhooks | `/sites/[siteId]/webhooks` | Criar endpoints e ver status resumido |
| Tela | Rota | Para que serve | | ------------------ | -------------------------------------- | ------------------------------------------------ | | Detalhe do webhook | `/sites/[siteId]/webhooks/[webhookId]` | Ver entregas, falhas, tentativas e resposta HTTP |
`consent.created`
`consent.updated`
Veja Configurar webhooks.
## Workspaces
URL: https://permito.com.br/docs/modulos/workspaces
Entenda como usar workspaces para organizar sites, membros e permissões.
Workspaces separam a operação por empresa, cliente ou projeto. Cada workspace tem seus próprios sites, membros, logs, políticas, webhooks e chaves.
Selecionar o workspace ativo pelo menu lateral.
Criar novos workspaces pelo seletor do menu lateral.
Editar nome, descrição e slug em **Configurações > Geral**.
Gerenciar membros em **Configurações > Membros**.
Gerenciar chaves em **Configurações > Acesso API**.
Excluir workspace, quando permitido.
| Ação | Onde fazer | | ---------------------- | ------------------------------- | | Trocar workspace ativo | Seletor no topo do menu lateral |
| Ação | Onde fazer | | --------------- | ---------------------------------------------------- | | Criar workspace | Seletor no topo do menu lateral → **Novo workspace** |
| Ação | Onde fazer | | ------------ | ------------------------- | | Editar dados | **Configurações → Geral** |
| Ação | Onde fazer | | ---------------- | --------------------------- | | Convidar membros | **Configurações → Membros** |
| Ação | Onde fazer | | ------------------- | ------------------------------ | | Criar chaves de API | **Configurações → Acesso API** |
| Ação | Onde fazer | | ----------------- | ------------------------- | | Excluir workspace | **Configurações → Geral** |
| Campo | O que significa | | --------------------- | -------------------------- | | **Nome do workspace** | Nome visível para a equipe |
| Campo | O que significa | | ------------- | ------------------------------------------ | | **Descrição** | Contexto opcional sobre o uso do workspace |
| Campo | O que significa | | -------- | ------------------------------------------------------- | | **Slug** | Identificador amigável; pode ser gerado automaticamente |
| Perfil | O que pode fazer | | ------- | -------------------------------------- | | `owner` | Gerencia workspace, membros e exclusão |
| Perfil | O que pode fazer | | ------- | ---------------------------- | | `admin` | Gerencia workspace e membros |
| Perfil | O que pode fazer | | ------ | -------------------------------------- | | `user` | Acessa workspace e recursos permitidos |
| Perfil | O que pode fazer | | -------- | ----------------------------- | | `viewer` | Visualiza recursos permitidos |
Use um workspace por empresa, cliente ou operação separada.
Evite misturar sites de clientes diferentes no mesmo workspace.
Mantenha descrições claras quando houver muitos workspaces.
Revise membros antes de excluir um workspace.
Veja Equipes e permissões.
## Assinar um plano
URL: https://permito.com.br/docs/planos-e-pagamento/assinar-plano
Siga o fluxo de assinatura de um plano pago pelo Permito.
Use a assinatura quando o workspace precisar de mais capacidade do que o plano gratuito oferece.
Verifique se você está no workspace correto. O plano contratado será aplicado ao workspace ativo.
Abra **Planos** no menu lateral.
Compare o plano atual, o uso do mês e as opções disponíveis.
Escolha o plano desejado.
Clique na ação de assinatura do plano.
Continue o pagamento no **Provedor de pagamentos**.
Após concluir, volte ao Permito.
Abra **Planos** novamente para confirmar o plano ativo e os limites.
A confirmação pode levar alguns instantes. Enquanto isso, mantenha o workspace selecionado e acompanhe a atualização na tela **Planos**.
O plano pago aparece como plano atual.
Os limites exibidos correspondem ao plano contratado.
O uso do mês continua visível no mesmo workspace.
Aprenda a gerenciar sua assinatura.
## Gerenciar assinatura
URL: https://permito.com.br/docs/planos-e-pagamento/gerenciar-assinatura
Atualize, acompanhe ou cancele a assinatura do workspace.
O gerenciamento da assinatura começa no Permito e continua no **Provedor de pagamentos**, quando necessário.
| Ação | Como seguir | | ------------------- | ------------------------------------------------------------------------------------------ | | **Atualizar plano** | Abra **Planos**, escolha uma opção disponível e conclua o fluxo no Provedor de pagamentos. |
| Ação | Como seguir | | ------------------------- | ---------------------------------------------------------------------------------------------- | | **Acompanhar assinatura** | Use **Gerenciar assinatura** para revisar informações disponíveis sobre cobrança e assinatura. |
| Ação | Como seguir | | ----------------------- | ------------------------------------------------------------------------------------ | | **Cancelar assinatura** | Use **Gerenciar assinatura** e siga as etapas indicadas pelo Provedor de pagamentos. |
| Ação | Como seguir | | ----------------------- | ------------------------------------------------------------ | | **Confirmar alteração** | Volte ao Permito e confira o plano ativo na tela **Planos**. |
Algumas alterações podem levar alguns instantes para aparecer no Permito. Se a tela não atualizar imediatamente, aguarde um pouco e abra **Planos** novamente.
Procure suporte se:
O pagamento foi concluído, mas o plano não mudou depois de alguns minutos.
A tela **Planos** mostra um plano diferente do esperado.
Você não consegue abrir o gerenciamento da assinatura.
Inclua o e-mail da conta, o workspace afetado e o horário aproximado da tentativa.
Entenda como verificar limites do workspace.
## Limites do workspace
URL: https://permito.com.br/docs/planos-e-pagamento/limites-do-workspace
Veja onde consultar limites de sites e visitantes do workspace ativo.
Os limites ajudam você a acompanhar a capacidade disponível no plano do workspace.
| Limite | O que indica | | --------- | ------------------------------------------------------------ | | **Sites** | Quantos sites o workspace pode manter dentro do plano atual. |
| Limite | O que indica | | ----------------------------- | ------------------------------------------------- | | **Visitantes únicos por mês** | Volume mensal acompanhado para a operação do CMP. |
O número usado mostra o consumo atual do workspace.
O número total mostra a capacidade do plano.
Ao trocar de workspace, os limites exibidos também mudam.
Se a operação crescer, revise as opções pagas disponíveis em **Planos**.
Confira os limites antes de criar novos sites.
Revise o uso mensal quando houver aumento de tráfego.
Mantenha apenas sites que ainda fazem parte da operação.
Use um workspace separado para cada empresa, cliente ou operação.
Se precisar mudar a capacidade disponível, veja como gerenciar a assinatura.
## Planos e pagamento
URL: https://permito.com.br/docs/planos-e-pagamento/visao-geral
Entenda workspaces gratuitos e pagos, onde consultar limites e como acompanhar sua assinatura.
A tela **Planos** mostra o plano do workspace ativo, o uso do mês e as opções disponíveis para assinatura.
| Tipo de workspace | Para que serve | | ----------------- | -------------------------------------------------------------------------------------------------------------------------- | | **Gratuito** | Começar a usar o Permito, configurar a operação inicial e validar o fluxo de consentimento dentro dos limites disponíveis. |
| Tipo de workspace | Para que serve | | ----------------- | ------------------------------------------------------------------------------------------------------------------------- | | **Pago** | Ampliar a capacidade do workspace conforme o plano escolhido e manter a operação com mais espaço para sites e visitantes. |
Cada workspace tem seu próprio plano. Ao trocar o workspace ativo, a tela **Planos** passa a mostrar assinatura, uso e limites daquele workspace.
O plano selecionado.
Os limites disponíveis para o workspace.
O uso atual do mês.
O período de cobrança.
O valor exibido no momento da assinatura.
Os limites podem variar por plano. Sempre confirme os dados na tela **Planos** antes de continuar.
Veja como assinar um plano.
## Acessar a plataforma
URL: https://permito.com.br/docs/primeiros-passos/acessar-a-plataforma
Aprenda a criar conta, entrar, verificar e-mail e recuperar acesso ao Permito.
Entre no Permito para acessar seus workspaces, sites, logs e configurações de consentimento.
Você precisa de:
Um e-mail válido que aceite mensagens de verificação.
Uma senha segura.
Acesso à caixa de entrada do e-mail informado.
Acesse `/register`.
Preencha **Nome completo**.
Informe seu **E-mail**.
Crie a **Senha**.
Repita a senha em **Confirmar senha**.
Clique em **Criar conta**.
Verifique sua caixa de entrada e confirme o e-mail.
O cadastro pode ser bloqueado se o domínio do e-mail for inválido, descartável ou não aceitar recebimento de mensagens.
Acesse `/login`.
Informe **E-mail** e **Senha**.
Clique em **Conectar**.
Se a conta ainda não tiver e-mail verificado, a plataforma direciona você para a tela **Verifique seu e-mail**.
Acesse `/verify-email`.
Informe o e-mail da conta.
Clique em **Reenviar link de verificação**.
Aguarde o tempo de cooldown quando a tela mostrar **Reenviar em alguns segundos**.
Na tela de login, clique em **Esqueceu sua senha?**.
Informe seu e-mail em `/forgot-password`.
Clique em **Enviar link por email**.
Abra o link recebido e defina uma nova senha em `/reset-password`.
Verifique se:
Você foi direcionado para `/dashboard`.
A plataforma mostra seu usuário no rodapé do menu lateral.
Você consegue abrir **Workspaces**, **Sites** ou **Configurações**.
| Problema | Causa provável | Como resolver | | ---------------------- | --------------------------------------------------------- | --------------------------------- | | **Email not verified** | A conta foi criada, mas o e-mail ainda não foi confirmado | Reenvie o link em `/verify-email` |
| Problema | Causa provável | Como resolver | | ----------------------- | ---------------------------- | ------------------------------------------- | | **Invalid credentials** | E-mail ou senha não conferem | Revise os dados ou use recuperação de senha |
| Problema | Causa provável | Como resolver | | ---------------------------- | ----------------------------------- | ------------------------------------------- | | Link de redefinição inválido | Token ausente, expirado ou já usado | Solicite um novo link em `/forgot-password` |
| Problema | Causa provável | Como resolver | | -------------- | ------------------------------- | ------------------------------------------------------ | | Conta suspensa | O acesso da conta foi bloqueado | Peça ajuda ao suporte ou ao responsável pelo workspace |
Depois de entrar, crie ou selecione um workspace.
## Acompanhar os primeiros eventos
URL: https://permito.com.br/docs/primeiros-passos/acompanhar-primeiros-eventos
Confirme se page views, decisões e logs de consentimento começaram a chegar.
Depois que o snippet está instalado, use o dashboard e os logs para confirmar que o CMP está operando.
Você precisa de:
Site com snippet instalado.
Site ativo no Permito.
Acesso de leitura ao workspace.
Perfis `owner`, `admin`, `user` e `viewer` podem visualizar métricas e logs. Exportação CSV é restrita a `owner` e `admin`.
Acesse **Dashboard**.
Selecione o site no seletor do topo.
Escolha o período: **Dia**, **Mes** ou **Ano**.
Revise os KPIs:
**Page views**.
**Decisoes totais**.
**Cobertura de consentimento**.
**Acceptance rate**.
**Reject rate**.
**Customize rate**.
Veja o gráfico **Atividade por período**.
Acesse **Logs de consentimento**.
Selecione o site.
Ajuste datas, host e ação.
Clique em **Aplicar**.
Revise os registros da tabela.
| Ação | O que significa | | ---------------- | -------------------------------------- | | **Aceitar tudo** | Visitante aceitou categorias opcionais |
| Ação | O que significa | | ---------------- | -------------------------------------- | | **Recusar tudo** | Visitante recusou categorias opcionais |
| Ação | O que significa | | ---------------- | --------------------------------------------- | | **Personalizar** | Visitante escolheu preferências por categoria |
| Ação | O que significa | | ------------------------ | -------------------------------------------------- | | **Reabrir preferências** | Visitante abriu o painel de preferências novamente |
Você concluiu a validação quando:
O site está **Verified**.
O dashboard mostra page views.
Pelo menos uma decisão aparece em **Logs de consentimento** após interação com o banner.
O `host` registrado corresponde ao domínio esperado.
A versão registrada corresponde à versão publicada.
| Problema | Causa provável | Como resolver | | --------------- | -------------------------------------- | ----------------------------------------------- | | Dashboard vazio | Nenhum site selecionado ou sem eventos | Selecione o site e acesse o domínio com snippet |
| Problema | Causa provável | Como resolver | | ----------- | ----------------------- | ---------------------------------------------- | | Logs vazios | Filtros muito restritos | Amplie o período ou remova filtro de host/ação |
| Problema | Causa provável | Como resolver | | -------------------- | -------------------- | ------------------------------- | | Exportação bloqueada | Perfil sem permissão | Peça ajuda a `owner` ou `admin` |
Veja próximos passos para convidar equipe, criar políticas e integrar webhooks.
## Criar ou selecionar um workspace
URL: https://permito.com.br/docs/primeiros-passos/criar-ou-selecionar-workspace
Entenda como trocar ou criar o espaço onde seus sites, membros, logs e integrações ficam organizados.
Um workspace separa a operação de uma empresa, cliente ou projeto. Dentro dele ficam sites, membros, políticas, webhooks, logs e chaves de API.
Ao criar uma conta, o Permito cria automaticamente um workspace inicial com o nome do usuário.
Abra o seletor de workspace no topo do menu lateral.
Escolha o workspace desejado.
A página será recarregada com o workspace ativo.
Abra o seletor de workspace no menu lateral.
Clique em **Novo workspace**.
Preencha **Nome do workspace**.
Se quiser, informe **Descrição** e **Slug**.
Clique em **Criar**.
O novo workspace passa a ser o workspace ativo automaticamente.
Acesse **Configurações**.
Abra a aba **Geral**.
Atualize nome, slug ou descrição.
Clique em **Salvar**.
A exclusão fica em **Configurações > Geral** e exige confirmação. Apenas `owner` pode excluir um workspace.
Verifique se:
O workspace aparece no seletor do menu lateral.
O Dashboard mostra métricas do workspace ativo.
Você consegue acessar **Sites**, **Logs de consentimento** e **Configurações**.
| Problema | Causa provável | Como resolver | | ------------------------------ | ---------------------------- | ------------------------------------ | | Não consigo editar o workspace | Seu papel não permite gestão | Peça permissão de `owner` ou `admin` |
| Problema | Causa provável | Como resolver | | ------------------------------- | --------------------------- | ---------------------------------- | | Não consigo excluir o workspace | Apenas `owner` pode excluir | Peça ao owner para executar a ação |
| Problema | Causa provável | Como resolver | | ------------------- | -------------------------------- | ----------------------------------------- | | Slug já está em uso | Outro workspace usa o mesmo slug | Escolha outro slug ou deixe o campo vazio |
Agora crie seu primeiro site.
## Criar seu primeiro site
URL: https://permito.com.br/docs/primeiros-passos/criar-primeiro-site
Cadastre um domínio no Permito para configurar o banner de consentimento.
Crie um site para gerar a chave pública, configurar o banner e permitir que o snippet opere apenas no domínio correto.
Você precisa de:
Workspace ativo.
Permissão de `owner` ou `admin`.
Domínio raiz do site, como `empresa.com`.
Cadastre o domínio raiz sem protocolo, caminho ou barra final. Use `empresa.com`, não `https://empresa.com/pagina`.
Acesse **Sites**.
Clique em **Novo site**.
Preencha **Nome do site**.
Preencha o domínio em formato semelhante a `exemplo.com`.
Revise o idioma padrão, normalmente `pt-BR`.
Clique em **Criar**.
Depois da criação, o Permito abre a tela de detalhe do site.
Ao criar um site, o Permito gera:
Um `site_key`, usado pelo loader público.
Uma configuração inicial do banner.
Versão publicada inicial.
Área de instalação com snippet.
Área para webhooks e chaves do site.
Verifique se:
O novo site aparece na lista de **Sites**.
A tela do site mostra o domínio como título.
O status aparece como **Ativo**.
A versão publicada aparece no topo da tela.
| Problema | Causa provável | Como resolver | | -------------------------------- | --------------------------- | ------------------------------- | | **Preencha nome e domínio raiz** | Nome ou domínio ficou vazio | Complete os campos obrigatórios |
| Problema | Causa provável | Como resolver | | -------------- | ------------------------------------- | ------------------------------------------ | | Site duplicado | O domínio raiz já existe no workspace | Abra o site existente ou use outro domínio |
| Problema | Causa provável | Como resolver | | -------------------------------- | ---------------------- | --------------------------------- | | Botão **Novo site** desabilitado | Você não tem permissão | Peça acesso de `owner` ou `admin` |
Depois de criar o site, publique o banner.
## Instalar o snippet
URL: https://permito.com.br/docs/primeiros-passos/instalar-snippet
Copie o snippet do site e instale no head para carregar o CMP público.
O snippet carrega o banner do Permito no domínio autorizado e envia eventos de page view e consentimento.
Você precisa de:
Site criado e ativo no Permito.
Configuração publicada.
Acesso ao código do site, CMS, tag manager ou ferramenta que permita inserir script no ``.
Acesse **Sites**.
Abra o site desejado.
Vá para a aba **Instalação**.
Clique em **Copiar snippet**.
Não altere manualmente o código dentro do snippet.
Abra o local onde seu site permite editar o ``.
Cole o snippet copiado.
Publique a alteração no seu site.
Acesse o domínio raiz ou um subdomínio autorizado.
O Permito aceita:
O domínio raiz cadastrado, como `empresa.com`.
Subdomínios desse domínio, como `www.empresa.com` ou `app.empresa.com`.
Após o primeiro evento válido, o site passa a aparecer como verificado e o Dashboard começa a receber métricas.
Veja Acompanhar primeiros eventos.
## Próximos passos
URL: https://permito.com.br/docs/primeiros-passos/proximos-passos
Evolua da primeira instalação para uma operação completa de consentimento.
Depois que o primeiro site está operando, avance para governança, auditoria e integrações.
Use **Configurações → Membros** para convidar pessoas por e-mail e definir papéis. Dê acesso administrativo apenas para quem precisa criar sites, publicar configurações, exportar logs ou gerenciar webhooks.
Leia: Convidar usuários.
Use **Políticas (beta)** dentro do site para gerar documentos de:
Cookies.
Privacidade.
Termos.
Depois revise, salve e publique. Cada política publicada tem uma URL pública estável em `/policies/public/[slug]`.
Leia: Políticas.
Use **Planos** para acompanhar o plano do workspace ativo, o uso do mês e os limites disponíveis. Se a operação crescer, compare as opções pagas antes de criar novas frentes de uso.
Leia: Planos e pagamento.
Use webhooks quando outro sistema da sua equipe precisa receber eventos de consentimento. Combine a configuração com a pessoa responsável pelo sistema de destino.
Leia: Webhooks.
Para conferências, solicitações jurídicas ou atendimento a pedidos internos, use:
**Logs de consentimento** com filtros.
Exportação CSV, quando você tiver permissão.
Histórico de versões das políticas.
Versão da configuração registrada nos logs.
Leia: Auditar consentimentos.
Publique alterações em horários de menor risco.
Revise links legais antes de publicar o banner.
Não compartilhe chaves ou segredos de webhook.
Remova membros que não fazem mais parte da operação.
Monitore webhooks com status `failed`.
Verifique limites do workspace antes de expandir sites ou tráfego.
Abra o guia da plataforma para conhecer cada tela.
## Publicar o banner
URL: https://permito.com.br/docs/primeiros-passos/publicar-banner
Ajuste textos, regras e estilo do banner antes de publicar a configuração para visitantes.
Publique a configuração para que visitantes vejam a versão correta do banner no site instalado.
Você precisa de:
Um site criado.
Permissão de `owner` ou `admin` para publicar.
Textos e links legais revisados.
Usuários com papel `user` podem editar a configuração do site, mas a publicação fica restrita a `owner` e `admin`.
Acesse **Sites**.
Abra o site desejado.
Na aba **Conteudo & textos**, revise **Título do banner** e **Texto descritivo**.
Ajuste os rótulos:
**Botão aceitar**.
**Botão recusar**.
**Link customizar**.
Informe as URLs de política de privacidade e política de cookies.
Abra a aba **Regras**.
Revise **Categorias de consentimento**.
Defina o estado padrão de **Analytics**.
Defina o estado padrão de **Marketing**.
Cookies essenciais permanecem tratados como necessários para funcionamento básico.
Abra **Design & preview**.
Escolha **Posição**:
**Topo**.
**Rodapé**.
**Modal central**.
Escolha **Tema base**: claro ou escuro.
Escolha o lado do banner e do botão de reabrir preferências.
Ajuste cores em hexadecimal quando necessário.
Use o **Preview ao vivo** para revisar.
Clique em **Publicar** para salvar internamente as alterações e tornar a configuração ativa.
Aguarde a mensagem de sucesso.
Verifique se:
A versão publicada aumentou.
O dashboard e os logs passam a registrar a nova versão publicada.
Ao recarregar o site com snippet instalado, o banner reflete a versão publicada.
| Problema | Causa provável | Como resolver | | ----------------------------- | -------------------------------------- | ---------------------- | | Alteração não aparece no site | A configuração ainda não foi publicada | Clique em **Publicar** |
| Problema | Causa provável | Como resolver | | ------------------------------------ | ------------------------------------ | ---------------------------------- | | Botão **Publicar** está desabilitado | Seu perfil não é `owner` nem `admin` | Peça publicação a um administrador |
| Problema | Causa provável | Como resolver | | ------------------ | --------------------------------- | ------------------------ | | URL legal inválida | O campo espera uma URL HTTP/HTTPS | Informe uma URL completa |
Depois de publicar, instale o snippet.
## Visão geral dos primeiros passos
URL: https://permito.com.br/docs/primeiros-passos/visao-geral
Entenda a sequência recomendada para sair da conta nova até o primeiro CMP em operação.
Use este guia para configurar o Permito pela primeira vez e chegar ao primeiro resultado: um site com banner publicado, snippet instalado e eventos chegando ao painel.
Você precisa de:
Uma conta no Permito.
Um e-mail verificado.
Um workspace ativo.
Permissão de `owner` ou `admin` para criar site, publicar configuração, instalar integrações e convidar membros.
Acesso ao código ou ferramenta onde o site permite inserir scripts no ``.
CMP significa Consent Management Platform. No Permito, isso quer dizer uma plataforma para exibir banner de cookies, registrar escolhas e manter evidências de consentimento por site.
Acesse ou crie sua conta.
Verifique o e-mail.
Crie ou selecione um workspace.
Cadastre um site com domínio raiz.
Ajuste textos, regras e estilo do banner.
Publique a configuração.
Copie o snippet e instale no site.
Acesse o domínio autorizado para gerar os primeiros eventos.
Verifique o dashboard e os logs de consentimento.
Você está pronto para operar quando:
O site aparece na lista de **Sites**.
A versão publicada aparece como `v1` ou superior.
O snippet foi copiado da aba **Instalação**.
O site muda de **Unverified** para **Verified** após receber um evento válido.
O **Dashboard** mostra page views ou decisões para o site selecionado.
| Problema | Causa provável | Como resolver | | ---------------------- | ------------------------------------ | --------------------------------------------------------------- | | Não consigo criar site | Seu perfil não é `owner` nem `admin` | Peça a um administrador para criar o site ou ajustar seu acesso |
| Problema | Causa provável | Como resolver | | ------------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------- | | O site fica como **Unverified** | O snippet ainda não enviou evento válido | Confira se o domínio acessado corresponde ao domínio raiz ou subdomínio autorizado |
| Problema | Causa provável | Como resolver | | ---------------------------------- | ----------------------------------- | -------------------------------------- | | O banner não muda depois de editar | A alteração ainda não foi publicada | Clique em **Publicar** na tela do site |
| Problema | Causa provável | Como resolver | | --------------------------------- | ----------------------------------------- | ----------------------------------------- | | A exportação de logs não funciona | Exportação é restrita a `owner` e `admin` | Peça a alguém com permissão para exportar |
Siga para acessar a plataforma.
## Campos importantes
URL: https://permito.com.br/docs/referencia/campos-importantes
Entenda campos de formulários, tabelas e integrações do Permito.
| Campo | O que significa | Obrigatório | | ------------ | ----------------------------------------- | ----------- | | Nome do site | Nome usado pela equipe para identificação | Sim |
| Campo | O que significa | Obrigatório | | ------------ | --------------------------- | ----------- | | Domínio raiz | Domínio autorizado para CMP | Sim |
| Campo | O que significa | Obrigatório | | ------------- | ------------------------------ | ----------- | | Idioma padrão | Idioma inicial da configuração | Sim |
| Campo | O que significa | Obrigatório | | -------- | ------------------------ | ----------- | | Site key | Chave pública do snippet | Gerado |
| Campo | O que significa | Obrigatório | | ---------------- | ---------------------- | ----------- | | Versão publicada | Versão ativa do banner | Gerado |
| Campo | O que significa | | ---------------- | ---------------------------- | | Título do banner | Título mostrado ao visitante |
| Campo | O que significa | | ---------------- | ------------------------ | | Texto descritivo | Explicação sobre cookies |
| Campo | O que significa | | ------------- | --------------------- | | Botão aceitar | Texto do aceite total |
| Campo | O que significa | | ------------- | --------------------- | | Botão recusar | Texto da recusa total |
| Campo | O que significa | | --------------- | ----------------------------- | | Link customizar | Texto para abrir preferências |
| Campo | O que significa | | --------------------------- | ------------------------- | | URL política de privacidade | Link legal de privacidade |
| Campo | O que significa | | ----------------------- | --------------------- | | URL política de cookies | Link legal de cookies |
| Campo | O que significa | | --------- | ----------------- | | Timestamp | Momento do evento |
| Campo | O que significa | | ----- | --------------------- | | Host | Domínio ou subdomínio |
| Campo | O que significa | | ------- | ------------------------ | | Visitor | Identificador pseudônimo |
| Campo | O que significa | | ------ | ----------------- | | Action | Ação do visitante |
| Campo | O que significa | | ----- | -------------------- | | State | Estado por categoria |
| Campo | O que significa | | ------ | ---------------------- | | Config | Versão da configuração |
Veja Mensagens do sistema.
## Glossário
URL: https://permito.com.br/docs/referencia/glossario
Entenda os principais termos usados no Permito.
| Termo | Significado | Onde aparece | | --------------- | -------------------- | ------------ | | Acceptance rate | Taxa de aceite total | Dashboard |
| Termo | Significado | Onde aparece | | ---------- | -------------------------------------- | ------------- | | API Access | Área de chaves de leitura do workspace | Configurações |
| Termo | Significado | Onde aparece | | ----- | ------------------------------------- | ------------ | | CMP | Plataforma de gestão de consentimento | Produto |
| Termo | Significado | Onde aparece | | ---------------------- | ------------------------------------- | ------------ | | Versão da configuração | Versão do banner registrada no evento | Logs |
| Termo | Significado | Onde aparece | | ----------- | ----------------------------------- | ------------ | | Consent log | Registro auditável de consentimento | Logs |
| Termo | Significado | Onde aparece | | -------------- | ---------------------- | ------------ | | Customize rate | Taxa de personalização | Dashboard |
| Termo | Significado | Onde aparece | | ----------- | ----------------------- | ------------ | | Domain root | Domínio raiz autorizado | Sites |
| Termo | Significado | Onde aparece | | ----- | ------------------------------ | ---------------- | | Draft | Alteração salva, não publicada | Sites, políticas |
| Termo | Significado | Onde aparece | | -------------- | ----------------------- | ------------ | | URL de destino | URL que recebe webhooks | Webhooks |
| Termo | Significado | Onde aparece | | ------------------ | -------------------------------------- | ------------ | | Segredo do webhook | Valor usado para proteger a integração | Integrações |
| Termo | Significado | Onde aparece | | ----- | ----------------------------- | ------------ | | Host | Domínio onde o evento ocorreu | Logs |
| Termo | Significado | Onde aparece | | --------- | ---------------------- | ------------ | | Page view | Visualização de página | Dashboard |
| Termo | Significado | Onde aparece | | ----------- | -------------------- | ------------ | | Reject rate | Taxa de recusa total | Dashboard |
| Termo | Significado | Onde aparece | | -------- | ------------------------------ | ------------ | | Site key | Chave pública usada no snippet | Snippet |
| Termo | Significado | Onde aparece | | ------- | ------------------------ | ------------ | | Snippet | Script instalado no site | Instalação |
| Termo | Significado | Onde aparece | | ---------- | ------------------------------------- | ------------ | | Visitor ID | Identificador pseudônimo do visitante | Logs |
| Termo | Significado | Onde aparece | | --------- | ----------------------------------- | ------------ | | Workspace | Ambiente que separa dados e membros | Menu |
Veja Status e estados.
## Mensagens do sistema
URL: https://permito.com.br/docs/referencia/mensagens-do-sistema
Entenda mensagens comuns de sucesso, erro e validação.
| Mensagem | Significado | | --------------- | ------------------------ | | **Site criado** | O domínio foi cadastrado |
| Mensagem | Significado | | --------------- | ------------------------------------------- | | **Draft salvo** | Alterações foram salvas, mas não publicadas |
| Mensagem | Significado | | -------------------------- | --------------------------------- | | **Configuração publicada** | O banner publicado foi atualizado |
| Mensagem | Significado | | ------------------ | ------------------- | | **Webhook criado** | Endpoint registrado |
| Mensagem | Significado | | ------------------------------- | ---------------------------------- | | **Convite enviado com sucesso** | Link de convite foi gerado/enviado |
| Mensagem | Significado | | --------------------------------- | --------------------------- | | **Perfil atualizado com sucesso** | Dados da conta foram salvos |
| Mensagem | Como agir | | ----------------------- | -------------------------------- | | **Falha ao criar site** | Revise nome, domínio e permissão |
| Mensagem | Como agir | | --------------------- | ------------------------------------------ | | **Falha ao publicar** | Revise os dados e tente publicar novamente |
| Mensagem | Como agir | | ----------------- | --------------------------------- | | **No permission** | Verifique seu perfil no workspace |
| Mensagem | Como agir | | ------------------ | ------------------------------------- | | **Site not found** | Confirme se está no workspace correto |
| Mensagem | Como agir | | ----------------------- | -------------------- | | **Invalid credentials** | Revise login e senha |
| Mensagem | Como agir | | ---------------------- | ----------------------------- | | **Email not verified** | Verifique ou reenvie o e-mail |
Se a mensagem persistir, abra Solução de problemas.
## Segurança e dados
URL: https://permito.com.br/docs/referencia/seguranca-e-dados
Entenda cuidados de segurança, dados registrados e credenciais no Permito.
O Permito foi desenhado para registrar consentimento com rastreabilidade e separar dados por workspace.
Os logs de consentimento registram, no mínimo:
Timestamp.
Site.
Host.
Visitor ID pseudônimo.
Ação do visitante.
Estado de categorias.
Versão da configuração.
Trate como segredo:
Chave do site.
Chaves de leitura do workspace.
Segredos de webhooks.
Use perfis mínimos.
Não compartilhe credenciais em canais públicos.
Revogue chaves antigas.
Rotacione chaves após suspeita de exposição.
Use URLs HTTPS em webhooks.
Combine com a equipe técnica como os eventos serão validados.
Leia Chaves e API Access.
## Status e estados
URL: https://permito.com.br/docs/referencia/status-e-estados
Referência rápida dos status exibidos no Permito.
| Status | Significado | | ------ | -------------------- | | Ativo | CMP público liberado |
| Status | Significado | | ---------- | --------------------- | | Desativado | CMP público bloqueado |
| Status | Significado | | -------- | ---------------------- | | Verified | Evento válido recebido |
| Status | Significado | | ---------- | ----------------------------- | | Unverified | Nenhum evento válido recebido |
| Status | Significado | | ------ | ------------------- | | Draft | Documento em edição |
| Status | Significado | | --------- | ------------------------------------ | | Publicado | Documento disponível por URL pública |
| Status | Significado | | ------- | ------------------ | | pending | Entrega aguardando |
| Status | Significado | | ------- | ----------------- | | success | Entrega concluída |
| Status | Significado | | ------ | -------------- | | failed | Entrega falhou |
| Status | Significado | | ------- | --------------- | | pending | Pode ser aceito |
| Status | Significado | | -------- | ------------- | | accepted | Já foi aceito |
| Status | Significado | | ------- | ------------- | | revoked | Foi cancelado |
| Status | Significado | | ------- | ------------- | | expired | Prazo expirou |
Veja Campos importantes.
## Relatório do Dashboard
URL: https://permito.com.br/docs/relatorios/dashboard
Use o dashboard para interpretar KPIs e tendência de consentimento.
O Dashboard é o relatório mais rápido para entender se o CMP está recebendo tráfego e decisões.
Selecione um site.
Escolha **Dia**, **Mes** ou **Ano**.
Revise KPIs.
Analise o gráfico.
Veja o resumo por ação.
| Sinal | Interpretação | | ----------------------- | ----------------------------------------------------------------- | | Page views sem decisões | Banner pode estar sendo visto, mas visitantes não estão decidindo |
| Sinal | Interpretação | | --------------------------------- | ------------------------------------ | | Decisões sem page views esperadas | Verifique período e site selecionado |
| Sinal | Interpretação | | ----------- | ------------------------------------ | | Alta recusa | Revise texto, contexto e experiência |
| Sinal | Interpretação | | ------------------- | -------------------------------------------------------------- | | Alta personalização | Visitantes estão ajustando preferências em vez de aceitar tudo |
Use Exportação CSV para análise externa.
## Exportação CSV
URL: https://permito.com.br/docs/relatorios/exportacao-csv
Entenda as exportações disponíveis e quando usá-las.
O Permito permite exportar dados para análise fora da plataforma.
| Exportação | Onde fica | Permissão | | ------------------ | ---------------------------- | ------------------- | | Série do dashboard | **Dashboard → Exportar CSV** | Acesso ao dashboard |
| Exportação | Onde fica | Permissão | | --------------------- | ---------------------------------------- | ---------------- | | Logs de consentimento | **Logs de consentimento → Exportar CSV** | `owner`, `admin` |
Revise filtros antes de exportar.
Compartilhe arquivos apenas com pessoas autorizadas.
Logs podem conter identificadores pseudônimos e dados operacionais sensíveis.
Exportação de consent logs gera auditoria no workspace.
Veja Webhooks.
## Observabilidade de webhooks
URL: https://permito.com.br/docs/relatorios/observabilidade-webhooks
Monitore entregas, falhas e tentativas de webhooks.
Use esta tela para investigar se os eventos estão sendo entregues corretamente às URLs configuradas.
Data inicial.
Data final.
Status.
Tipo de evento.
Endpoint.
Busca por URL.
| Indicador | O que mostra | | --------- | ---------------------- | | Success | Entregas bem-sucedidas |
| Indicador | O que mostra | | --------- | ------------------ | | Failed | Entregas com falha |
| Indicador | O que mostra | | --------- | ------------------ | | Pending | Entregas pendentes |
Se houver `failed`, revise resposta HTTP e erro.
Após corrigir a URL ou o sistema de destino, clique em **Retry falhas**.
Leia Webhook falhando.
## Visão geral de relatórios
URL: https://permito.com.br/docs/relatorios/visao-geral
Entenda onde acompanhar métricas, exportações e observabilidade no Permito.
O Permito oferece relatórios operacionais para acompanhar consentimento, exportar evidências e monitorar webhooks.
| Relatório | Onde encontrar | Uso | | --------- | -------------- | --------------------------- | | Dashboard | **Dashboard** | Métricas agregadas por site |
| Relatório | Onde encontrar | Uso | | --------------------- | ------------------------- | ---------------------- | | Logs de consentimento | **Logs de consentimento** | Evidências individuais |
| Relatório | Onde encontrar | Uso | | ----------- | ---------------------------------------- | ----------------- | | CSV de logs | **Logs de consentimento → Exportar CSV** | Auditoria externa |
| Relatório | Onde encontrar | Uso | | --------- | -------------------- | ----------------- | | Webhooks | **Sites → Webhooks** | Entregas e falhas |
Veja Dashboard.
## Convite inválido
URL: https://permito.com.br/docs/solucoes-de-problemas/convite-invalido
Entenda convites expirados, revogados, aceitos ou abertos com conta errada.
A tela de convite mostra que o link é inválido, expirou ou não está mais disponível.
O convite pode ter expirado, sido revogado, já aceito ou aberto com uma conta diferente do e-mail convidado.
Confirme se o link foi copiado completo.
Verifique se você está logado com o e-mail convidado.
Se o convite expirou, peça um novo convite.
Se o convite já foi aceito, acesse o workspace diretamente.
Verifique se:
A tela mostra o workspace do convite.
O botão **Aceitar convite** aparece quando você está logado.
Após aceitar, você vai para o workspace.
Peça ajuda ao administrador do workspace para reenviar o convite.
## Evento não aparece
URL: https://permito.com.br/docs/solucoes-de-problemas/evento-nao-aparece
Resolva casos em que logs ou métricas não aparecem depois da instalação.
O dashboard fica vazio ou os logs não mostram eventos esperados.
Pode haver site sem seleção, filtros restritos, período incorreto, snippet sem execução, domínio não autorizado ou site desativado.
Selecione o site correto no cabeçalho.
Amplie o período.
Remova filtro de host.
Remova filtro de ação.
Confirme se o site está **Ativo**.
Acesse o domínio com snippet.
Interaja com o banner.
Recarregue **Dashboard** e **Logs de consentimento**.
Verifique se:
Page views aparecem.
Uma decisão aparece após aceitar, recusar ou personalizar.
O host registrado é o domínio esperado.
Peça suporte se o snippet funciona visualmente, mas nenhum evento chega após filtros amplos.
## Política não publica
URL: https://permito.com.br/docs/solucoes-de-problemas/politica-nao-publica
Resolva falhas ao salvar ou publicar políticas de cookies, privacidade ou termos.
Ao clicar em **Publicar**, a política não muda para status publicado.
A publicação salva o conteúdo antes de publicar. Se o salvamento falhar, a publicação é bloqueada.
Confirme que você não é `viewer`.
Revise título e conteúdo.
Clique em **Salvar**.
Aguarde mensagem de sucesso.
Clique em **Publicar**.
Abra **Histórico** para confirmar a versão.
Verifique se:
Status aparece como **publicada**.
URL pública abre corretamente.
Histórico mostra data de publicação.
Peça suporte se salvar funciona, mas publicar continua falhando.
## Sem permissão
URL: https://permito.com.br/docs/solucoes-de-problemas/sem-permissao
Entenda botões desabilitados, mensagens de acesso negado e ações restritas.
Um botão aparece desabilitado ou uma ação falha com acesso negado.
O Permito aplica permissões por workspace. Algumas ações são restritas a `owner` e `admin`.
Confira seu papel no workspace.
Verifique a ação desejada na página Permissões e acessos.
Peça a um `owner` ou `admin` para executar a ação ou ajustar seu perfil.
Se você acredita que deveria ter acesso, envie ao suporte o nome do workspace, a tela e a ação bloqueada.
| Ação | Perfis | | ---------- | ---------------- | | Criar site | `owner`, `admin` |
| Ação | Perfis | | --------------- | ---------------- | | Publicar banner | `owner`, `admin` |
| Ação | Perfis | | ------------- | ---------------- | | Exportar logs | `owner`, `admin` |
| Ação | Perfis | | ------------------ | ---------------- | | Gerenciar webhooks | `owner`, `admin` |
| Ação | Perfis | | ----------------------- | ---------------- | | Criar chaves de leitura | `owner`, `admin` |
| Ação | Perfis | | ---------------- | ---------------- | | Convidar membros | `owner`, `admin` |
Peça suporte se seu perfil está correto e a ação continua bloqueada.
## Site não verificado
URL: https://permito.com.br/docs/solucoes-de-problemas/site-nao-verificado
Entenda por que um site continua Unverified e como corrigir.
O site aparece como **Unverified** na lista de **Sites**.
O Permito marca um site como **Verified** quando recebe um primeiro evento válido do domínio raiz ou de um subdomínio autorizado.
Abra **Sites**.
Confirme se o domínio raiz está correto.
Abra o site e vá para **Instalação**.
Copie o snippet novamente.
Verifique se ele está instalado no ``.
Publique o site.
Acesse o domínio raiz ou subdomínio autorizado.
Aguarde o evento chegar.
Verifique se:
O status muda para **Verified**.
**Ultimo host visto** aparece no detalhe do site.
O dashboard mostra page views.
Peça suporte se o snippet está instalado, o domínio está correto e o site continua **Unverified** após novas visitas.
## Snippet não carrega
URL: https://permito.com.br/docs/solucoes-de-problemas/snippet-nao-carrega
Resolva casos em que o banner não aparece no site instalado.
O banner não aparece no site, mesmo após copiar o snippet.
As causas mais prováveis são: snippet ausente no ``, domínio não autorizado, site desativado ou configuração não publicada.
Confirme se o snippet foi colado no ``.
Confirme se a alteração foi publicada no site.
Acesse o domínio raiz cadastrado ou subdomínio permitido.
No Permito, abra o site e confirme status **Ativo**.
Clique em **Publicar** se houve alteração recente.
Copie o snippet novamente, se ele tiver sido alterado manualmente.
Verifique se:
O banner aparece.
O site vira **Verified**.
Page views aparecem no dashboard.
Peça suporte se o script está no ``, o site está ativo e o domínio corresponde ao cadastro.
## Visão geral de solução de problemas
URL: https://permito.com.br/docs/solucoes-de-problemas/visao-geral
Encontre caminhos rápidos para resolver falhas comuns no Permito.
Use esta seção quando algo não aparece, falha, fica pendente ou exige permissão.
| Sintoma | Página recomendada | | ---------------------------- | ------------------- | | Site continua **Unverified** | Site não verificado |
| Sintoma | Página recomendada | | ------------------ | ------------------- | | Banner não aparece | Snippet não carrega |
| Sintoma | Página recomendada | | ------------------------ | ------------------ | | Logs ou dashboard vazios | Evento não aparece |
| Sintoma | Página recomendada | | ------------------------------ | ------------------ | | Botão desabilitado ou erro 403 | Sem permissão |
| Sintoma | Página recomendada | | --------------------------- | ------------------ | | Webhook com status `failed` | Webhook falhando |
| Sintoma | Página recomendada | | ------------------------ | ------------------ | | Link de convite inválido | Convite inválido |
| Sintoma | Página recomendada | | -------------------- | -------------------- | | Política não publica | Política não publica |
Antes de investigar detalhes, confirme:
Workspace ativo.
Site correto selecionado.
Período correto nos filtros.
Permissão adequada.
Site ativo.
Configuração publicada.
Snippet instalado no domínio autorizado.
Escolha o problema na lista acima ou abra Suporte.
## Webhook falhando
URL: https://permito.com.br/docs/solucoes-de-problemas/webhook-falhando
Resolva entregas de webhook com status failed.
Entregas aparecem com status `failed` na tela de observabilidade de webhooks.
O sistema de destino pode estar indisponível, retornando erro, demorando para responder ou usando um segredo diferente do cadastrado no Permito.
Acesse **Sites**.
Abra o site.
Clique em **Webhooks**.
Filtre por status `failed`.
Revise **HTTP** e **Erro**.
Corrija a URL ou o sistema de destino.
Confirme se o segredo compartilhado é o mesmo.
Clique em **Retry falhas**.
Verifique se:
Novas entregas aparecem como `success`.
O total de `failed` não aumenta.
Peça suporte se o sistema de destino responde corretamente, mas o Permito continua registrando falha sem motivo claro.
## Suporte
URL: https://permito.com.br/docs/suporte
Saiba que informações reunir antes de pedir ajuda.
Peça suporte quando uma ação importante continuar falhando depois de seguir a solução de problemas.
Reúna:
Workspace afetado.
Site afetado.
Rota ou tela onde o problema aconteceu.
Mensagem exibida.
Horário aproximado.
Perfil do usuário.
Filtros usados, se for log ou relatório.
Status de webhook, se for integração.
Não compartilhe:
Senhas.
Chaves completas de API.
Segredos de webhook.
Tokens de convite.
Cookies de sessão.
Solução de problemas.
Permissões e acessos.
Logs de consentimento.
Webhooks.
Se o problema envolve operação do CMP, comece pela página específica em Solução de problemas.
## Convidar membro
URL: https://permito.com.br/docs/tarefas/convidar-membro
Convide uma pessoa para participar de um workspace com o papel correto.
Convide membros quando outra pessoa precisa operar, revisar ou acompanhar dados no workspace.
Perfil `owner` ou `admin`.
E-mail da pessoa convidada.
Papel desejado: `admin`, `user` ou `viewer`.
Acesse **Configurações**.
Abra a aba **Membros**.
Informe o e-mail.
Escolha a função.
Clique em **Convidar**.
O sistema envia convite por e-mail. Em ambiente sem SMTP, a URL pode aparecer nos logs do servidor.
Verifique se:
A mensagem **Convite enviado com sucesso** aparece.
A pessoa consegue abrir o link.
Após aceitar, ela aparece como membro do workspace.
Veja Convidar usuários.
## Criar site
URL: https://permito.com.br/docs/tarefas/criar-site
Crie um site no workspace para gerar o snippet e configurar consentimento.
Crie um site sempre que precisar operar consentimento em um novo domínio raiz.
Papel `owner` ou `admin`.
Workspace ativo.
Domínio raiz correto.
Acesse **Sites**.
Clique em **Novo site**.
Preencha o nome.
Preencha o domínio raiz.
Revise o idioma.
Clique em **Criar**.
Verifique se:
O site abre automaticamente.
O status aparece como **Ativo**.
O snippet fica disponível em **Instalação**.
Depois de criar, edite o banner.
## Editar banner
URL: https://permito.com.br/docs/tarefas/editar-banner
Atualize textos, links legais, regras e aparência do banner de um site.
Edite o banner para ajustar a experiência exibida ao visitante.
Site criado.
Perfil `owner`, `admin` ou `user` para editar a configuração.
Perfil `owner` ou `admin` para publicar.
Acesse **Sites**.
Abra o site.
Edite **Conteudo & textos**.
Edite **Regras**.
Edite **Design & preview**.
Peça revisão, se necessário.
Clique em **Publicar**.
Verifique se a nova versão publicada aparece no topo da tela e se o banner no site instalado mostra as mudanças.
Se ainda não estiver instalado, instale o snippet.
## Exportar logs CSV
URL: https://permito.com.br/docs/tarefas/exportar-logs-csv
Baixe logs de consentimento filtrados em CSV quando precisar de evidências.
Exporte logs para análise externa, auditoria ou compartilhamento interno controlado.
Perfil `owner` ou `admin`.
Site selecionado.
Filtros revisados.
Acesse **Logs de consentimento**.
Selecione o site.
Defina período.
Informe host ou ação, se necessário.
Clique em **Aplicar**.
Clique em **Exportar CSV**.
Verifique se:
O arquivo foi baixado.
As colunas correspondem aos dados exibidos.
O período e filtros estão corretos.
Veja Auditar consentimentos.
## Gerenciar políticas
URL: https://permito.com.br/docs/tarefas/gerenciar-politicas
Crie, revise, publique e copie links públicos de políticas de um site.
Gerencie políticas para manter documentos públicos alinhados ao banner e à operação do site.
Site criado.
Perfil diferente de `viewer`.
Dados da empresa e e-mail de contato.
Abra **Sites**.
Selecione o site.
Clique em **Políticas (beta)**.
Crie ou abra uma política.
Revise o Markdown.
Confira a visualização.
Clique em **Salvar**.
Clique em **Publicar**.
Copie a URL pública.
Verifique se:
O status aparece como **Publicado**.
A URL pública abre o documento.
O histórico mostra a versão publicada.
Use o link nos campos legais do banner em Editar banner.
## Instalar snippet
URL: https://permito.com.br/docs/tarefas/instalar-snippet
Copie o snippet do site e instale no head do domínio.
O snippet carrega o banner CMP e envia eventos para o Permito.
Acesse **Sites**.
Abra o site.
Vá para a aba **Instalação**.
Clique em **Copiar snippet**.
Cole o código no `` do site.
Publique ou faça deploy do site.
Verifique se:
O banner aparece no domínio configurado.
O site passa para verificado após o primeiro evento.
O Dashboard começa a exibir page views.
Veja Acompanhar primeiros eventos.
## Rotacionar chaves
URL: https://permito.com.br/docs/tarefas/rotacionar-chaves
Saiba quando e como rotacionar códigos e chaves de acesso.
Rotacione credenciais quando houver suspeita de exposição, troca de fornecedor ou rotina periódica de segurança.
| Credencial | Onde fica | | -------------- | ------------------------------- | | Código do site | **Sites → [site] → Instalação** |
| Credencial | Onde fica | | ----------------------------- | ------------------------------ | | Chave de leitura do workspace | **Configurações → Acesso API** |
Acesse **Sites**.
Abra o site.
Vá para **Instalação**.
Clique em **Rotacionar código**.
Confirme a ação.
Copie e reinstale o snippet atualizado.
Rotacionar o código invalida o snippet antigo. Planeje a reinstalação antes de confirmar.
Acesse **Configurações**.
Abra **Acesso API**.
Clique em **Rotacionar** na chave desejada.
Copie a nova chave imediatamente.
Veja Chaves e API Access.