Passar para o conteúdo principal

Sincronize o conteúdo do seu Zendesk help center

Como configurar uma sincronização regular dos artigos do seu Zendesk help center no Fin.

Sincronizar seu Zendesk help center permite usar seus artigos existentes para alimentar o Fin Agent e o Fin Copilot.

Esta integração foi projetada para priorizar a privacidade dos dados, utilizando apenas conteúdo publicamente acessível sincronizado especificamente para o Fin, garantindo a segurança do cliente e da organização durante todo o processo.

Nota: Você deve ter acesso ao Zendesk Guide para usar este recurso. Seu help center permanecerá no Zendesk; este processo apenas sincroniza o conteúdo no Fin.

Importante: O importador legado do Zendesk será descontinuado em 25 de abril. Após essa data, as sincronizações automáticas e manuais serão interrompidas. Para continuar sincronizando, você precisa migrar para o novo importador antes de 25 de abril. Vá para sua fonte Zendesk, clique em Manage (três pontos) > Migrate importer e siga as instruções. Após a migração, abra o novo importador e clique em Edit source para configurar filtros de metadados e revisar suas configurações.


Configure a sincronização com o Zendesk help center

  1. Para configurar a sincronização do seu Zendesk help center, vá para Train > Content e clique em See all.

  2. Em Connect external app content, escolha artigos do Zendesk.

  3. Escolha seu método de autenticação, selecione API Token ou OAuth, depois clique em Connect.

  4. Digite seu subdomínio do Zendesk (ex.: yoursubdomain.zendesk.com). Esta é a parte da URL do Zendesk que vem antes de .zendesk.com.

  5. Opcionalmente, ative Sync articles for signed-in users para incluir conteúdo visível apenas para clientes autenticados. Clique em Next quando a conexão for bem-sucedida.

  6. Use a aba Metadata para pré-filtrar qual conteúdo será importado. Clique em + Add Filter para filtrar por Categories, Labels ou Timestamps. Pule esta etapa para importar todo o conteúdo elegível por padrão.

  7. Use a aba Target para configurar onde o conteúdo importado será usado:

    • Fin AI Agent: Ative para usar artigos do Zendesk para respostas automáticas ao cliente.

    • Copilot: Ative para fornecer respostas sugeridas aos seus colegas.

    • Help Center: Ative para publicar conteúdo do Zendesk diretamente no seu Intercom Help Center.

    • Audience Control: Escolha quais públicos específicos podem ver este conteúdo.

  8. Faça uma verificação final na aba Review:

    • Digite um nome personalizado para a sincronização para identificá-la na sua lista de Knowledge (ex.: "Zendesk - Suporte Público").

    • Verifique o resumo para ver quantos artigos e campos estão sendo importados.

    • Confirme se suas configurações de Available in e Audience estão corretas.

  9. Clique em Sync and set live para começar.

Nota:

  • Artigos sincronizados com permissões "Staff" são habilitados apenas para o Fin Copilot por padrão e não serão usados pelo Fin Agent nas respostas aos clientes.

  • A primeira sincronização não pode ser interrompida depois de iniciada. Você só pode remover a integração após a sincronização inicial ser concluída.

Após a primeira sincronização ser concluída, você receberá um e-mail de confirmação listando quantos artigos foram sincronizados. O conteúdo aparecerá em Train > Content na seção "Content sources".


Gerencie a sincronização com o Zendesk help center

Quando seu conteúdo estiver sincronizado com o Zendesk, ele estará acessível em Train > Content na seção "Content sources".

Configure as configurações

Artigos sincronizados são somente leitura dentro do Fin e não podem ser editados diretamente na biblioteca de conteúdo. Todas as alterações no conteúdo do artigo devem ser feitas no Zendesk. Essas alterações serão atualizadas automaticamente no Fin durante a próxima sincronização.

No entanto, você pode gerenciar as configurações de cada artigo. Vá para Train > Content e clique na sua fonte Zendesk na seção "Content sources", depois abra o artigo que deseja gerenciar.

