Conexão de fontes de conhecimento externas à conta do Zendesk

Suite, todas as versões

Team, Growth, Professional, Enterprise ou Enterprise Plus

Support com

Conhecimento Professional ou Enterprise

Resumo: ◀▼

Conecte fontes de conhecimento externas para disponibilizar conteúdo para pesquisa e usar em experiências de conhecimento. Você pode adicionar até 50 fontes e, em seguida, gerenciar a sincronização, as permissões e a autenticação de conectores, como Box, Confluence, Google Drive, Jira, Notion, SharePoint e muito mais. Um administrador de Conhecimento pode configurar fontes, e as atualizações são obtidas durante a próxima sincronização.

A capacidade de conectar conteúdo externo à conta do Zendesk está disponível em todos os planos. No entanto, os limites de armazenamento para dados externos variam de acordo com o plano. Consulte Gerenciamento de armazenamento de dados na sua conta do Zendesk.

Você pode conectar até 50 fontes de conteúdo externo à sua conta do Zendesk e disponibilizar o conteúdo onde quer que ele seja usado.

Este artigo contém os seguintes tópicos:

Conexão de conteúdo externo usando um conector de conhecimento
Referência de autenticação do conector de conhecimento

Conexão de conteúdo externo usando um conector de conhecimento

Você pode conectar uma fonte de conhecimento externa à sua conta Zendesk para disponibilizar o conteúdo onde quer que ele seja usado. Cada conector de conhecimento tem uma página de autenticação específica do conector que você configura antes de conectar. Uma vez conectado, você pode usar a página Conexão para gerenciar a conexão. Quaisquer atualizações ou adições feitas a esses elementos serão incorporadas ao Zendesk durante a próxima sincronização.

Ao conectar fontes de conhecimento externas ao Zendesk, você as verá listadas como uma fonte de pesquisa externa no Administrador do Conhecimento.

É necessário ser um administrador do Conhecimento para configurar e gerenciar conexões de conteúdo externo.

Como conectar conteúdo externo usando um conector de conhecimento

No Administrador do Conhecimento, clique em Gerenciar artigos () na barra lateral.
Clique em Conteúdo externo > Conexões.
Na seção Fontes disponíveis, clique em Conectar na fonte de conhecimento à qual deseja se conectar.
Revise as mensagens e clique em Continuar para começar a configurar a conexão.
Insira as informações de autenticação necessárias para permitir que o Zendesk acesse o conteúdo da fonte de conhecimento.
Os detalhes da autenticação variam por conector. Consulte Referência de autenticação do conector de conhecimento para obter informações específicas do conector que você está configurando.
Clique em Sincronizar.
O conector de conhecimento é adicionado à página Conexões e começa a sincronizar. Para gerenciar as conexões existente, consulte Gerenciamento de conexões de conhecimento externas.

Referência de autenticação do conector de conhecimento

A tabela a seguir lista os campos de autenticação obrigatórios para cada conector. Ao entrar no sistema ao qual você está se conectando, entre com uma conta de usuário que tenha as permissões corretas para o conteúdo que você quer sincronizar com o Zendesk.

