Registros de auditoria

Acompanhe as atividades suportadas na sua organização Enterprise com registros de auditoria entregues por webhook.

​

Visão geral

Os registros de auditoria estão disponíveis para organizações Enterprise com 50 licenças ou mais, ou com pelo menos uma licença do Enterprise Max. Os administradores podem usá-los para investigar atividades e monitorar alterações administrativas.

Você pode receber eventos registrados por webhook. O texto das consultas e das respostas é limitado aos primeiros 500 caracteres.

Os registros de auditoria não capturam todas as ações. Os registros de auditoria não registram alterações de nível das licenças feitas por SCIM, que sincroniza os membros com seu provedor de identidade, ou por ferramentas de operações em massa. Adições e remoções de membros feitas por operações em massa com CSV também são excluídas.

​

Antes de começar

• Confirme se sua organização atende ao requisito de licenças acima.
• Peça a um administrador com acesso às configurações da organização para ativar o registro.
• Para entrega por webhook, prepare um endpoint HTTPS e um valor de autenticação.

​

Privacidade e segurança dos dados

Os payloads dos webhooks podem conter informações pessoais e conteúdo registrado, não apenas identificadores de atividade. Dependendo do evento, os metadados podem incluir o texto das consultas e das respostas, nomes de arquivos, e-mails dos membros afetados, valores das configurações da organização e detalhes de tarefas do Perplexity Computer.

Restrinja o acesso aos registros coletados de acordo com as políticas de privacidade da sua organização. Mantenha em sigilo as URLs dos webhooks e os valores de autenticação.

Para saber mais sobre as práticas de dados do Enterprise em geral, consulte Retenção de dados e privacidade para o Enterprise. A Central de confiança fornece documentação de segurança e conformidade, e o Adendo de processamento de dados estabelece os termos contratuais de processamento de dados quando incorporado ao seu contrato.

​

Ativar registros de auditoria

1. Acesse Configurações da Organização.

2. Abra Dados e privacidade.

3. Em Configurações do log de auditoria, ative Ativar registro de auditoria.

   

   Figura 1: O controle Ativar registro de auditoria nas configurações do log de auditoria.

Para a entrega por webhook, conclua estas etapas:

1. Insira seu endpoint HTTPS em URL do webhook.

   

   Figura 2: Configurações de URL do webhook e cabeçalho de autorização.

2. Clique em Salvar ao lado de URL do webhook.

3. Se seu endpoint exigir autenticação, insira o valor em Cabeçalho de autorização.

4. Clique em Salvar ao lado de Cabeçalho de autorização.

A menos que você especifique um esquema de autorização, o valor inserido será enviado como um token Bearer. Consulte Autenticação de webhook para conhecer os dois formatos compatíveis.

​

Como verificar se funcionou

Após uma ação suportada, confirme se o endpoint receptor recebe um evento de webhook e retorna uma resposta HTTP 2xx.

​

Autenticação de webhook

Você pode proteger seu endpoint de webhook com um token Bearer ou um valor de autorização completo. Configure o valor esperado pelo endpoint receptor.

​

Token Bearer

Forneça um token sem prefixo, como YOUR_WEBHOOK_TOKEN. A Perplexity adiciona Bearer antes do token e envia Authorization: Bearer YOUR_WEBHOOK_TOKEN.

​

Cabeçalho de autorização personalizado

Forneça um valor de autorização completo que inclua seu esquema. Por exemplo, Splunk YOUR_HEC_TOKEN é enviado como Authorization: Splunk YOUR_HEC_TOKEN.

​

Entrega de webhook

​

Formato da solicitação

Os registros de auditoria são entregues à URL do seu webhook como solicitações HTTP POST. O corpo da solicitação usa application/json.

​

Cabeçalho de autenticação

Se você configurou um valor de autenticação, a Perplexity o inclui no cabeçalho Authorization. Consulte Autenticação de webhook para conhecer os formatos Bearer e de esquema personalizado.

​

Tratamento de respostas

Seu endpoint de webhook deve retornar uma resposta HTTP 2xx para confirmar o recebimento em até 1 segundo. A Perplexity registra erros de entrega, incluindo respostas HTTP 4xx e 5xx, mas não repete automaticamente entregas que falharam ou excederam o tempo limite. Monitore o endpoint receptor para identificar falhas e eventos ausentes.

​

Esquema do registro de auditoria do webhook

Os eventos de webhook usam os campos abaixo.

