Este artigo irá guiá-lo na integração e personalização do Fin para mensagens Zendesk, incluindo a experiência do cliente e a transferência para sua equipe de suporte no Zendesk quando uma conversa precisar ser escalada para um humano.
Conecte o Fin com Zendesk
Conectar ao Zendesk
OAuth é o método principal para conectar o Fin ao Zendesk. Ele oferece uma configuração segura, sem tokens, e garante compatibilidade com as mudanças da plataforma Zendesk.
Vá para Connect na navegação à esquerda.
Expanda Connect to Zendesk Sunshine e clique em Connect.
Uma janela popup será aberta. Faça login no Zendesk usando OAuth e aprove o acesso.
Você será redirecionado de volta ao Fin com sua conexão marcada como Connected.
Nota: O Zendesk está descontinuando a autenticação por token API. Todos os novos clientes devem conectar usando OAuth.
Novos clientes não contratados: OAuth é obrigatório.
Novos clientes contratados: OAuth se torna obrigatório assim que seu workspace estiver habilitado para OAuth.
Clientes existentes: Conexões API continuam funcionando, mas se desconectadas, você deve reconectar com OAuth. Você verá um banner persistente no seu workspace Fin até que o OAuth seja habilitado.
Nota: Se você usar um navegador que bloqueia popups, será necessário permitir popups para app.intercom.com para que o fluxo OAuth seja concluído.
Credenciais Sunshine
A API Zendesk Sunshine é necessária para criar chats ao vivo em tempo real no Zendesk. Você será solicitado a inserir:
App ID
Key ID
Secret Key
Estes são encontrados no Zendesk Admin Center > Apps & Integrations > APIs > Conversations API.
Nota: Esta API é separada da API de ticketing descontinuada e ainda requer credenciais baseadas em chave.
Nota: A API Zendesk Conversations foi descontinuada em favor da API Sunshine. Você precisará ter uma licença Sunshine para conectar a API de conversations.
Se você não vir a opção "Conversations API" nas configurações do administrador Zendesk em Apps and integrations > APIs > Conversations API, provavelmente você não tem uma licença Sunshine e precisará entrar em contato com o suporte Zendesk para obtê-la.
Quando integrado ao Zendesk via API Sunshine, o Fin realiza chamadas API contínuas para sincronizar mensagens e estados de conversa em tempo real. Isso garante paridade de dados entre Fin e Zendesk, seja a conversa iniciada no Zendesk Messenger ou no Fin Messenger.
A API Sunshine é especificamente adequada para integrações em tempo real, como a transferência de chats do Fin para agentes ao vivo, enquanto a API Zendesk regular foca em tarefas mais simples como criação e atualização de tickets. Ambas as APIs têm funcionalidades distintas e requerem consideração baseada nos objetivos de integração e licenciamento.
Configure o Fin para mensagens Zendesk
Após conectar, a página dedicada de configurações de Zendesk Messaging abre em Settings › Zendesk Messaging. Para definir o nome e avatar do Fin, clique em Manage Fin's name and avatar.
Selecione quais canais Zendesk Messaging o Fin deve responder
Zendesk Messaging pode incluir WhatsApp, Instagram, Facebook, SDKs móveis e mais.
Vá para Zendesk > Channels > Messaging para ver os canais disponíveis.
Ative os toggles no Fin para decidir quais canais de mensagens ele deve gerenciar.
Nota: Para começar a usar mensagens SMS, você precisa configurá-las dentro do Zendesk em Channels > Text. A funcionalidade SMS é gerenciada nesta área específica, não na configuração de Messaging. Siga as instruções para configurar e conectar canais SMS específicos para suas necessidades de negócio.
Após configurar os canais de mensagens no Zendesk, você pode informar ao Fin quais desses canais ele deve responder nesta etapa, ativando os toggles ao lado de cada canal.
Uma vez que o Fin esteja implantado, as mensagens aparecerão no seu workspace Fin. Essas conversas permanecem gerenciáveis dentro do Fin até que ocorra um ponto de transferência, após o qual serão tratadas exclusivamente no Zendesk.
Construa seu workflow
Configure o fluxo de saudação e transferência
Depois de integrar com Zendesk, clique em Next: Build your workflow > Manage workflow.
Use o construtor de workflow para definir como o Fin deve cumprimentar os clientes, responder e escalar.
Clique na etapa Let Fin handle no seu workflow para personalizar o seguinte:
Definir expectativa para suporte humano - Mostrar presença dos colegas em uma conversa no messenger. Desative isso se sua equipe trabalha toda em outra ferramenta ou ninguém está monitorando a inbox.
Acompanhar clientes inativos - Decida o que acontece se o cliente não responder após o Fin responder.
Peça mais informações antes da transferência - Colete mais informações quando um cliente pedir para falar com a equipe. Ao coletar mais informações, o Fin pode fornecer uma resposta adicional — aumentando a chance de resolução.
Criar ticket Zendesk quando o Fin responder - Este recurso foi descontinuado e não está mais disponível. O Zendesk agora oferece "AI Agent Tickets" para todos os clientes, que cria automaticamente visibilidade em conversas apenas com IA. Em 18 de fevereiro de 2026, este recurso será ativado por padrão no Zendesk, mas ainda poderá ser desativado. Em 4 de maio de 2026, este recurso será ativado por padrão e não poderá ser desativado. Saiba mais sobre AI Agent Tickets do Zendesk.
Solicitar avaliação da conversa (CSAT) - Escolha enviar uma pesquisa CSAT após os clientes interagirem com Fin.
Gerenciar conversas inativas - Decida quanto tempo Fin deve esperar antes de considerar um cliente inativo, quando fechar conversas inativas e personalize o que Fin diz ao encerrar a conversa.
Você pode personalizar ainda mais a experiência ao:
Criar diferentes ramificações com base em suas condições.
Escolher quando Fin responde.
Fazer Fin enviar uma mensagem.
Coletar dados.
Fornecer botões de resposta.
Coletar a resposta do cliente.
Adicionar notas internas.
Adicionar um resumo gerado por IA da conversa.
Auto-classificar atributos do ticket com base no que o cliente disse.
Coletar nomes e endereços de email antes da transferência para garantir que a criação do ticket seja perfeita e que as equipes de suporte ao cliente estejam melhor informadas.
Personalizar mensagens de saudação e especificar o idioma usado na transferência para garantir que a conversa esteja alinhada perfeitamente com a identidade da sua marca e o tom organizacional.
Oferecer métodos alternativos de contato, como fornecer um número de telefone para suporte, atualizando a configuração do Messenger para incluir uma opção de transferência que apresente o número de telefone aos clientes quando suas dúvidas não forem resolvidas. Isso pode aumentar a satisfação do cliente ao oferecer mais opções de assistência.
Nota: Você deve estar no modo Editar para poder fazer alterações no seu workflow. Selecione Editar no canto superior direito da tela do editor de workflow.
Personalize os assuntos dos tickets Zendesk usando atributos
Se sua transferência criar um ticket Zendesk, você pode clicar na ação Create Zendesk ticket para personalizar o assunto do ticket usando atributos no seu workspace Fin.
No final de todos os caminhos (exceto quando Fin resolve uma consulta), Fin se desassociará e aplicará a tag “routed-to-the-team”. Coletar informações do usuário, como nome e email, durante essa fase é importante.
Integrar a coleta de dados garante que os detalhes do cliente sejam encaminhados junto com os tickets que seus agentes podem ver no Zendesk. Para garantir que todos os atributos críticos do cliente, como números de telefone, sejam sincronizados nos tickets Zendesk, confirme que os atributos coletados estão mapeados para os campos sincronizados com Zendesk antes de executar a ação "Create Zendesk Ticket".
Depois de terminar de personalizar a saudação e a transferência para sua equipe, clique em Salvar, ou Ativar para habilitar isso no seu messenger (você também pode voltar para ativar isso mais tarde).
Dica: Você pode criar e gerenciar múltiplos workflows Fin diretamente no seu workspace Fin. Isso permite personalizar experiências do cliente para diferentes cenários de mensagens e configurar workflows “teste” separados que são acionados apenas para sua equipe.
Testar
Garantir que Fin esteja pronto
Primeiro, será solicitado que você garanta que deu treinamento suficiente para Fin. Isso é importante antes de iniciar os testes ao vivo.
Recomendamos ler nosso guia completo sobre todas as formas de treinar Fin para que ele possa responder às perguntas dos seus clientes com a maior precisão possível.
Testar Fin
Para testar Fin no Zendesk Messenger, você precisará inserir a URL onde ele está instalado.
Depois de inserir sua URL, clique em "Testar" Fin e uma nova janela será aberta mostrando como Fin funcionará no seu Zendesk Messenger.
Você também pode ativar Fin ao vivo com regras de segmentação de público para um grupo de teste designado, como membros da equipe interna. Por exemplo, você pode configurar filtros de público no seu workflow Fin usando critérios específicos de domain, como o domínio de email da sua empresa.
Ativar Fin
Agora você está pronto para ativar Fin ao vivo para seus clientes. Vá para Deploy > Zendesk messaging > Go Live e selecione Go Live.
Experiência do cliente
Quando um cliente abre o Zendesk Messenger, ele verá uma saudação do Fin (isso pode ser personalizado).
Depois que o cliente faz uma pergunta:
Fin tentará responder, citando fontes do conhecimento ao qual você deu acesso ao Fin.
Se a pergunta for ambígua, Fin fará perguntas para esclarecer.
Se Fin não conseguir resolver a conversa, ele fará a transferência do ticket para a equipe.
Esta conversa não será visível para os agentes no Zendesk até que o cliente peça para falar com uma pessoa.
Depois que o cliente pedir para falar com a equipe, um novo ticket de messaging será criado no Zendesk e aparecerá na fila. Quando um agente assumir a conversa, ele verá todo o histórico da conversa no thread e poderá continuar a conversa a partir daí.
Nota: Se o cliente estiver offline e o email dele for conhecido, uma notificação por email será enviada permitindo que ele continue a conversa por email.
Como funciona
Fin conecta-se ao Zendesk Messaging via API Sunshine Messaging da Zendesk, permitindo compatibilidade com Zendesk Messenger — não com o widget clássico de Chat.
Quando conectado, Fin espelha conversas do Zendesk para seu workspace Fin, junto com dados do usuário como nome, email, URL da página e geolocalização. Fin funciona em todos os canais disponíveis para você no Zendesk Messaging (ex.: Zendesk Messenger, WhatsApp, SDKs móveis, etc.).
Fin substituirá o bot embutido do Zendesk (Answerbot), lidando apenas com novas conversas e não intervindo nas que já estão em andamento. As conversas com Fin seguem as regras padrão do Zendesk, permanecendo ocultas no workspace do agente a menos que sejam explicitamente transferidas ou se o workflow terminar.
Para usuários que preferem não sincronizar dados de clientes, Fin pode operar em capacidade limitada enviando tickets sem acessar detalhes armazenados do cliente, embora isso reduza a personalização.
Este é o mesmo comportamento do fluxo do Answerbot da Zendesk:
Quando uma conversa é transferida, ela aparecerá na fila da sua equipe de suporte. Uma vez aberta, criará um ticket. Fin não interagirá mais na conversa após a transferência.
Se o ticket for fechado pelo agente de suporte, o controle será passado de volta para Fin. Se o usuário fizer mais perguntas, o workflow de mensagens que alimenta o Fin será executado novamente.
Fin também pode coletar dados de nome e email e repassá-los para o Zendesk.
Dica: Fin pode controlar autenticação e verificação de identidade através de JWTs. Quando JWT é implementado, Fin garante que os campos de usuário e organização do Zendesk sejam sincronizados automaticamente para seu workspace Fin ao receber uma nova mensagem pelo Zendesk Messenger. Essa sincronização em tempo real suporta workflows de suporte ao cliente mais personalizados e eficazes.
Se um usuário autenticado não tiver um email verificado, Fin tentará recuperar o email do usuário no Zendesk usando seu ID externo. Isso garante que tickets ainda sejam criados com sucesso ao transferir de uma conversa Sunshine para o Zendesk. Para habilitar essa funcionalidade, certifique-se de que a autenticação JWT esteja configurada corretamente.
Perguntas Frequentes
Como posso ver as alterações feitas nos canais do Zendesk Messaging?
Como posso ver as alterações feitas nos canais do Zendesk Messaging?
Para revisar todas as alterações relacionadas aos canais do Zendesk Messaging:
Navegue até a página Customer Healthcheck no Zendesk.
Abra Channel audit events.
Aqui, você pode ver:
Carimbo de data/hora de cada alteração
Canal que foi atualizado
Ação realizada (ativada ou desativada)
Administrador que realizou a ação
Como posso garantir que atributos do cliente, como números de telefone, sejam sincronizados nos tickets do Zendesk?
Como posso garantir que atributos do cliente, como números de telefone, sejam sincronizados nos tickets do Zendesk?
Para garantir que atributos como números de telefone sejam preenchidos nos tickets do Zendesk:
Confirme se o atributo Telefone está marcado como um atributo sincronizado com o Zendesk nas configurações do Fin (ex.: indicado por um ícone Z).
Use a ação "Coletar Dados" nos workflows para reunir essa informação.
Mapeie o atributo para o campo sincronizado com o Zendesk antes da ação de criação do ticket.
Posso oferecer opções de contato alternativas dentro do Messenger?
Posso oferecer opções de contato alternativas dentro do Messenger?
Sim, você pode ajustar seu workflow para oferecer um método de contato alternativo, como apresentar um número de telefone de suporte ao cliente, através de uma etapa de configuração de transferência no workflow.
Como posso exportar dados de conversas, como endereços de email de usuários ou IDs de usuários, no Fin para Zendesk Messaging?
Como posso exportar dados de conversas, como endereços de email de usuários ou IDs de usuários, no Fin para Zendesk Messaging?
Você pode exportar dados de conversas, incluindo endereços de email de usuários, usando a interface de relatórios do Fin. Siga estes passos:
Abra seu workspace Fin e vá para Analisar > Relatório Personalizado.
Localize o gráfico intitulado "Conversas envolvidas ao longo do tempo".
Passe o mouse sobre o gráfico e clique no botão Detalhamento do gráfico para obter uma lista detalhada das conversas em que o Fin esteve envolvido.
Clique no ícone de três barras localizado no canto superior direito do gráfico. Use isso para incluir atributos de dados adicionais, como "email do usuário". (Nota: Endereços de email aparecerão apenas se os clientes os fornecerem.)
Uma vez que os campos necessários estejam visíveis, selecione o botão Exportar CSV para baixar os dados no formato CSV.
Dica: O sistema de relatórios suporta filtros para conversas por vários parâmetros como datas, status, users e palavras-chave para refinar sua exportação de dados. Certifique-se de aplicar filtros conforme suas necessidades.
Para exportar dados vinculados a IDs de usuários específicos sem usar APIs, um workflow de marcação pode ser implementado. Veja como:
Crie uma etapa Regras dentro do seu workflow Fin. Configure essa regra para verificar se o ID do usuário corresponde à sua lista alvo e aplique uma tag específica a essas conversas.
Use ferramentas de relatório de conversas para filtrar e exportar conversas marcadas com a tag designada. Isso garante que você capture todas as conversas associadas a IDs de usuários específicos.
Nota:
Dados relacionados a conversas (ex.: endereços de email) serão exibidos apenas se fornecidos explicitamente pelos users.
Para Zendesk Messaging, certos detalhes da conversa podem permanecer ocultos a menos que os users tenham optado por escalar ou solicitado explicitamente assistência humana.
Como posso garantir que Fin continue respondendo após um humano assumir?
Como posso garantir que Fin continue respondendo após um humano assumir?
Para manter Fin disponível após uma transferência no Zendesk Messaging:
Quando uma conversa é escalada para um colega, Fin pausa até que o ticket seja fechado.
Quando o colega fecha o ticket, o controle volta para Fin. Se o cliente enviar outra mensagem, Fin fica ativo novamente e seu workflow de mensagens reinicia.
Se uma conversa de mensagens resolvida for reaberta com uma nova pergunta, Fin também retomará as respostas — desde que seu workflow direcione essas mensagens de volta para Fin.
Para evitar atrasos, você pode adicionar uma etapa Mensagem antes de direcionar para Fin que incentive o cliente a fazer sua pergunta. Isso ajuda a ativar o Fin imediatamente após a transferência ou fechamento.
Isso garante que Fin esteja sempre presente quando o cliente reengaja.
Como posso evitar que conversas sejam transferidas sem nome ou email?
Como posso evitar que conversas sejam transferidas sem nome ou email?
Para evitar escalonamento sem detalhes do cliente:
Coletar dados essenciais antes da transferência. Adicione uma etapa Coletar dados no seu workflow para solicitar o nome e email do cliente, caso ainda não tenham sido fornecidos.
Capture atributos de usuários logados automaticamente. Certifique-se de que sua instalação do Messenger está configurada para passar atributos do usuário (como email) para o Zendesk, para que os colegas recebam informações completas sem entrada manual.
Essa configuração garante que toda conversa escalada inclua os detalhes do cliente que sua equipe precisa.
Como posso buscar tickets ou conversas do Zendesk no Fin e resolver dados de ticket ausentes?
Como posso buscar tickets ou conversas do Zendesk no Fin e resolver dados de ticket ausentes?
Embora você não possa buscar conversas no Fin usando o ID do Ticket do Zendesk especificamente, existem várias maneiras alternativas de localizar conversas. Você pode buscar usando:
Palavras-chave
Tags
Nome do usuário ou da empresa
Data de criação
Outros atributos de dados disponíveis
Navegue até Analyze > Conversations dentro do Fin para aplicar esses filtros e localizar a conversa que você precisa.
Localizando Tickets do Zendesk Usando o ID Externo do Fin
Para localizar o ticket do Zendesk correspondente a uma conversa no Fin:
Abra a conversa relevante em Analyze > Conversations.
No painel Details no lado direito, procure em Conversation attributes pelo campo rotulado "External ID." Esse valor corresponde ao número do ticket do Zendesk.
Copie o External ID e cole na barra de busca global do Zendesk para acessar o ticket correspondente diretamente.
Se você não tiver o número do ticket imediatamente:
Use o endereço de email do solicitante, exibido no topo da conversa no Fin, para buscar tickets relacionados no Zendesk.
Alternativamente, navegue pelas Views do Zendesk (por exemplo, All tickets, Open tickets) e filtre pelo nome do solicitante ou assunto.
Solução de problemas: External ID ausente no Fin
Se o External ID não estiver visível nos detalhes da conversa:
Verifique se o ticket foi criado no Zendesk durante a transferência da conversa. Caso contrário, aguarde alguns minutos e atualize a página.
Certifique-se de que o painel Details no Fin está totalmente expandido para exibir todos os atributos da conversa.
Verifique se a integração de transferência do Fin para o Zendesk está configurada corretamente. Essa configuração é necessária para a criação do ticket no Zendesk preencher o External ID de volta no Fin.