Passar para o conteúdo principal

Fin para tickets Freshdesk: Configuração

Aprenda como conectar Fin ao Freshdesk para automatizar respostas de ticket, sincronizar dados de conversas e importar sua knowledge base.

Você pode potencializar sua experiência de suporte Freshdesk usando o agente Fin AI para resolver tickets automaticamente. Quando um ticket é atribuído ao Fin no Freshdesk, todos os detalhes, informações do solicitante e comentários são sincronizados com seu workspace Fin. O Fin então fornece uma resposta baseada nos seus workflows e fontes de conhecimento configurados, sincronizando essa resposta de volta para o ticket Freshdesk.


Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

  • Acesso Administrativo Freshdesk: Necessário para gerenciar automações e configurações.

  • Agente Freshdesk dedicado: Crie um agente único (ex.: "Fin AI Agent") especificamente para esta integração.

  • Apenas função de suporte: O agente Fin dedicado deve ser atribuído a apenas função de suporte.

Importante: Atribuir uma função de administrador ao agente Fin causará erro de conexão.


Parte 1: Conecte as contas

  1. No Fin, navegue até Connect > Freshdesk e clique em Connect.

  2. Digite a URL do seu Helpdesk: No Freshdesk, vá para Admin Settings > Helpdesk Settings para encontrar seu subdomínio (ex.: companyname.freshdesk.com).

  3. Digite sua API Key: No Freshdesk, clique no seu ícone de Perfil no canto superior direito, selecione Configurações de perfil e clique em Ver API Key.

  4. Clique em Connect to Freshdesk.

Nota: Recomendamos fortemente usar a API key de um perfil de agente dedicado "Fin AI" em vez de uma conta pessoal de colega. Isso garante que a conexão permaneça ativa mesmo se um colega específico for removido da sua conta Freshdesk.

Uma vez validado, o Fin automaticamente:

  • Cria regras de automação Webhook no Freshdesk para gerenciar o handshake.

  • Sincroniza suas Brands e Business Hours para que o Fin saiba quando estar ativo.


Parte 2: Configure as automações do Freshdesk

Para garantir que os tickets sejam corretamente direcionados ao Fin, você deve atualizar as regras de automação no Freshdesk:

  1. No Freshdesk, navegue até Admin > Automations.

  2. Localize a regra Assign Fin criada pela integração.

  3. Edite a regra para definir o Assignee para seu agente Fin dedicado.

  4. Mova essa regra para o topo da sua lista de automações para evitar interferência de outras regras de roteamento.

  5. Defina a configuração de execução da automação para Executar todas as regras correspondentes.


Parte 3: Selecione o agente Fin Freshdesk

Após configurar o Freshdesk, volte ao Fin para finalizar a identidade:

  1. Volte ao seu workspace Fin em Settings › Freshdesk tickets e selecione seu agente Fin em Fin Freshdesk agent.

  2. Clique em Save.

Nota: As regras de automação no Freshdesk só são ativadas após você clicar em Activate na interface do Fin.


Parte 4: Teste seguro antes de entrar em produção

Antes de permitir que o Fin gerencie todos os tickets recebidos, é uma boa prática verificar se o handshake e as respostas da AI estão funcionando corretamente usando um ticket de teste isolado.

Crie um "Test Trigger" no Freshdesk

Para evitar que o Fin responda a clientes reais durante seu teste, adicione uma condição temporária à sua regra de roteamento:

  1. No Freshdesk, edite a regra de automação Assign Fin.

  2. Adicione uma condição: Ticket Subject contains "FIN TEST".

  3. Salve a regra.

Verifique o loop de integração

  1. Envie um e-mail de teste para seu endereço de suporte com "FIN TEST" no assunto.

  2. Verifique o Handshake: Vá para a aba Conversations no Fin. Você deve ver o ticket Freshdesk aparecer lá.

  3. Avalie a AI: Observe como o Fin processa o ticket. No Fin, você pode ver quais artigos de ajuda específicos o Fin usou para gerar a resposta.

  4. Verifique a Sincronização de Volta: Volte ao ticket no Freshdesk. Você deve ver a resposta do Fin aparecendo como uma resposta ao cliente.

Importante: Uma vez satisfeito com o desempenho, lembre-se de remover a condição "FIN TEST" da sua regra de automação Freshdesk para permitir que o Fin gerencie todos os tickets recebidos.


Configurações opcionais

  • Mapeamento de Campos: Você pode mapear campos personalizados de ticket, usuário ou empresa do Freshdesk para atributos do Fin para melhor contexto.

  • Importação da Knowledge Base: Importe seus artigos de ajuda do Freshdesk. Se você alterar o título de um artigo no Freshdesk depois, uma nova sincronização pode criar um duplicado; você deve remover manualmente a versão antiga do pool de conhecimento do Fin.

  • Dados Históricos: Você pode importar até 30.000 tickets fechados (apenas fonte e-mail e portal) para o Fin referenciar.

  • Verificação do usuário: Quando você adiciona a etapa Handoff to ticket in Freshdesk ao seu workflow, uma configuração de Verificação do usuário está disponível. Quando ativada, os clientes devem verificar seu endereço de e-mail com uma senha única (OTP) antes que um ticket seja criado. Isso se aplica quando o Messenger não está operando em modo seguro. Você pode desativar isso diretamente na etapa do workflow.


Perguntas frequentes

Quais tags o Fin aplica aos tickets Freshdesk?

O Fin usa fin-involved, fin-soft-resolution e fin-resolved para rastrear estados do ticket. Essas são automatizadas, embora você tenha controle limitado sobre tags personalizadas via configurações de orientação do Fin.

Posso importar meus tickets históricos?

Sim, você pode importar até 30.000 tickets fechados. Note que apenas tickets originados de email ou do portal são suportados para essa importação.

O que acontece se o Fin não responder a um ticket?

Se o Fin não responder, verifique se a regra de automação Assign Fin no Freshdesk está ativada e posicionada no topo da sua lista de automações. Também verifique se o responsável na regra corresponde ao agente Fin selecionado nas configurações do seu workspace Fin.

Posso conectar várias contas Freshdesk?

Cada workspace Fin suporta uma conexão Freshdesk. Se precisar conectar várias contas, entre em contato com o suporte Intercom.

Como mapear campos personalizados do Freshdesk para o Fin?

Você pode mapear campos personalizados de ticket, usuário ou empresa do Freshdesk para atributos do Fin na seção Configurações opcionais após a conexão. Isso dá ao Fin contexto adicional ao gerar respostas.

Respondeu à sua pergunta?