Há um painel "Details" à direita que contém:

  • Data: Veja o tipo de conteúdo, idioma, data de criação, última atualização (data da última sincronização com o Zendesk).

  • Fin: Ative/desative para Fin Agent e Fin Copilot. Quando ativado, o conteúdo fica disponível para clientes e colegas, respectivamente.

    • Scheduling: Ative ou desative o conteúdo para Fin e Copilot em datas definidas.

    • Audience: Direcione seu conteúdo para um público específico, para que o Fin Agent compartilhe apenas conteúdo relevante para eles.

  • Tags: Adicione uma tag para agrupar artigos e manter o conteúdo organizado.

Agende a disponibilidade do conteúdo do Zendesk

Você pode agendar quando os artigos sincronizados do Zendesk serão ativados ou desativados para Fin e Copilot, em uma data, hora e fuso horário futuros. Defina apenas a data de início ou defina data de início e fim para criar uma janela de disponibilidade limitada. O agendamento se aplica a artigos individuais ou em massa.

Agende um único artigo

  1. Abra o artigo. No painel Details à direita, encontre a seção Scheduling dentro do menu suspenso Fin.

  2. Clique em Schedule availability.

  3. No modal: selecione o produto de IA (Fin for Service ou Fin Copilot), defina a disponibilidade (Ativar ou Desativar) e escolha uma data, hora e fuso horário.

  4. Opcionalmente, ative Set end date para adicionar uma data e hora de término — a ação será revertida automaticamente nesse momento.

  5. Clique em Schedule para confirmar.

Agendamento em massa de artigos

  1. Selecione vários artigos na lista de conteúdo.

  2. Vá para o menu suspenso More actions e selecione Schedule availability.

  3. O mesmo modal de agendamento se aplica a todos os itens selecionados.

Como funciona o agendamento

  • Somente data de início: A ação de ativar/desativar ocorre no horário agendado e permanece em efeito até que você a altere manualmente.

  • Data de início + fim: O conteúdo é ativado (ou desativado) no horário de início e depois reverte automaticamente no horário de término.

  • Alterações manuais não cancelam um agendamento pendente: Se você alternar a disponibilidade manualmente após definir um agendamento, a transição agendada ainda ocorrerá no horário previsto e substituirá sua alteração manual.

  • Um agendamento pendente por item por agente: Definir um novo agendamento substitui o anterior — sem duplicatas.

  • Conteúdo excluído: Se um artigo for excluído antes do disparo do agendamento, o agendamento simplesmente não será aplicado e nenhum erro será exibido.

Como os metadados do Zendesk são gerenciados

O importador traz automaticamente a estrutura da sua knowledge base do Zendesk para o seu workspace Fin para economizar seu tempo.

Metadados do Zendesk como etiquetas, categorias e tags de conteúdo são todos importados e convertidos em tags no seu workspace Fin. Com essas tags aplicadas automaticamente, você pode:

  • Filtrar seu conteúdo para ver todos os artigos de uma determinada categoria.

  • Excluir conteúdo irrelevante do Fin.

  • Criar públicos específicos no Fin com base nas tags dos artigos para direcionar respostas aos clientes certos.

  • O importador avançado otimiza isso ainda mais, permitindo filtragem precisa e configurando a entrega de conteúdo específica para públicos por meio de tags mapeadas.

Dica profissional: Por exemplo, se você tem conteúdo no Zendesk rotulado como "EMEA-only", essa etiqueta se torna uma tag no seu workspace Fin. Você pode então criar um público para seus clientes europeus e configurar o Fin para usar apenas artigos com a tag "EMEA-only" para esse público.

Re-sincronizações automáticas de conteúdo do Zendesk

O Fin re-sincroniza automaticamente com seu help center do Zendesk a cada hora para puxar quaisquer alterações. Isso inclui novos artigos, edições de conteúdo e exclusões de artigos. Você não receberá e-mail por essas sincronizações automáticas.

Re-sincronize manualmente ou remova conteúdo do Zendesk

