Você está aqui:
Ingerir anexos de arquivo de objetos do Salesforce CRM para o Data 360
Use o conector do Salesforce CRM para ingerir arquivos de conteúdo do Data 360, como arquivos de documentação ou suporte ao cliente. Você pode ingerir arquivos de conteúdo anexados a objetos padrão e personalizados do CRM, incluindo 100 mil dos arquivos históricos carregados mais recentemente e todos os novos arquivos em andamento. O Data 360 converte o conteúdo em vetores pesquisáveis para IA generativa, análise e automação enquanto preserva o contexto da pesquisa.
Edições obrigatórias
| Disponível em: Todas as edições suportadas pelo Data 360. Consulte Disponibilidade da edição do Data 360. |
Como funciona a ingestão de anexo de arquivo
Quando você configura a ingestão de anexo de arquivo, o Data 360 ingere todos os arquivos anexados a objetos do CRM, independentemente de quando você criou a conexão com a organização do CRM e seus fluxos de dados. Os fluxos de dados relevantes são:
- Documento de conteúdo: Representa documentos carregados em uma biblioteca no Salesforce CRM.
- Versão do conteúdo: Representa a versão específica de um documento no Salesforce CRM.
- Link do documento de conteúdo: Representa um link para usuários, grupos, registros ou bibliotecas com os quais o arquivo é compartilhado.
Você pode ingerir anexos de arquivo dos tipos listados em Formatos de arquivo de dados não estruturados
Durante a configuração, instale um pacote de conteúdo para implementar os três fluxos de dados de conteúdo e, em seguida, crie um índice de pesquisa para habilitar a ingestão de anexos de arquivo. O índice de pesquisa aciona uma ingestão inicial de dia 0 de até 100.000 dos arquivos históricos mais recentes que foram anexados ao objeto CRM antes de você implementar o pacote de conteúdo. Esse limite de 100.000 se aplica a cada objeto do CRM, independentemente do número de índices de pesquisa criados. Após a ingestão inicial, todos os novos anexos de arquivo são ingeridos incrementalmente e os índices de pesquisa relevantes são atualizados automaticamente.
Os fluxos de dados ContentDocument, ContentVersion e ContentDocumentLink ingerem metadados para todos os arquivos. O limite de 100.000 se aplica apenas ao conteúdo do arquivo.
Se você tiver ingerido anexos de arquivo do CRM para o Data 360 antes de julho de 2026, o fluxo de dados ContentVersion se comportará de maneira diferente de outros objetos de conteúdo do CRM.
- ContentDocument e ContentDocumentLink (dados estruturados) ingerem todo o conteúdo durante a ingestão inicial.
- O ContentVersion (conteúdo de arquivo não estruturado) ingere apenas cinco versões que você cria ou atualiza depois de criar o fluxo de dados. Para acionar a ingestão de arquivo de histórico, exclua o fluxo de dados ContentVersion existente e implemente o content_bundle padrão. Em seguida, crie novos objetos do Salesforce com anexos de arquivo ou use os anexos existentes para os objetos existentes do Salesforce.
- A ingestão de anexo de arquivo não oferece suporte para atualização completa ou substituição total para o fluxo de dados ContentVersion.
Antes de configurar uma ingestão de anexo de arquivo, planeje seu fluxo de trabalho de acordo com um destes cenários.
| Cenário | Etapas |
|---|---|
| Configuração inicial | Use o conector do Salesforce CRM para instalar o content_bundle que implementa os fluxos de dados Documento de conteúdo, Versão do conteúdo e Link do documento de conteúdo. Anexe arquivos a objetos padrão ou personalizados do Salesforce e implemente um fluxo de dados para seu objeto de CRM desejado. Crie um índice de pesquisa com o DMO de origem e anexo apropriado. |
| Você criou fluxos de dados de conteúdo antes de 10 de julho de 2026 | Quaisquer fluxos de dados de conteúdo criados antes de julho de 2026 não são compatíveis com esse fluxo de trabalho de ingestão de anexo de arquivo. Se você criou os fluxos de dados ContentDocument, ContentVersion e ContentDocumentLink antes de julho de 2026, só poderá ingerir arquivos que foram anexados a objetos do CRM depois de criar os fluxos de dados. Para ingerir seus anexos de arquivo de histórico, exclua os fluxos de dados de conteúdo existentes e implemente o content_bundle padrão. Em seguida, crie novos objetos do Salesforce com anexos de arquivo ou use anexos existentes para objetos existentes do Salesforce. |
Configurar a ingestão de anexo de arquivo
Antes de começar
- Identifique os objetos em sua organização do CRM que têm anexos de arquivo que você deseja ingerir (por exemplo, Conta).
- Para ingerir anexos de arquivo de uma organização de CRM externa, configure uma conexão de organização de CRM externa a essa organização. Para uma organização de origem do CRM, o Data 360 cria automaticamente a conexão para você.
Etapa 1: implantar um fluxo de dados para seu objeto de CRM desejado
Crie ou implemente um fluxo de dados para o objeto de CRM específico (padrão ou personalizado) ao qual os arquivos que você deseja ingerir estão anexados (por exemplo, Caso, Oportunidade). Aprenda a criar um fluxo de dados do Salesforce CRM.
Etapa 2: implantar o Content_Bundle padrão
Instale o Content_Bundle padrão para implementar os fluxos de dados Documento de conteúdo, Versão do conteúdo e Link do documento de conteúdo. Saiba mais sobre a instalação de pacotes de dados padrão habilitados por kits de dados.
- No iniciador de aplicativos, abra o Data 360 (Data Cloud).
- No Data 360, acesse a guia Fluxos de dados.
- Clique em Novo para criar um novo fluxo de dados.
- Selecione a fonte de dados: Salesforce CRM e clique em Avançar.
- Selecione a organização do CRM com os anexos de arquivo que você deseja ingerir e clique em Visualizar pacotes.
- Em Pacotes padrão, selecione Content_Bundle e clique em Avançar.
- Em Novo fluxo de dados, certifique-se de que para cada fluxo de dados à esquerda, todos os campos estejam selecionados. Você não precisa configurar nenhuma outra configuração.
- Clique em Next (Avançar) para continuar.
- Selecione o espaço de dados relevante e clique em Implantar. O pacote de dados de conteúdo implementa esses três fluxos de dados para seu objeto do CRM e seus relacionamentos.
-
Vá para a guia Fluxos de dados para confirmar que os relacionamentos estão criados e ativos.
Documento de conteúdo: Representa documentos carregados em uma biblioteca no Salesforce CRM.
Versão do conteúdo: Representa a versão específica de um documento no Salesforce CRM.
Link do documento de conteúdo: Representa um link para usuários, grupos, registros ou bibliotecas com os quais o arquivo é compartilhado.
Etapa 3: criar um relacionamento entre o DMO do objeto de CRM desejado e o DMO do documento de conteúdo
Depois que o Data 360 implementar os três fluxos de dados de conteúdo e seus interrelacionamentos, configure o relacionamento de objeto.
- No Data 360, acesse a guia Modelo de dados.
- Em Objetos de modelo de dados, selecione Relacionamentos de documento de conteúdo.
- Abra a guia Relacionamentos e clique em Editar.
-
Adicione uma nova linha de relacionamento com estes valores.
Objeto Relacionamento de documentos de conteúdo Campo Item relacionado Cardinalidade N:1 Objetos relacionados Data Cloud e o objeto que tem anexos de arquivo Campo relacionado A chave primária do objeto que tem anexos de arquivo, por exemplo: ID da conta - Salve o novo relacionamento.
- Acesse Modelo de dados e depois Objetos de modelo de dados e Relacionamento de documento de conteúdo para garantir que haja um relacionamento entre o DMO do objeto (por exemplo, Caso, Oportunidade, Conta ou seu DMO de objeto personalizado) e o DMO ContentDocumentRelationship.
-
Confirme se os seguintes relacionamentos também existem. O Data 360 geralmente cria esses relacionamentos automaticamente durante a implantação Content_Bundle. Se um deles não existir, crie-o manualmente usando estes valores.
Objeto Relacionamento de documentos de conteúdo Campo Documento de conteúdo Cardinalidade ManyToOne Objetos relacionados Documento de conteúdo Campo relacionado ID do documento de conteúdo Objeto Documento de conteúdo Campo Última versão publicada Cardinalidade ManyToOne Objetos relacionados Confirmar versão do conteúdo Campo relacionado ID do documento de versão do conteúdo Objeto Relacionamento de documentos de conteúdo Campo Documento de conteúdo Cardinalidade ManyToOne Objetos relacionados Documento de conteúdo Campo relacionado ID do documento de conteúdo Objeto Versão do documento de conteúdo Campo ContentDocument Cardinalidade ManyToOne Objetos relacionados Documento de conteúdo Campo relacionado ID do documento de conteúdo
Etapa 4: Criar índice de pesquisa com a configuração avançada
Se você criar os fluxos de dados de conteúdo sem um índice de pesquisa associado, o Data 360 ingerirá apenas metadados de arquivo. Para acionar a ingestão de arquivos, crie um índice de pesquisa. Depois de criá-lo e selecionar o modelo de dados de anexo correto, o Data 360 automaticamente detecta e ingere anexos de arquivo históricos em ordem cronológica inversa (o mais recente primeiro).
- No Data 360, abra a guia Índice de pesquisa e clique em novo para criar um novo índice de pesquisa.
- Clique em Configuração avançada e em Avançar.
- Em Selecionar tipo de pesquisa, selecione Pesquisa vetorial ou Pesquisa híbrida.
- Selecione o espaço de dados relevante e o objeto de modelo de dados (DMO) de origem em que seus anexos de arquivo residem.
- Em Selecionar campos a agrupar, clique em Incluir anexos de arquivo.
- Selecione o DMO ContentDocumentVersion e clique em Salvar.
-
Defina outras configurações conforme necessário e salve o índice de pesquisa.
Depois de criar um índice de pesquisa, o Data 360 imediatamente começa a ingerir e indexar anexos de arquivo para disponibilizar o conteúdo no índice de pesquisa. Para validar se o Data 360 ingeriu e indexou seus arquivos, você pode consultar o DMO de bloco por meio do Editor de consulta e confirmar que vê partes relevantes de seus arquivos.
O Data 360 atualiza os dados conforme descrito em Processo de atualização de dados para extração. Novos arquivos são incluídos nessa ingestão incremental. O Data 360 captura novos anexos de arquivo ou arquivos excluídos como eventos dos fluxos de dados.