Campo	Tipo	Obrigatório	Descrição
uuid	String	Sim	Identificador do evento
timestamp	String	Sim	Carimbo de data/hora RFC 3339
event_type	String	Sim	Tipo de evento
user_email	String	Sim	E-mail do membro que realizou a ação
ip_address	String	Sim	Endereço do cliente ou marcador que não é um IP
user_agent	String	Sim	Agente de usuário do cliente
session_id	String ou nulo	Não	Identificador de eventos relacionados
user_id	String ou nulo	Não	Identificador do usuário, quando registrado
metadata	Objeto ou nulo	Não	Dados específicos do evento

Tabela 1: Campos do payload do webhook.

Um campo string obrigatório pode estar vazio quando nenhum valor foi registrado. Não presuma que todo valor de ip_address seja um endereço IP.

​

Tipos de evento

As tabelas a seguir descrevem os tipos de eventos de webhook documentados, sem garantir que todas as ações sejam registradas.

​

Eventos de atividade do usuário

Tipo de evento	Descrição
login	Login bem-sucedido
query	Consulta de pesquisa enviada
answer_generated	Resposta retornada
file_upload	Arquivo enviado para uma consulta ou projeto
file_download	Arquivo baixado de um projeto
file_delete	Arquivo excluído de uma consulta ou projeto

Tabela 2: Eventos de atividade do usuário.

Os eventos de consulta podem incluir metadata.attachments, com file_uuid e file_name para cada arquivo anexado.

​

Eventos de tópicos

Tipo de evento	Descrição
thread_forked	Tópico copiado
thread_exported	Tópico exportado
thread_shared	Tópico compartilhado
thread_deleted	Tópico excluído

Tabela 3: Eventos de tópicos.

​

Eventos de associação

Tipo de evento	Descrição
member_invited	Membro convidado
member_invite_rescinded	Convite pendente revogado
member_removed	Membro removido
member_role_changed	Função do membro alterada

Tabela 4: Eventos de associação.

​

Eventos da organização

Tipo de evento	Descrição
organization_settings_update	Configuração da organização alterada

Tabela 5: Eventos da organização.

​

Eventos de funções e grupos

Tipo de evento	Descrição
role_created	Função personalizada criada
role_updated	Detalhes ou permissões da função atualizados
role_deleted	Função personalizada excluída
role_users_changed	Usuários adicionados a uma função ou removidos dela
role_groups_changed	Grupos adicionados a uma função ou removidos dela
group_created	Grupo de usuários criado
group_deleted	Grupo de usuários excluído
group_members_changed	Composição do grupo alterada

Tabela 6: Eventos de funções e grupos.

Para role_users_changed e role_groups_changed, os metadados podem incluir um valor de action igual a added ou removed. Use esse campo para distinguir se a alteração de associação é uma adição ou uma remoção.

​

Eventos do agente do Comet

Tipo de evento	Descrição
comet_agent_action	Ação automatizada do Comet

Tabela 7: Eventos do agente do Comet.

​

Eventos de conectores

Tipo de evento	Descrição
connector_connected	Conector de terceiros conectado
connector_disconnected	Conector de terceiros desconectado

Tabela 8: Eventos de conectores.

​

Eventos do Computer

Tipo de evento	Descrição
computer_task_started	Tarefa do Computer iniciada
computer_agent_action	Ação automatizada durante uma tarefa
computer_task_completed	Tarefa concluída com sucesso
computer_task_error	Tarefa falhou com um erro

Tabela 9: Eventos do Computer.

​

Exemplo de payload do webhook

Este payload JSON ilustrativo representa um evento de consulta entregue a um webhook genérico.

{
  "uuid": "6ba7b810-9dad-41d1-80b4-00c04fd430c8",
  "timestamp": "2026-10-28T09:05:31+00:00",
  "event_type": "query",
  "user_email": "[e-mail]",
  "ip_address": "203.0.113.45",
  "user_agent": "ExampleClient/1.0",
  "session_id": "query_abc123",
  "metadata": {
    "query_str": "What are the best practices for API security?"
  }
}

​

Formatação específica da plataforma

​

Webhooks do Slack

Para uma URL de webhook que começa com https://hooks.slack.com, a Perplexity usa o formato Block Kit do Slack. O array blocks contém seções para o tipo de evento, os detalhes do membro e do cliente e os metadados do evento, quando presentes.

Os rótulos de tipo de evento usam iniciais maiúsculas nas palavras e removem os sublinhados. A formatação do Slack trunca os valores individuais de metadados em 500 caracteres e a seção de metadados em 2.500 caracteres, com um aviso de truncamento para valores longos.

​

Coletor de eventos HTTP do Splunk

Quando o valor de autorização começa com Splunk, a Perplexity encapsula o payload em um objeto event para o Coletor de eventos HTTP (HEC) do Splunk. Este exemplo ilustrativo mostra essa estrutura:

{
  "event": {
    "uuid": "a1b2c3d4-e5f6-4789-abcd-ef1234567890",
    "timestamp": "2026-10-28T09:05:31+00:00",
    "event_type": "login",
    "user_email": "[e-mail]",
    "ip_address": "203.0.113.45",
    "user_agent": "ExampleClient/1.0",
    "session_id": null,
    "metadata": {}
  }
}

​

Webhooks genéricos

Para outros destinos de webhook, a Perplexity envia o payload JSON padrão sem um envelope específico da plataforma. Consulte Exemplo de payload do webhook para conhecer o formato.

​

Cenários comuns de webhook

​

Acompanhar sessões de pesquisa

Use session_id para correlacionar uma consulta com sua resposta.

1. Encontre o evento de consulta

   Leia query_str nos metadados do evento. Anote seu session_id para encontrar eventos relacionados.

2. Identifique o evento de resposta correspondente

   Encontre o evento answer_generated com o mesmo session_id. Quando registrado, answer contém até os primeiros 500 caracteres da resposta, junto com o campo model, que identifica o modelo usado.

​

Monitorar o acesso a arquivos

Use identificadores de arquivos para correlacionar uploads e downloads. Os metadados dos eventos de webhook podem incluir detalhes registrados de arquivos e projetos.

1. Encontre o upload do arquivo

   Leia o file_uuid do evento de upload. Anote o identificador para comparação com os eventos seguintes.

2. Identifique os downloads correspondentes do arquivo

   Encontre eventos de download com o mesmo file_uuid. Use os campos de autor da ação e carimbo de data/hora para ver quem acessou o arquivo e quando.

​

Auditar alterações de configuração

Para organization_settings_update, o campo key da configuração identifica o que mudou. Os metadados do webhook podem incluir old_value e new_value.

Filtre os dados de webhook armazenados por user_email no seu próprio sistema de análise para acompanhar quais administradores fizeram alterações.

​

Práticas recomendadas

​

Implementar seu endpoint de webhook

• Responda prontamente: Confirme o recebimento em até 1 segundo.
• Processe de forma assíncrona: Coloque os eventos recebidos em uma fila para processamento.
• Valide os payloads: Verifique a estrutura e o conteúdo antes da ingestão.
• Proteja o endpoint: Use HTTPS e valide o valor de autenticação configurado.
• Monitore falhas: Registre erros no receptor e investigue lacunas na entrega.

​

Armazenar e analisar os registros coletados

• Defina uma política de retenção: Mantenha os registros coletados pelo período exigido pela sua organização.
• Indexe os campos relevantes: Use os campos de tipo de evento, autor da ação, carimbo de data/hora e sessão para análise.
• Correlacione atividades: Use session_id para conectar eventos relacionados.
• Monitore padrões: Investigue acessos ou alterações administrativas incomuns.
• Mantenha backups: Preserve cópias de acordo com as políticas de segurança e privacidade da sua organização.

​

Solução de problemas

Sintoma	Possível causa	Próxima etapa
Nenhum evento de webhook recebido	A configuração do registro ou do endpoint pode estar incompleta	Verifique se o registro está ativado e se um endpoint HTTPS foi salvo
O endpoint retorna HTTP 4xx ou 5xx	O endpoint receptor rejeitou a solicitação ou encontrou um erro	Examine os logs do receptor e o valor de autenticação configurado
Eventos ausentes após uma falha de entrega	Entregas com falha não são repetidas automaticamente	Monitore erros no receptor; não dependa de uma repetição automática

Tabela 10: Problemas comuns de entrega por webhook.

Ao entrar em contato com o suporte, inclua o erro exato, o horário do evento afetado ou da falha de entrega, o fuso horário e as etapas já tentadas. Omita valores de autenticação, tokens e conteúdo sensível dos eventos.

​

Perguntas frequentes

​

Posso usar os registros de auditoria com menos de 50 licenças?

Sim. Uma organização com menos de 50 licenças pode acessar os registros de auditoria se pelo menos uma licença estiver no plano Enterprise Max. Consulte O que é o Enterprise Max? para saber os requisitos.

​

E se eu ativar os registros de auditoria por engano e receber uma cobrança inesperada?

Entre em contato com a equipe responsável pela sua conta ou use Ajuda > Entrar em contato com o suporte para analisar a cobrança e a possibilidade de reembolso. Consulte Reembolsos; desativar os registros de auditoria não garante o estorno de uma cobrança.

​

Referências relacionadas

• Funções e permissões do Enterprise
• O que é o Enterprise Max?
• Retenção de dados e privacidade para o Enterprise
• Retenção de dados para Enterprise

​

Precisa de mais ajuda?

Entre em contato com a equipe responsável pela sua conta ou fale conosco em Ajuda > Entrar em contato com o suporte. Acesse a Central de confiança para consultar a documentação de segurança e conformidade.