> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Redação do histórico de conversas A redação do histórico de conversas detecta e remove informações confidenciais dos dados das suas conversas antes de serem armazenados, minimizando assim a exposição de entidades confidenciais e preservando registros úteis para revisão e análise. > **Info** > > Este recurso está disponível atualmente apenas para alguns clientes empresariais. Entre em contato com > [vendas](https://elevenlabs.io/contact-sales) para obter acesso. > **Warning** > > A redação do histórico de conversas reduz significativamente a exposição de entidades confidenciais, mas, como acontece com qualquer > serviço de detecção que opera com dados dinâmicos de usuários, a taxa de detecção não é de 100%. Portanto, > habilitar apenas este recurso **não garante conformidade** com regulamentações rigorosas, como a > [HIPAA](/docs/pt/eleven-agents/legal/hipaa). Para total conformidade, habilite o [Modo de retenção zero](/docs/pt/eleven-api/resources/zero-retention-mode). ## Visão geral Quando uma conversa termina, uma etapa de pós-processamento analisa a transcrição e o áudio em busca de entidades confidenciais. Todas as entidades detectadas são ocultadas antes que os dados da conversa sejam armazenados: * **Transcrições e análises**: As ocorrências de entidades são substituídas por `[ENTITY_NAME]` (por exemplo, `[NAME]`, `[EMAIL_ADDRESS]`). * **Áudio**: As ocorrências de entidades são substituídas por um som de bip. * **Webhooks**: Os webhooks de transcrição e áudio também contêm dados ocultados. > **Note** > > Para ocultar entradas do teclado do chamador sem detecção de entidades, habilite a redação de [entrada DTMF](/docs/pt/eleven-agents/customization/multimodal-input#dtmf-input) no agente. > **Note** > > Como o pós-processamento é executado após o término da conversa, haverá um breve atraso antes que a > conversa apareça no seu histórico. ## Configuração As configurações de redação ficam na seção **Privacidade**, na parte inferior da guia **Avançado** do seu agente. A configuração de redação tem dois campos: | Campo | Tipo | Descrição | | ---------- | -------------- | ----------------------------------------------------------------------------------------------------------------- | | `enabled` | `boolean` | Define se entidades confidenciais devem ser ocultadas do histórico de conversas. | | `entities` | `list[string]` | Lista dos tipos de entidade a ocultar. Veja as [entidades compatíveis](#supported-entities) para valores válidos. | ## Como a redação funciona ### Formato do marcador Cada entidade ocultada é substituída pelo nome do tipo entre colchetes e em letras maiúsculas. Por exemplo, se `email_address` estiver configurado, um e-mail como `john@example.com` na transcrição se tornará `[EMAIL_ADDRESS]`. ### Entidades pai e filho As entidades seguem uma hierarquia usando notação por pontos. Você pode configurar a redação em qualquer nível: * **Entidade pai** (por exemplo, `name`): Oculta todas as entidades filho abaixo dela. Todas as correspondências usam o marcador da entidade pai — por exemplo, tanto nomes próprios quanto sobrenomes são substituídos por `[NAME]`. * **Entidade filho** (por exemplo, `name.name_given`): Oculta apenas esse tipo específico usando seu próprio marcador, `[NAME_GIVEN]`. Se você informar uma entidade pai e uma de suas entidades filho, a entrada da entidade filho será ignorada, pois a entidade pai já a abrange. ### Exemplo Configurar `["name", "email_address", "financial_id.payment_card.payment_card_number"]` fará o seguinte: * Substituir todos os nomes (próprios, de família e outros) por `[NAME]` * Substituir endereços de e-mail por `[EMAIL_ADDRESS]` * Substituir números de cartões de pagamento por `[PAYMENT_CARD_NUMBER]` ## Entidades compatíveis ### Nome | Entidade | Descrição | | ------------------ | --------------------------------------------------------------------------------------------------------------------- | | `name` | Todos os tipos de nome (próprio, de família, outros). | | `name.name_given` | Nomes atribuídos a uma pessoa, geralmente ao nascer. Costumam ser o primeiro e o nome do meio em culturas ocidentais. | | `name.name_family` | Nomes que indicam a família ou comunidade de uma pessoa. Costumam ser sobrenomes em culturas ocidentais. | | `name.name_other` | Títulos, sufixos, apelidos, nomes parciais, iniciais e outros componentes de nomes. | ### Contato | Entidade | Descrição | | ---------------- | ---------------------------------------------------------------------------------- | | `email_address` | Endereços de e-mail em qualquer formato, incluindo versões escritas por extenso. | | `contact_number` | Números de fax, telefone ou celular em qualquer formato nacional ou internacional. | ### Informações pessoais | Entidade | Descrição | | -------------------- | ------------------------------------------------------------------------- | | `dob` | Datas explicitamente identificadas como datas de nascimento. | | `age` | Números associados à idade de uma pessoa. | | `religious_belief` | Termos que indicam afiliação ou crença religiosa. | | `political_opinion` | Termos referentes à filiação partidária, movimento ou ideologia política. | | `sexual_orientation` | Termos que indicam orientação sexual. | | `ethnicity_race` | Termos que indicam nacionalidade, etnia, raça ou origem cultural. | | `marital_status` | Termos que indicam estado civil. | | `occupation` | Cargos ou profissões. | | `physical_attribute` | Características físicas distintas, incluindo altura, peso e descrições. | | `language` | Nomes de idiomas naturais. | ### Credenciais | Entidade | Descrição | | ---------- | ------------------------------------------------------------------------------------- | | `username` | Nomes de usuário, nomes de login ou identificadores. | | `password` | Senhas de conta, PINs, códigos de acesso, chaves de acesso ou respostas de segurança. | ### Web | Entidade | Descrição | | -------- | ----------------------------- | | `url` | Endereços e URLs da internet. | ### Organização | Entidade | Descrição | | -------------- | ----------------------------------------------------------------- | | `organization` | Nomes de organizações ou departamentos dentro de uma organização. | ### Identificadores financeiros | Entidade | Descrição | | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | `financial_id` | Todos os tipos de identificadores financeiros abaixo. | | `financial_id.payment_card` | Todos os campos de cartão de pagamento abaixo. | | `financial_id.payment_card.payment_card_number` | Números de cartões de pagamento / números de conta primária (PAN). | | `financial_id.payment_card.payment_card_expiration_date` | Datas de validade de cartões de pagamento. | | `financial_id.payment_card.payment_card_cvv` | Valores de verificação do cartão com 3 ou 4 dígitos. | | `financial_id.bank_account` | Todos os campos de conta bancária abaixo. | | `financial_id.bank_account.bank_account_number` | Números de contas bancárias, incluindo IBANs. | | `financial_id.bank_account.bank_routing_number` | Números de roteamento bancário (números ABA de trânsito e roteamento). | | `financial_id.bank_account.swift_bic_code` | Códigos SWIFT/BIC para identificação bancária internacional. | | `financial_id.financial_id_other` | Outros identificadores financeiros, como sort codes, números BSB, CLABE, endereços de carteiras de criptomoedas etc. | ### Localização | Entidade | Descrição | | ------------------------------- | ---------------------------------------------------------------------------- | | `location` | Todos os tipos de localização abaixo. | | `location.location_address` | Endereços de rua sem componentes de cidade, estado ou código postal. | | `location.location_city` | Nomes de municípios, incluindo vilas, cidades e metrópoles. | | `location.location_postal_code` | Códigos postais e CEPs. | | `location.location_coordinate` | Posições geográficas usando latitude, longitude e/ou elevação. | | `location.location_state` | Nomes de estados, províncias, territórios ou prefeituras. | | `location.location_country` | Nomes de países. | | `location.location_other` | Pontos de referência, bairros, condados, distritos, regiões e outros locais. | ### Data | Entidade | Descrição | | --------------- | ------------------------------------------------------------------------------------- | | `date` | Datas específicas do calendário, incluindo dias da semana, meses ou anos. | | `date_interval` | Períodos mais amplos, incluindo intervalos de datas, meses, estações, anos e décadas. | ### Identificadores exclusivos | Entidade | Descrição | | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- | | `unique_id` | Todos os tipos de identificadores exclusivos abaixo. | | `unique_id.government_issued_id` | Identificadores emitidos pelo governo, como SSNs, números de passaporte, números de carteira de motorista e equivalentes internacionais. | | `unique_id.account_number` | Números de identificação de conta de cliente ou associação. | | `unique_id.vehicle_id` | Números de identificação de veículos (VINs), números de série e números de placas. | | `unique_id.healthcare_number` | Todos os tipos de números de saúde abaixo. | | `unique_id.healthcare_number.medical_record_number` | Códigos ou IDs exclusivos atribuídos a pacientes por profissionais de saúde. | | `unique_id.healthcare_number.health_plan_beneficiary_number` | IDs atribuídos por empresas de seguro de saúde ou programas governamentais de saúde. | | `unique_id.device_id` | Identificadores de dispositivos, como endereços MAC, números IMEI e números de série. | | `unique_id.unique_id_other` | Outros identificadores exclusivos, como IDs fiscais e números de rastreamento. | ### Médico | Entidade | Descrição | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | `medical` | Todos os tipos médicos abaixo. | | `medical.medical_condition` | Doenças, lesões, sintomas, diagnósticos, transtornos e condições crônicas. | | `medical.medication` | Prescrições, vitaminas, suplementos, medicamentos, dosagens e produtos farmacêuticos. | | `medical.medical_procedure` | Cirurgias, tratamentos, intervenções e terapias. | | `medical.medical_measurement` | Sinais vitais, resultados laboratoriais, tipo sanguíneo, resultados de exames e medições vinculadas a uma pessoa específica. | | `medical.medical_other` | Alergias, dispositivos médicos e outras informações relacionadas à saúde. | ## Boas práticas * **Habilite apenas as entidades de que você precisa.** A taxa de detecção melhora quando menos tipos de entidades são configurados. Restringir o conjunto de entidades reduz a ambiguidade e aumenta a precisão da detecção. * **Consulte os exemplos e as descrições.** Use os exemplos ao lado das entidades na folha de seleção de entidades e as descrições acima ou as dicas na folha para entender o que cada entidade oculta. ## Comparação com o Modo de retenção zero A redação do histórico de conversas e o [Modo de retenção zero](/docs/pt/eleven-api/resources/zero-retention-mode) protegem dados confidenciais, mas funcionam de maneiras diferentes e atendem a necessidades distintas. | | **Redação do histórico de conversas** | **[Modo de retenção zero](/docs/pt/eleven-api/resources/zero-retention-mode)** | | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | Como funciona | Detecta e substitui tipos específicos de entidade nos dados armazenados | Descarta todos os dados da conversa — nada é armazenado ou registrado | | Cobertura de detecção | Alta, mas não de 100% | 100% — todo o áudio e a transcrição são descartados | | Conformidade com a [HIPAA](/docs/pt/eleven-agents/legal/hipaa) | Não é garantida por si só | Pode viabilizar a conformidade com a [HIPAA](/docs/pt/eleven-agents/legal/hipaa) | | Acesso ao histórico de conversas | Disponível para usuários do workspace e administradores da ElevenLabs na página de histórico de conversas | É necessário configurar um endpoint HTTP para receber [webhooks pós-chamada](/docs/pt/eleven-agents/workflows/post-call-webhooks) | | Depuração | As conversas podem ser revisadas e depuradas | Não há dados armazenados para revisar | | Cargas úteis de webhook | Ocultadas | Não armazenadas — é necessário recuperá-las pelo seu próprio endpoint | | Acesso de administradores da ElevenLabs | Administradores podem acessar logs internos que contêm dados não ocultados | Administradores não podem acessar dados da conversa | ## Perguntas frequentes #### O que acontece se a detecção de entidades falhar? Se ocorrer um erro durante a detecção de entidades, o sistema recorre ao comportamento do [Modo de retenção zero](/docs/pt/eleven-api/resources/zero-retention-mode), no qual nenhum dado da conversa é armazenado. #### A redação impede que a ElevenLabs acesse os dados da conversa? Não. A redação se aplica ao histórico de conversas armazenado e visível para você. A ElevenLabs ainda pode ter acesso aos dados da conversa por meio de logs internos. Para evitar isso, habilite o [Modo de retenção zero](/docs/pt/eleven-api/resources/zero-retention-mode). #### Por que há um atraso antes de minha conversa aparecer? Quando a redação está habilitada, uma etapa de pós-processamento é executada após cada conversa para detectar e ocultar entidades. Isso introduz um breve atraso antes que a conversa apareça no seu histórico. #### Haverá mais opções de configuração disponíveis? Sim. Este recurso está em estágios iniciais, e opções de configuração mais flexíveis serão compatíveis no futuro. #### Por que esse recurso é útil se não garante a conformidade com a HIPAA? **Limita a exposição interna:** A redação do histórico de conversas garante que ninguém no seu workspace possa ver entidades confidenciais no histórico de conversas. **Demonstra boas práticas no tratamento de dados:** Clientes e auditores consideram a redação um sinal positivo de que sua organização toma medidas razoáveis para proteger informações confidenciais enquanto mantém dados de conversas para monitoramento e aprimoramento. **Preserva o acesso para depuração:** Diferentemente do Modo de retenção zero, a redação mantém o histórico de conversas disponível para revisão, permitindo que sua equipe monitore o desempenho do agente, investigue problemas e faça ajustes sem abrir mão por completo dos controles de privacidade. #### Posso habilitar o Modo de retenção zero e a redação do histórico de conversas ao mesmo tempo? Sim. Quando ambos estão habilitados, os dados da conversa não são armazenados, mas seus [webhooks de transcrição e áudio pós-chamada](/docs/pt/eleven-agents/workflows/post-call-webhooks) terão as entidades confidenciais ocultadas.