Se precisar acionar manualmente uma re-sincronização ou remover o conteúdo do Zendesk completamente, vá para Train > Content. Clique no menu de três pontos ao lado da fonte Zendesk e selecione Re-sync ou Remove this source.

Ao remover uma fonte, você verá uma faixa de confirmação verde indicando que a remoção foi bem-sucedida e os artigos sincronizados serão excluídos do Fin.

Reautentique sua conexão Zendesk

Se o administrador que configurou a sincronização Zendesk saiu da empresa ou não tem mais as permissões corretas, você não precisa deletar e recriar a sincronização. Basta reautenticar e seu conteúdo e relatórios existentes não serão afetados.

  1. Clique em Edit source na sua sincronização Zendesk existente.

  2. Mude para a aba Connect.

  3. Reautentique usando API token ou OAuth.

Importante: Certifique-se de que a conta que você usa tem o nível de acesso adequado no Zendesk. Usar uma conta com permissões insuficientes pode resultar em perda de conteúdo durante futuras re-sincronizações.


Usando artigos sincronizados com o Fin

Após sincronizar seus artigos Zendesk com o Fin, você pode usá-los para alimentar o seguinte:

Diferenças importantes entre seus artigos no Zendesk e no Fin Messenger

Existem pequenas diferenças em como os artigos sincronizados aparecem no Fin Messenger comparado ao seu help center do Zendesk. As diferenças podem incluir:

  • Formatos de conteúdo como, cabeçalhos adicionais, estilização de texto, formatação de tabelas, etc.

  • Se um cliente clicar no link “Open in Help Center” na parte inferior de um artigo sincronizado no Fin Messenger, isso abrirá uma nova aba com o artigo no seu help center do Zendesk.

  • Suportamos exclusivamente vídeos adicionados pelo botão 'Add video' do Zendesk, normalmente incorporados via iframe, e compatíveis com todos os provedores disponíveis no editor de artigos do Zendesk (ex: YouTube, Vimeo, Wistia, JWPlayer, Brightcove, Vidyard, Loom, Guidde). Incorporações de vídeo personalizadas em HTML, CSS ou JavaScript não são suportadas.

  • Se os artigos aparecerem em branco no Fin Messenger, pode ser devido à Política de Segurança de Conteúdo (CSP) do seu site bloqueando recursos de terceiros necessários para o carregamento correto, como imagens externas ou scripts.


FAQs

Quais dados o Fin usa quando integrado com o Zendesk?

O Fin integra-se perfeitamente com o Zendesk para fornecer respostas ao cliente. No entanto, é importante entender as fontes específicas de dados que o Fin utiliza para garantir eficácia operacional e privacidade dos dados.

Conteúdo para geração de respostas

Quando integrado com o Zendesk, o Fin usa exclusivamente conteúdo de suporte que é explicitamente sincronizado para o seu workspace Fin. Isso inclui:

  • Artigos públicos do Zendesk Help Center

  • Outro conteúdo público sincronizado, como sincronizações de sites

  • Documentos enviados

  • Snippets

  • Orientações de resposta configuradas pela sua equipe

Isso garante que as respostas do Fin sejam baseadas em informações verificadas que você habilitou seletivamente para o Fin.

Exclusão de dados privados

O Fin não utiliza dados privados do Zendesk, garantindo a privacidade do cliente e da organização. Especificamente, os seguintes dados não são usados pelo Fin ao responder aos clientes:

  • Comentários internos (privados) dentro do Zendesk

  • Tickets históricos do Zendesk ou dados de conversas com clientes

Ao excluir essas fontes de dados, o Fin garante que apenas conteúdo público aprovado e explicitamente sincronizado seja referenciado para respostas geradas por IA.

As tabelas dos meus artigos do Zendesk também serão sincronizadas?

Sim, se você tiver uma tabela no seu artigo do Zendesk, ela será sincronizada e usada pelo Fin. Você poderá ver a tabela sincronizada no conteúdo do seu workspace do Fin, exatamente como está no seu help center do Zendesk.

Respondeu à sua pergunta?