Passar para o conteúdo principal

Como mudar sua conexão Fin para Zendesk de chaves API para OAuth

Mude suas conexões Fin para Zendesk tickets e mensagens de chaves API para OAuth antes de 31 de janeiro de 2027.

Use este artigo para migrar suas conexões Zendesk tickets e Zendesk messaging de chaves API para OAuth (Open Authorization, o login seguro do Zendesk) até 31 de janeiro de 2027. É para administradores que configuraram Fin para Zendesk com chaves API.

Você precisa da permissão Can install, configure and delete apps no Intercom e de uma conta de administrador no Zendesk.

Importante: Não exclua nem desative sua chave API Conversations existente no Zendesk até que a troca para Zendesk messaging seja concluída. Fin a usa uma última vez para migrar seus canais de mensagens para a nova conexão.


Por que você precisa mudar de chaves API para OAuth?

O Zendesk está descontinuando tokens e chaves API (credenciais que você copia do Zendesk e cola no Fin) para apps que se conectam ao Zendesk. Fin agora conecta com OAuth: você faz login no Zendesk e aprova o acesso, sem chaves para copiar ou gerenciar.

Se você configurou Fin para Zendesk com chaves API, mude ambas as conexões para OAuth até 31 de janeiro de 2027. Suas conexões atuais continuarão funcionando enquanto isso.


Como verificar quais conexões Zendesk usam chaves API

Fin tem duas conexões Zendesk, ambas na página Connect:

  • Zendesk tickets (Connect to Zendesk): Fin usa para ler e responder aos Zendesk tickets.

  • Zendesk messaging (Connect to Zendesk Sunshine): Fin usa para Zendesk Messaging e para transferências do Fin Messenger para seus agentes Zendesk.

Se uma conexão ainda usa uma chave API, um banner no topo do Fin pede para você reconectar até 31 de janeiro de 2027. Essa conexão na página Connect também mostra API key: reconnect by 31 Jan 2027. Selecione Reconnect no banner para ir direto à conexão que precisa.


O que você precisa antes de começar?

  • A permissão Can install, configure and delete apps no Intercom.

  • Uma conta de administrador para a conta Zendesk à qual o Fin já está conectado.

  • Permita pop-ups para app.intercom.com no seu navegador.


Como mudar Zendesk tickets para OAuth

  1. Vá para Connect na navegação à esquerda.

  2. Expanda Connect to Zendesk.

  3. Selecione Manage Connection.

  4. Selecione Reconnect.

  5. Uma janela popup abrirá. Faça login no Zendesk com sua conta de administrador e aprove o acesso.

  6. O popup fecha e você volta para o Fin. O banner sobre Zendesk tickets desaparece.


Como mudar Zendesk messaging para OAuth

Zendesk messaging precisa que a conexão Zendesk tickets esteja ativa primeiro. Uma conexão Zendesk tickets que ainda usa um token API é suficiente, mas recomendamos mudar essa conexão primeiro.

  1. Vá para Connect na navegação à esquerda.

  2. Expanda Connect to Zendesk Sunshine.

  3. Selecione Manage Connection.

  4. Selecione Reconnect.

  5. Uma janela popup abrirá. Faça login na mesma conta Zendesk e aprove o acesso.

  6. O popup fecha e você volta para o Fin.


O que permanece igual após a troca?

  • Zendesk tickets: Fin atualiza sua conexão existente. Seus workflows, seu agente Fin Zendesk, os gatilhos Zendesk do Fin e suas configurações de sincronização de dados permanecem como estão.

  • Zendesk messaging: Fin continua respondendo nos mesmos canais de mensagens, e seus workflows permanecem como estão.

  • Você não precisa configurar nada novamente.


Como solucionar problemas na troca para OAuth

  • Verifique se você tem a permissão Can install, configure and delete apps no Intercom e se fez login no Zendesk como administrador.

  • Verifique se pop-ups estão permitidos para app.intercom.com.

  • Se o popup mostrar Zendesk connection failed, ou o banner ainda estiver lá, selecione Reconnect novamente. Sua conexão atual continuará funcionando enquanto isso.

  • Se o Fin parar de responder em um canal Zendesk messaging após uma tentativa falha, vá para AI > AI agents > Marketplace bots no Zendesk, selecione Fin AI Agent e verifique se o canal está selecionado.

Respondeu à sua pergunta?