Exporte seus Teammates e Teammate activity logs para Amazon S3, Google Cloud Storage ou Azure Blob Storage junto com seus dados de conversas.
As exportações de dados agendadas antes cobriam apenas conversas. Agora você pode escolher quais objetos de dados cada exportação agendada inclui, e ter os dados dos colegas entregues ao seu próprio armazenamento em nuvem no mesmo cronograma que o restante.
Use para:
Revisões de acesso e evidências de auditoria — quem tem acesso ao seu workspace e o que mudou
Monitoramento de segurança — logins, mudanças de permissão e alterações de SSO no seu próprio SIEM (sistema de gerenciamento de informações e eventos de segurança)
Governança e retenção de dados junto com seus dados de conversas
Quais objetos de dados posso exportar?
A tabela abaixo descreve cada objeto de dados: o que contém e com que frequência é exportado.
Objeto de dados | Conteúdo | Como é exportado |
Conversas | Conversas e suas partes, incluindo autores, atribuições, tags e atributos personalizados. | Conversas novas e atualizadas a cada execução |
Teammates | Cada colega no workspace, com nome, endereço de e-mail e função. | Um snapshot completo a cada execução |
Teammate activity logs | Um registro da atividade da conta do colega, como logins, mudanças de permissão e alterações de SSO. | Atividades novas desde a execução anterior |
Cada objeto de dados é exportado como uma exportação própria no seu cronograma existente e entregue no mesmo bucket, em uma pasta separada por objeto. As execuções são rastreadas separadamente, então um problema com um objeto de dados não impede os outros.
Os dados dos colegas são exportados em JSON ou JSONL (JSON Lines — um formato onde cada linha é um objeto JSON separado, útil para streaming de grandes conjuntos de dados), usando o mesmo esquema dos endpoints List all admins e List all activity logs da Data API version configurada para sua exportação.
Onde os dados exportados dos colegas são armazenados no meu bucket?
Os dados dos colegas são gravados em uma pasta própria por objeto de dados, para que nunca se misturem com seus arquivos de conversas. Seus arquivos de conversas existentes não se movem — eles permanecem exatamente onde estão hoje, na raiz da sua pasta de exportação.
Os dados dos colegas são armazenados em subpastas dedicadas dentro do seu bucket de exportação existente, separadas dos seus arquivos de conversas, conforme mostrado abaixo.
Pasta | O que contém |
| Seus arquivos de conversas, inalterados |
| Teammates |
| Teammate activity logs |
Se você ativou Export data dated folders, a pasta de data fica dentro da pasta do objeto de dados, e não o contrário:
Pastas datadas | Caminho de exemplo |
Desligado |
|
Ligado |
|
Se você usar um glob no prefixo das conversas em um pipeline downstream, esse padrão continuará funcionando inalterado e não começará a capturar arquivos dos colegas.
Os nomes dos arquivos seguem a mesma convenção das exportações de conversas — <batch start>-<batch end>-<batch id> em UTC, com : substituído por -, e uma extensão .json ou .jsonl que corresponde ao seu Formato de saída.
Quantos arquivos por execução:
Teammates — um arquivo por execução, contendo toda a lista.
Teammate activity logs — um ou mais arquivos por execução, divididos em lotes como as conversas.
A data no nome da pasta é a data em que a exportação foi executada, não a data em que a atividade ocorreu.
O que preciso antes de exportar dados dos colegas?
Permissões. Você precisa de Gerenciar teammates e Ver todos os teammates e detalhes da equipe. Sem ambos, os objetos de dados dos colegas não são oferecidos.
Destino. Os objetos de dados de teammates estão disponíveis para AWS S3, Google Cloud Storage e Azure Blob Storage. Eles não estão disponíveis para destinos Snowflake Data Share.
Versão da Data API. Os logs de atividade de teammates exigem uma versão recente da Data API. Exportações fixadas em uma versão antiga não podem incluí-los.
Como exportar dados de teammates para armazenamento em nuvem
1. Vá para Configurações > Dados > Importações & exportações > Exportar dados e abra sua exportação de dados existente ou selecione Nova exportação de dados.
Se você estiver criando uma nova exportação, siga Exportar dados de conversas para armazenamento em nuvem para configurar sua Data API version, Formato de saída, opções de pasta, bucket de destino e agendamento primeiro.
2. Na seção Data objects, marque os objetos de dados que deseja exportar. Você pode escolher qualquer combinação.
Uma exportação precisa de pelo menos um objeto de dados. A última caixa de seleção marcada restante é desativada — marque outro objeto de dados antes de removê-la.
3. Role até o final da página e clique em Atualizar (ou Iniciar exportação de dados para uma nova exportação).
4. Um diálogo de confirmação aparece sempre que os dados de teammates começam ou param de ser enviados. Existem duas versões dependendo se você está adicionando ou removendo um objeto de dados — leia o diálogo e clique em Salvar alterações.
Quando você adiciona dados de teammates, o diálogo confirma que eles serão incluídos a partir da próxima execução agendada, que são dados pessoais (nomes, endereços de e-mail e funções, além da atividade da conta, como logins, alterações de permissão e alterações de SSO), e que são gravados em um armazenamento que você controla — então o Intercom não pode recuperar ou excluir esses dados após a exportação.
Quando você remove um objeto de dados, o diálogo explica o que você pode recuperar:
Logs de atividade de teammates — se você os reativar dentro de alguns dias, a próxima exportação recupera os dados. Depois disso, apenas uma exportação histórica solicitada ao Intercom pode preencher a lacuna.
Teammates — cada execução exporta a lista completa, então reativá-los restaura os dados completos sem lacunas permanentes.
Uma gravação que adiciona e remove objetos de dados mostra um único diálogo cobrindo ambos. Clicar em Cancelar não envia nada e mantém sua seleção não salva na tela. Depois de salvar objetos de dados de teammates, você não será mais solicitado para alterações não relacionadas, como mudar o Formato de saída.
5. Após a próxima execução agendada, verifique seu bucket. Os dados de teammates aparecem em sua própria pasta por objeto de dados — admins/ e admin_activity_logs/.
6. Para confirmar que uma exportação foi executada, volte para Configurações > Dados > Importações & exportações > Exportar dados e verifique a aba Execuções. Cada linha é rotulada pelo seu objeto de dados — Conversas, Teammates ou Logs de atividade de teammates.
7. Para ver quem alterou a configuração da sua exportação e quando, vá para Configurações > Espaço de trabalho > Teammates > log de atividade e filtre para os eventos de exportação de dados. As entradas registram quais objetos de dados estavam envolvidos. Eventos registrados antes do lançamento desse recurso mantêm sua redação original, sem objetos de dados.
8. Para parar de exportar dados de teammates, desmarque os objetos de dados, clique em Atualizar e confirme. Excluir toda a exportação remove a configuração, mas não exclui arquivos já gravados no seu bucket.
Quais são as limitações atuais?
As seguintes limitações se aplicam às exportações de dados de teammates e logs de atividade para armazenamento em nuvem.
O Intercom não pode excluir arquivos exportados. Uma vez que os dados são gravados no seu bucket, o Intercom só pode gravar neles — não pode ler ou excluir. Solicitações de exclusão não podem ser propagadas para arquivos exportados, então remover dados de um teammate de arquivos já no seu bucket é sua responsabilidade. Isso é igual às exportações existentes de conversas.
Teammates é um instantâneo completo, não um delta. Cada execução exporta toda a sua lista em um único arquivo. Não há modo incremental ou apenas alterações, nem filtragem por teammate ou intervalo de datas.
Não há exportação histórica self-service para dados de teammates. Diferente das conversas, não há opção de retroativo de dois anos — os dados de teammates começam a ser enviados a partir da próxima execução agendada após a ativação. Se precisar de atividade anterior, contate o Suporte e o Intercom pode executar uma exportação histórica para você.
É necessário pelo menos um objeto de dados. Você não pode deixar uma exportação sem nada marcado.
Logs de atividade de teammates precisam de uma versão recente da Data API. Exportações fixadas em uma versão antiga não podem incluí-los.
Algumas atividades são anonimizadas. Quando uma ação foi realizada por uma conta que não está mais na lista de teammates do seu workspace, o ID e o endereço IP do ator não são incluídos. Os metadados do log de atividade são limitados a um conjunto selecionado de campos, então um log de atividade exportado pode conter menos detalhes do que o mesmo registro da Data API.
Um workspace por bucket. Como nas conversas, você não pode exportar múltiplos workspaces para o mesmo bucket.
Solução de problemas
Se algo parecer errado na configuração da sua exportação ou no histórico de execuções, use a tabela abaixo para diagnosticar.
O que você vê | O que significa |
As caixas de seleção de teammates estão ausentes, mas Conversas aparece | Você provavelmente está sem as permissões Gerenciar teammates e/ou Ver todos os teammates e detalhes da equipe. |
Uma caixa de seleção está desativada e não pode ser desmarcada | É o último objeto de dados restante. Marque outro primeiro. |
Uma caixa de seleção está marcada e desativada | A exportação já inclui esse objeto de dados, mas ele não pode ser alterado aqui — suas permissões ou a Data API version da exportação mudaram após a configuração. Peça a um teammate com permissões completas ou contate o Suporte. |
"Você precisa de permissão para gerenciar teammates e ver todos os teammates e detalhes da equipe..." | Você não tem ambas as permissões necessárias. Um administrador pode concedê-las em Configurações > Teammates. |
"Atualize a página para ver os tipos de objetos disponíveis..." | Os objetos de dados disponíveis mudaram desde que a página foi carregada, geralmente uma Data API version que não pode fornecer logs de atividade. Atualize e tente novamente, depois contate o Suporte se persistir. |
Uma execução aparece na aba Execuções mas nenhum arquivo chega ao seu bucket | Geralmente permissões do bucket. Refaça o teste com o botão Testar no seu destino, depois contate o Suporte. |
Algumas linhas do log de atividade não têm ator ou metadados vazios | Esperado — o teammate que realizou a ação não está mais na lista do seu workspace. |
Os metadados exportados diferem de | Esperado — as exportações usam um conjunto mais rigoroso e selecionado de campos de metadados do que a resposta da API. |
Você perdeu uma janela e precisa preenchê-la retroativamente | Contate o Suporte — O Intercom pode executar uma exportação histórica dos dados do seu colega e do log de atividades. |