Conector	Detalhes de autenticação e conexão
Amazon S3	Na guia Autenticar, configure o seguinte: ID da chave de acesso e Chave de acesso secreta: credenciais do IAM da AWS que concedem acesso programático ao bucket do Amazon S3 que você deseja sincronizar. As chaves de acesso da AWS são geradas por meio do console AWS Identity and Access Management (IAM). Consulte AWS Developer Guide para obter mais informações. Região da AWS: região da AWS onde seu bucket está armazenado. Na guia Definir escopo, configure o seguinte: Nome do bucket: o nome do bucket do Amazon S3 que você quer sincronizar. O conector sincronizará todos os tipos de arquivo compatíveis (.docx, .xlsx e .md), pastas e subpastas dentro de um bucket.
Box	Entre no Box com uma conta de usuário que tenha as permissões corretas para o conteúdo que você quer sincronizar com o Zendesk. Configure os itens a seguir: Pastas raiz: a pasta raiz que você deseja sincronizar com sua conta do Zendesk. Você só pode selecionar as pastas de nível superior no diretório raiz; não é possível selecionar subpastas ou arquivos individuais no diretório raiz. Ao selecionar uma pasta raiz, a sincronização inclui automaticamente todas as subpastas e os tipos de arquivo compatíveis (docx, .xlsx, .html e .md) nessa pasta. Quando você configurar uma conexão do Box, selecione as pastas pai que residem no diretório raiz da sua base de conhecimento do Box. Quando o conector realizar a sincronização, todo o conteúdo compatível dentro dessa pasta pai (incluindo subpastas e arquivos compatíveis) será sincronizado com sua conta do Zendesk.
Confluence	Entre no Confluence com uma conta de usuário que tenha as permissões corretas para o conteúdo que você quer sincronizar com o Zendesk. Configure os itens a seguir: Site do Confluence: o site do Confluence ao qual você quer se conectar. Espaços: os espaços aos quais você quer se conectar. Apenas os 20 primeiros espaços (mostrados em ordem alfabética) aparecem no menu de lista suspensa. Para selecionar um espaço que não é exibido no menu, comece a digitar o nome dele na caixa de pesquisa e selecione-o assim que aparecer. Para remover um espaço, clique no X na tag do espaço. não é permitido conectar-se a espaços pessoais no Confluence.
Contentful	Na guia Autenticar, configure o seguinte: ID do espaço do Contentful: identificador do espaço do Contentful que você quer conectar ao Zendesk. Para saber mais sobre como encontrar o ID do espaço do Contentful, consulte a central de ajuda do Contentful. Chave da API: (API de entrega de conteúdo – token de acesso no Contentful) Credencial que concede acesso programático para ler conteúdo armazenado no seu espaço do Contentful. Na guia Adicionar URL público, configure o seguinte: *Formato do URL (obrigatório)**: o formato do URL da página pública que hospeda seu conteúdo do Contentful. O formato da URL pode ser: um campo contendo a URL completa, como `fields.url` uma cadeia de caracteres de URL com um ou mais placeholders, como `https://zendesk.com/{fields.slug}` Os placeholders podem referenciar campos de entrada (`fields.<fieldId>`) e metadados de entrada (`sys.<key>`), como `sys.id`. o conector do Conhecimento só ingere conteúdo que possa ser associado a uma URL. Se a URL não puder ser construída a partir do formato da URL porque há campos obrigatórios ausentes, o registro será ignorado durante a sincronização do conteúdo.
Document360	Na guia Autenticar, configure o seguinte: Selecionar servidor: selecione a região do servidor em que sua conta do Document360 está hospedada (UE, EUA ou Privado). Se você selecionar Privado, também precisará inserir o subdomínio para sua conta de hospedagem privada do Document360. Token da API: insira o token da API que você criou em sua conta do Document360 para essa conexão. Na guia Definir escopo, configure o seguinte: Espaço de trabalho: Selecione qualquer espaço de trabalho público que você queira sincronizar. Idiomas: Selecione o idioma da base de conhecimento que você quer sincronizar. Essa conexão sincroniza apenas o conteúdo do Document360 no idioma que você especificar aqui. Crie uma nova conexão para cada idioma. Categorias: selecione as categorias que deseja sincronizar. Cada categoria ou subcategoria que você selecionar aparecerá como uma tag no campo Categorias. Ao selecionar uma categoria, você sincroniza somente o conteúdo que existe no nível dessa categoria, não as subcategorias dentro dela. Selecione as categorias e as subcategorias que contêm conteúdo que você quer sincronizar. forneça um token de API exclusivo cada vez que você criar uma conexão. Ao criar tokens de API no Document360 para uso com o Zendesk, certifique-se de especificar GET como o método HTTP permitido. Para obter mais informações, consulte a documentação do Document360.
Dropbox	Entre no Dropbox com uma conta de usuário que tenha as permissões corretas para o conteúdo que você quer sincronizar com o Zendesk (.docx, .xlsx, .html e .md.). Selecione a Pasta raiz que você deseja sincronizar com sua conta do Zendesk. Você só pode selecionar as pastas de nível superior no diretório raiz; não é possível selecionar subpastas ou arquivos individuais no diretório raiz. Ao selecionar uma pasta raiz, a sincronização inclui automaticamente todas as subpastas e os tipos de arquivo compatíveis nessa pasta.
Freshdesk	Configure os itens a seguir: Domain: o domínio atual do Freshdesk. Esse é o subdomínio que você escolheu quando criou sua conta (por exemplo, suaempresa.freshdesk.com). API Key: a chave da API do Freshdesk que permite ao Zendesk se comunicar diretamente com sua conta to Freshdesk. O Zendesk ingere conteúdo somente da localidade padrão.
Google Drive	Acesse o Google com uma conta de usuário que tenha as permissões corretas para o conteúdo que você quer sincronizar no Zendesk e permita que o Zendesk acesse seus arquivos do Google Drive. Selecione as unidades que deseja sincronizar. O conector do Google Drive oferece suporte ao Google Documentos e Planilhas Além disso, o conector do Google Drive sincroniza conteúdo do seu Google Drive compartilhado. O conteúdo do Google Drive privado não é sincronizado. Você pode se inscrever no EAP de ingestão de PDF para ativar a sincronização dos seus documentos em PDF.
Guru	Na guia Autenticar, configure o seguinte: E-mail: o endereço de e-mail usado para acessar sua conta do Guru. É necessário ser um administrador do Guru para criar uma conexão e você só pode sincronizar conteúdo ao qual tem permissão de acesso no Guru. Token da API: o token de usuário associado ao seu endereço de e-mail no Guru. O token de usuário fornece acesso de leitura e gravação no Guru com base em suas permissões de conta existentes. Clique em Gerenciar > Acesso à API acima desse campo para acessar a página do Guru em que você pode gerar o token de usuário. Para obter mais informações, consulte Leveraging Guru's API na central de ajuda do Guru. Na guia Definir escopo, configure o seguinte: Coleção: a coleção do Guru que contém o conteúdo publicado que você deseja sincronizar.
JIRA	Selecione a conta do JIRA que você deseja sincronizar com sua conta do Zendesk. Insira as informações a seguir: Site do Jira: insira o site do Jira que você deseja sincronizar. Esse campo exibe todos os sites do Jira aos quais você tem acesso. Cada site do Jira mapeia para uma única conexão com o Jira. Se você quer sincronizar vários sites, deve criar uma nova conexão para cada site. Selecionar espaços: insira o espaço do Jira que você deseja sincronizar. Esse campo exibe todos os espaços no site do Jira selecionado aos quais você tem acesso. Cada espaço que você seleciona aparece como uma tag no campo Espaços. Você pode remover os espaços que selecionou por engano, clicando no ícone X na tag de espaço. O conteúdo sincronizado inclui o seguinte: Chave do problema Resumo Descrição Status Prioridade Tipo Rótulos Comentários
Notion	Selecione seu espaço de trabalho do Notion na lista suspensa no canto superior direito. Selecione as páginas do Teamspace que você quer sincronizar e permita acesso a essas páginas. devido às limitações do Notion, você só pode configurar uma única conexão com o Notion em sua conta do Zendesk. Para adicionar ou remover conteúdo dessa conexão, consulte Adição ou remoção de conteúdo da sua conexão com o Notion. para que as páginas sejam sincronizadas com sua conta do Zendesk, elas devem conter conteúdo no corpo.
SharePoint	Entre na Microsoft com uma conta de usuário que tenha as permissões corretas para o conteúdo que você quer sincronizar com o Zendesk. Selecione o site do SharePoint na lista suspensa. Os tipos de arquivo compatíveis são docx, .xlsx e .md. Você pode se inscrever no EAP de ingestão de PDF para ativar a sincronização dos seus documentos em PDF.
Zendesk	Insira as informações necessárias para todas as conexões (públicas e não públicas). URL do Zendesk: o URL de sua conta do Zendesk. Se você quiser sincronizar conteúdo não público que exija acesso de usuário, clique Ativar e insira as informações obrigatórias: E-mail: endereço de e-mail associado a sua conta do Zendesk. Essas informações são combinadas com o token da API para acessar e sincronizar seu conteúdo interno. Token da API: token da API se quiser sincronizar artigos não públicos para sua conta do Zendesk. Se você deixar esse campo em branco, somente o conteúdo visível para usuários anônimos será sincronizado. Selecione Localidade (opcional) para os artigos que você quer sincronizar. A localidade para artigos que você deseja sincronizar. Se você deixar esse campo em branco, os artigos associados a todas as localidades serão sincronizados. Se você não especifica um token de API com e-mail e localidade, cada conexão contém o conteúdo publicamente disponível em todas as localidades desse subdomínio. Todos os artigos publicados que atendem a esses critérios são sincronizados com a conexão. Se você quiser sincronizar conteúdo de outro subdomínio do Zendesk, precisará adicionar uma nova conexão para esse subdomínio.