# Permito Docs
## Documentação para agentes
URL: /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
`/docs/llms.txt`
Índice em texto com os principais links da documentação.
`/docs/llms-full.txt`
Versão consolidada com o conteúdo das 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.
## Perguntas frequentes
URL: /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 ligado ou desligado no draft.
Sim. **Salvar draft** grava alterações; **Publicar** torna a 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.
## Documentação
URL: /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.
## Suporte
URL: /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.
## Como o Permito funciona
URL: /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.
Você salva o draft.
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`
`empresa.com`
`www.empresa.com`
`empresa.com`
`app.empresa.com`
`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: /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
`admin`
Pessoa que administra a operação
Gerencia membros, sites, publicações, webhooks, chaves e exportações
`user`
Pessoa que opera o dia a dia
Edita draft do site e visualiza métricas/logs
`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
Editar draft do banner
Sim
Sim
Sim
Não
Publicar banner
Sim
Sim
Não
Não
Desativar ou reativar site
Sim
Sim
Não
Não
Ver dashboard
Sim
Sim
Sim
Sim
Ver logs
Sim
Sim
Sim
Sim
Exportar logs CSV
Sim
Sim
Não
Não
Criar webhooks
Sim
Sim
Não
Não
Rotacionar API key do site
Sim
Sim
Não
Não
Gerenciar membros
Sim
Sim
Não
Não
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: /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
**Desativado**
O snippet para de operar e novos eventos CMP são bloqueados
Reative quando quiser voltar a coletar
**Verified**
O site recebeu pelo menos um evento válido
Use dashboard e logs para acompanhar
**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
**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
`success`
O sistema de destino recebeu o evento com sucesso
Nenhuma ação necessária
`failed`
Entrega falhou
Verifique URL, segredo, resposta HTTP e tente **Retry falhas**
Evento
Quando acontece
`boot`
O loader inicia no site
`page_view`
Uma página é visualizada
`consent_created`
Um visitante registra a primeira decisão
`consent_updated`
Um visitante altera uma decisão anterior
`preferences_opened`
O painel de preferências é aberto
Evento
Uso
`consent_created`
Sincronizar primeira escolha do visitante com outro sistema
`consent_updated`
Sincronizar mudança de preferências
Abra o painel principal.
## Termos principais
URL: /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
Site
Domínio configurado para carregar o CMP
Sites
Snippet
Código instalado no `` do site
Instalação
Código do site
Código usado pelo snippet; rotacionar exige reinstalação
Instalação
Webhook
Envio de evento do Permito para outro sistema
Webhooks
Chave de leitura
Credencial para consultar dados do workspace via API
Configurações → Acesso API
Consent log
Evidência auditável de uma decisão de consentimento
Logs de consentimento
Draft
Alteração salva, ainda não publicada
Detalhe do site
Versão publicada
Configuração ativa no snippet
Detalhe do site, logs
Veja Status e eventos.
## Visão geral de conceitos
URL: /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
Site
Domínio onde o banner será instalado
Sites
Domínio raiz
Domínio principal autorizado para o CMP
Novo site, detalhe do site
Snippet
Código que deve ser instalado no `` do site
Aba **Instalação**
Draft
Alteração salva, ainda não publicada
Detalhe do site e políticas
Versão publicada
Configuração ativa para visitantes
Site, logs, dashboard
Consent log
Registro auditável de uma escolha do visitante
Logs de consentimento
Webhook
Envio automático de eventos para outro sistema
Site, Webhooks
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.
## Aceitar convite
URL: /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
Aceito
Convite já foi usado
Acesse o workspace normalmente
Expirado
Prazo terminou
Peça novo convite
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
Convite expirado
Prazo acabou
Peça novo convite
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: /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
Usuário
Pessoa que edita draft e acompanha operação
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
Sem permissão
Seu perfil não gerencia membros
Peça ajuda a `owner` ou `admin`
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: /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`
Ser responsável principal pelo workspace
`owner`
Editar textos e regras, mas não publicar
`user`
Consultar dashboard e logs
`viewer`
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: /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: /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
`admin`
Gerencia membros, sites, webhooks e exportações
`user`
Edita configurações permitidas e acompanha operação
`viewer`
Visualiza dados sem editar
Convidar usuários
Entender perfis
Remover acesso
## Auditar consentimentos
URL: /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: /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.
Salvar draft.
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.
Clique em **Salvar draft**.
Revise a prévia.
Clique em **Publicar**.
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
Banner antigo aparece
Configuração não foi publicada
Clique em **Publicar**
Eventos bloqueados
Site está desativado
Reative o site
Depois de operar o primeiro site, configure webhooks ou publique políticas.
## Configurar webhooks
URL: /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: /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 draft.
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.
Clique em **Salvar draft**.
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: /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
Publicação bloqueada
Salvamento falhou antes de publicar
Corrija o conteúdo e tente salvar novamente
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: /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**
**Membros**
Atalho para gestão de membros
**Abrir workspace**
**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: /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
Versão publicada
Versão ativa da configuração
Use para auditoria e validação
**Políticas (beta)**
Abre políticas vinculadas ao site
Crie e publique documentos legais
**Webhooks**
Abre endpoints e entregas de webhooks
Investigue falhas
**Salvar draft**
Salva alterações sem publicar
Use antes de revisar
**Publicar**
Torna o draft ativo
Restrito a `owner` e `admin`
**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
**Regras**
Configurar padrão de Analytics e Marketing
**Design & preview**
Ajustar posição, tema, lado e cores do banner
**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
**Texto descritivo**
Explicação do uso de cookies
Evite linguagem jurídica excessiva
**URL política de privacidade**
Link legal mostrado no banner
Use URL pública e válida
**URL política de cookies**
Link da política de cookies
Pode ser uma política publicada no Permito
**Analytics default**
Estado padrão da categoria Analytics
Normalmente desligado por padrão
**Marketing default**
Estado padrão da categoria Marketing
Normalmente desligado por padrão
**Posição**
Local do banner
Escolha o formato menos intrusivo possível
**Código do site**
Código usado pelo snippet
Rotacionar exige reinstalar o snippet
Verifique se:
O draft foi salvo sem erro.
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: /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
Data final
Define o fim do período
Host
Filtra por domínio ou subdomínio
Ação
Filtra por aceitar, recusar, personalizar ou reabrir preferências
Coluna
O que significa
**Timestamp**
Data e hora do evento
**Host**
Domínio onde o evento aconteceu
**Visitor**
Identificador pseudônimo do visitante
**Action**
Tipo de decisão ou ação
**State**
Estado das categorias Essential, Analytics e Marketing
**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: /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
**Sites**
Criar sites, configurar banner e instalar snippet
**Logs de consentimento**
Consultar e exportar registros de consentimento
**Políticas**
Gerenciar documentos legais
**Planos**
Consultar plano, limites, uso do mês e assinatura
**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
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: /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
Sites
Todos os sites ou seleção por checkbox
Restrinja a análise quando necessário
KPIs
Page views, decisões e taxas
Avalie adoção e comportamento de consentimento
Gráfico
Série de page views e decisões
Compare atividade ao longo do tempo
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
**Decisões totais**
Soma de aceitações, recusas e personalizações
**Cobertura de consentimento**
Relação entre decisões e page views
**Acceptance rate**
Percentual de decisões com aceite total
**Reject rate**
Percentual de decisões com recusa total
**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
Filtrar sites
Ver todos os sites ou apenas alguns
Todos os perfis com acesso ao workspace
Exportar CSV do gráfico
Baixar a série exibida no dashboard
Usuários que conseguem acessar o dashboard
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: /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
Busca
Campo para buscar por título ou tipo
Encontre documentos existentes
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: /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
Busca
Campo **Buscar por nome ou domínio...**
Encontre sites rapidamente
Filtro de exibição
**Todos**, **Ativos**, **Desativados**
Controle quais sites aparecem
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`
Buscar
Filtrar por nome ou domínio
Todos
Filtrar status
Ver ativos, desativados ou todos
Todos
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
**Unverified**
O site ainda não recebeu evento válido
**Ativo**
CMP público pode operar
**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
Vazio
Nenhum site corresponde ao filtro
Altere o filtro ou crie um site
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.
## Código do site
URL: /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: /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
**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: /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: /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
Código do site
**Sites → \[site] → Instalação**
Rotacionar o código usado pelo snippet
Webhooks
**Sites → \[site] → Webhooks**
Enviar eventos de consentimento
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: /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: /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
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: /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
Decisões totais
Acompanhe volume de escolhas
Cobertura de consentimento
Compare decisões com visualizações
Acceptance rate
Avalie aceitação total
Reject rate
Monitore recusas
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: /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
`admin`
Ver e exportar
`user`
Ver
`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: /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
Privacidade
Explicar tratamento de dados pessoais
Termos
Explicar regras de uso
Perfil
O que pode fazer
`owner`, `admin`, `user`
Criar, editar e publicar políticas
`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: /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
**Salvar draft**
Salva alterações sem publicar
**Publicar**
Ativa a configuração para visitantes
**Desativar site**
Bloqueia snippet/config/eventos públicos
**Copiar snippet**
Copia código para instalar no site
**Adicionar webhook**
Registra uma URL de integração
Perfil
O que pode fazer
`owner` e `admin`
Criar, publicar, ativar/desativar, webhooks e chaves
`user`
Editar draft e visualizar dados
`viewer`
Visualizar dados
Erro
Como resolver
Site duplicado
Use o cadastro existente ou outro domínio
Sem permissão para criar
Peça acesso `owner` ou `admin`
Site desativado não coleta
Reative antes de validar eventos
Siga Criar site.
## Webhooks
URL: /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
Detalhe do webhook
`/sites/[siteId]/webhooks/[webhookId]`
Ver entregas, falhas, tentativas e resposta HTTP
`consent.created`
`consent.updated`
Veja Configurar webhooks.
## Workspaces
URL: /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
Criar workspace
Seletor no topo do menu lateral → **Novo workspace**
Editar dados
**Configurações → Geral**
Convidar membros
**Configurações → Membros**
Criar chaves de API
**Configurações → Acesso API**
Excluir workspace
**Configurações → Geral**
Campo
O que significa
**Nome do workspace**
Nome visível para a equipe
**Descrição**
Contexto opcional sobre o uso do workspace
**Slug**
Identificador amigável; pode ser gerado automaticamente
Perfil
O que pode fazer
`owner`
Gerencia workspace, membros e exclusão
`admin`
Gerencia workspace e membros
`user`
Acessa workspace e recursos permitidos
`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: /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: /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.
**Acompanhar assinatura**
Use **Gerenciar assinatura** para revisar informações disponíveis sobre cobrança e assinatura.
**Cancelar assinatura**
Use **Gerenciar assinatura** e siga as etapas indicadas pelo Provedor de pagamentos.
**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: /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.
**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: /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.
**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: /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`
**Invalid credentials**
E-mail ou senha não conferem
Revise os dados ou use recuperação de senha
Link de redefinição inválido
Token ausente, expirado ou já usado
Solicite um novo link em `/forgot-password`
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: /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
**Recusar tudo**
Visitante recusou categorias opcionais
**Personalizar**
Visitante escolheu preferências por categoria
**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
Logs vazios
Filtros muito restritos
Amplie o período ou remova filtro de host/ação
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: /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`
Não consigo excluir o workspace
Apenas `owner` pode excluir
Peça ao owner para executar a ação
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: /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
Site duplicado
O domínio raiz já existe no workspace
Abra o site existente ou use outro domínio
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: /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: /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: /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 o draft 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**.
**Botão preferências**.
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 **Salvar draft** para gravar as alterações.
Clique em **Publicar** para 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
O draft foi salvo, mas não publicado
Clique em **Publicar**
Botão **Publicar** está desabilitado
Seu perfil não é `owner` nem `admin`
Peça publicação a um administrador
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: /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.
Salve o draft e 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
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
O banner não muda depois de editar
A alteração foi salva como draft, mas não publicada
Clique em **Publicar** na tela do site
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: /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
Domínio raiz
Domínio autorizado para CMP
Sim
Idioma padrão
Idioma inicial da configuração
Sim
Site key
Chave pública do snippet
Gerado
Versão publicada
Versão ativa do banner
Gerado
Campo
O que significa
Título do banner
Título mostrado ao visitante
Texto descritivo
Explicação sobre cookies
Botão aceitar
Texto do aceite total
Botão recusar
Texto da recusa total
Botão preferências
Texto para abrir preferências
URL política de privacidade
Link legal de privacidade
URL política de cookies
Link legal de cookies
Campo
O que significa
Timestamp
Momento do evento
Host
Domínio ou subdomínio
Visitor
Identificador pseudônimo
Action
Ação do visitante
State
Estado por categoria
Config
Versão da configuração
Veja Mensagens do sistema.
## Glossário
URL: /docs/referencia/glossario
Entenda os principais termos usados no Permito.
Termo
Significado
Onde aparece
Acceptance rate
Taxa de aceite total
Dashboard
API Access
Área de chaves de leitura do workspace
Configurações
CMP
Plataforma de gestão de consentimento
Produto
Versão da configuração
Versão do banner registrada no evento
Logs
Consent log
Registro auditável de consentimento
Logs
Customize rate
Taxa de personalização
Dashboard
Domain root
Domínio raiz autorizado
Sites
Draft
Alteração salva, não publicada
Sites, políticas
URL de destino
URL que recebe webhooks
Webhooks
Segredo do webhook
Valor usado para proteger a integração
Integrações
Host
Domínio onde o evento ocorreu
Logs
Page view
Visualização de página
Dashboard
Reject rate
Taxa de recusa total
Dashboard
Site key
Chave pública usada no snippet
Snippet
Snippet
Script instalado no site
Instalação
Visitor ID
Identificador pseudônimo do visitante
Logs
Workspace
Ambiente que separa dados e membros
Menu
Veja Status e estados.
## Mensagens do sistema
URL: /docs/referencia/mensagens-do-sistema
Entenda mensagens comuns de sucesso, erro e validação.
Mensagem
Significado
**Site criado**
O domínio foi cadastrado
**Draft salvo**
Alterações foram salvas, mas não publicadas
**Configuração publicada**
O banner publicado foi atualizado
**Webhook criado**
Endpoint registrado
**Convite enviado com sucesso**
Link de convite foi gerado/enviado
**Perfil atualizado com sucesso**
Dados da conta foram salvos
Mensagem
Como agir
**Falha ao criar site**
Revise nome, domínio e permissão
**Falha ao publicar**
Tente salvar draft antes e revise dados
**No permission**
Verifique seu perfil no workspace
**Site not found**
Confirme se está no workspace correto
**Invalid credentials**
Revise login e senha
**Email not verified**
Verifique ou reenvie o e-mail
Se a mensagem persistir, abra Solução de problemas.
## Segurança e dados
URL: /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: /docs/referencia/status-e-estados
Referência rápida dos status exibidos no Permito.
Status
Significado
Ativo
CMP público liberado
Desativado
CMP público bloqueado
Verified
Evento válido recebido
Unverified
Nenhum evento válido recebido
Status
Significado
Draft
Documento em edição
Publicado
Documento disponível por URL pública
Status
Significado
pending
Entrega aguardando
success
Entrega concluída
failed
Entrega falhou
Status
Significado
pending
Pode ser aceito
accepted
Já foi aceito
revoked
Foi cancelado
expired
Prazo expirou
Veja Campos importantes.
## Relatório do Dashboard
URL: /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
Decisões sem page views esperadas
Verifique período e site selecionado
Alta recusa
Revise texto, contexto e experiência
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: /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
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: /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
Failed
Entregas com falha
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: /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
Logs de consentimento
**Logs de consentimento**
Evidências individuais
CSV de logs
**Logs de consentimento → Exportar CSV**
Auditoria externa
Webhooks
**Sites → Webhooks**
Entregas e falhas
Veja Dashboard.
## Convite inválido
URL: /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: /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: /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: /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`
Publicar banner
`owner`, `admin`
Exportar logs
`owner`, `admin`
Gerenciar webhooks
`owner`, `admin`
Criar chaves de leitura
`owner`, `admin`
Convidar membros
`owner`, `admin`
Peça suporte se seu perfil está correto e a ação continua bloqueada.
## Site não verificado
URL: /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: /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: /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
Banner não aparece
Snippet não carrega
Logs ou dashboard vazios
Evento não aparece
Botão desabilitado ou erro 403
Sem permissão
Webhook com status `failed`
Webhook falhando
Link de convite inválido
Convite inválido
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: /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.
## Convidar membro
URL: /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: /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: /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 draft.
Perfil `owner` ou `admin` para publicar.
Acesse **Sites**.
Abra o site.
Edite **Conteudo & textos**.
Edite **Regras**.
Edite **Design & preview**.
Clique em **Salvar draft**.
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: /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: /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: /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: /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**
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.