Aprenda como integrar o Fin Messenger com o Zendesk, personalizar o workflow e controlar como as conversas são repassadas para seus colegas.
Integre o Fin Messenger com o Zendesk
Escolha como o Fin deve repassar para o Zendesk
Vá para Deploy > Fin Messenger e escolha o que deve acontecer quando o Fin não conseguir responder a um cliente:
Repassar para agente Zendesk: Cria uma conversa de mensagens ao vivo no Zendesk.
Criar ticket Zendesk: Encerra a sessão no Fin e cria um ticket Zendesk com uma transcrição.
Determinado pela situação: por exemplo, chat ao vivo durante o horário comercial, ticket fora do horário.
O método de repasse selecionado determina quais APIs do Zendesk você deve conectar.
Capacidade | Requer Zendesk API (OAuth) | Requer Zendesk Conversations API |
Criar ticket Zendesk | Sim ✅ | Não ❌ |
Repassar para agente Zendesk | Sim ✅ | Sim ✅ |
Determinado pela situação | Sim ✅ | Sim ✅ |
Conecte-se ao Zendesk usando OAuth
OAuth é o método principal para conectar o Fin ao Zendesk. OAuth elimina a necessidade de gerenciar manualmente tokens API e garante compatibilidade contínua com as mudanças do Zendesk.
Vá para Deploy > Fin Messenger.
Em Zendesk API, selecione Conectar.
Faça login no Zendesk usando OAuth e aprove o acesso.
Volte para o Fin para confirmar que a conexão aparece como Conectado.
Nota: O Zendesk está descontinuando a autenticação por token API. Todos os novos clientes devem conectar o Fin ao Zendesk usando OAuth.
Novos clientes não contratados: OAuth é obrigatório.
Novos clientes contratados: OAuth é obrigatório assim que ativado no workspace.
Clientes existentes: Conexões por token API continuam funcionando, mas se desconectadas, a reconexão deve usar OAuth. Um banner persistente aparecerá até que o OAuth seja ativado.
Conecte-se à Zendesk Conversations API
Se seu workflow incluir Repassar para agente Zendesk, você também deve conectar a Zendesk Conversations API. As credenciais da Zendesk Conversations API continuam baseadas em chave; OAuth não as substitui.
Forneça os seguintes detalhes do Zendesk Admin Center > Apps & Integrations > Conversations API:
ID do App
ID da Chave
Chave Secreta
Depois de copiar tudo acima, selecione Conectar.
Nota: A Zendesk Chat API foi descontinuada em favor da Conversations API. Você precisará de uma licença Sunshine Conversations para conectar a Conversations API.
Se você não vir a opção "Conversations API" nas configurações do administrador Zendesk em Apps e integrações > APIs > Conversations API, provavelmente não tem uma licença Sunshine Conversations e precisará contatar o suporte Zendesk para obtê-la.
Como a Zendesk Conversations API funciona
A Conversations API mantém suas conversas Fin e Zendesk sincronizadas em tempo real. O Fin envia e recebe chamadas API:
A cada mensagem recebida do cliente
A cada resposta do Fin
Quando as conversas são atribuídas, escaladas ou encerradas
Se um cliente começar no Fin Messenger, o Fin cria ou encontra o usuário Sunshine correspondente.
Se uma conversa começar no Zendesk Messenger, o Fin mapeia as mensagens de volta para o workspace Fin.
Habilite múltiplas conversas no Zendesk
Se usar Repassar para agente Zendesk ou Determinado pela situação, o Zendesk exige que Múltiplas conversas estejam habilitadas.
Clique em Manage in Zendesk quando solicitado no Fin.
Ative Multiple Conversations nas configurações do Zendesk Messaging.
Volte para o Fin e clique em Refresh.
Construa seu workflow
Configure o fluxo de saudação e hand-off
Na tela de integração, clique em Manage workflow. Um modelo é fornecido, mas você pode personalizar totalmente:
Quando o Fin deve responder
Como o Fin cumprimenta os clientes
O que acontece na escalada
Quais dados coletar antes do hand-off
No final de qualquer caminho não resolvido, o Fin se desassocia e aplica a tag routed-to-the-team.
Clique na etapa Let Fin handle no seu workflow para personalizar o seguinte:
Definir expectativa para suporte humano - Mostrar presença dos teammates em uma conversa no messenger. Desative isso se sua equipe toda trabalha em outra ferramenta ou ninguém está monitorando o 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 do handover - 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 os AI Agent Tickets do Zendesk.
Peça avaliação da conversa (CSAT) - Escolha enviar uma pesquisa CSAT após os clientes interagirem com o Fin.
Gerenciar conversas inativas - Decida quanto tempo o Fin deve esperar antes de considerar um cliente inativo, quando fechar conversas inativas e personalize o que o Fin diz ao fechar a conversa.
Configurando as configurações de fechamento automático
O Fin permite personalizar o comportamento de fechamento automático por meio de ações específicas dentro do seu workflow. As configurações relevantes estão localizadas na etapa Let Fin handle. Siga estes passos para gerenciar e personalizar as configurações de fechamento automático:
Dentro da etapa Let Fin handle, encontre a seção intitulada Handle inactive conversations.
Use esta seção para definir as condições específicas sob as quais uma conversa é considerada abandonada. Especifique o tempo de atraso antes que a conversa seja fechada automaticamente.
Para configurar o tempo para fechamentos baseados em inatividade, ajuste as configurações de Close-on-inactivity timing na mesma seção Let Fin handle. Essas configurações permitem gerenciar quanto tempo o Fin aguardará antes de fechar uma conversa quando nenhuma atividade do cliente for detectada.
Estender o prazo de fechamento automático pode ajudar a reduzir o número de resoluções assumidas. Por exemplo, aumentar o tempo de atraso do padrão (ex.: 8 horas) para 24 ou 48 horas dá mais oportunidade para os clientes responderem antes que as conversas sejam fechadas.
Dicas:
Defina atrasos realistas: Um atraso muito curto ou muito longo pode resultar em uma experiência ruim para o cliente. Busque equilibrar a capacidade de resposta com o tempo adequado para o cliente responder.
Defina condições claramente: Garanta que os critérios para abandono e inatividade estejam bem definidos e adequados ao seu caso de suporte.
Teste as configurações: Realize testes para confirmar que as configurações escolhidas estão alinhadas com os requisitos do seu workflow e as necessidades dos clientes.
Você pode personalizar ainda mais a experiência no construtor de workflow por meio de:
Criar diferentes ramificações com base em suas condições.
Escolher quando o Fin responde.
Fazer o Fin enviar uma mensagem.
Fornecer botões de resposta.
Coletar dados.
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.
Nota: Você deve estar no modo Edit para poder fazer alterações no seu workflow. Selecione Edit no canto superior direito da tela do editor de workflow.
No caminho final de hand-off do workflow, você pode escolher como o Fin faz a transferência da conversa:
Se uma opção de hand-off já foi selecionada, você pode remover essa opção passando o mouse sobre ela, clicando nos 3 pontos que aparecem e selecionando excluir. | 
|
Personalize os assuntos dos tickets Zendesk usando atributos
Se seu hand-off 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.
Depois de terminar de personalizar a saudação e o hand-off para sua equipe, clique em Save, ou Set live para ativar isso no seu messenger (você também pode voltar para ativar isso depois).
Atribuir tickets a organizações Zendesk específicas
Se o seu workspace Zendesk usa organizações e um usuário pertence a mais de uma, você pode controlar a qual organização um ticket é atribuído via o token JWT.
Para fazer isso:
Crie ou use uma organização existente no Zendesk com um id externo, isso pode ser criado através da API do Zendesk aqui.
Inclua um campo
companyno JWT com dois atributos:{
"id": "457", // This should match the external ID of the Zendesk organization.
"name": "Examply Org"
}Configure um workflow do Fin Messenger com a transferência Create Zendesk ticket.
Quaisquer tickets criados a partir do Fin Messenger serão automaticamente atribuídos à organização definida pelo
external_idno JWT (desde que esse usuário esteja dentro da organização). Nota: Isso está disponível apenas no Fin Messenger em canais que suportam JWTs (email não é suportado).
Dica: Você pode criar e gerenciar múltiplos workflows Fin diretamente dentro do 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.
Instale o Fin Messenger
Para instalar o Fin Messenger, vá para Deploy > Fin Messenger > Install. Você precisará instalar o messenger para seu site ou aplicativo web, ou para seu aplicativo móvel.
Instalar para web
Instalar para web
Escolha como você gostaria de instalar o Messenger
Primeiro, você precisará escolher como deseja instalar o messenger. Se você selecionar Code snippet, React, Angular, Vue, Ember ou Shopify como método de instalação, terá a opção de instalar o Fin para visitantes do site sem login.
A instrução para instalar Code snippet, React, Angular, Vue, Ember ou Shopify será atualizada conforme você selecionar cada uma das opções. Para os métodos listados que permitem a instalação tanto para Users com login quanto para visitantes sem, você precisará copiar o snippet de código para cada método de instalação que desejar usar.
Para Users com login, você precisará ativar o toggle Enable connection to messenger para continuar para o código de instalação.
Siga as instruções fornecidas
Agora siga as instruções fornecidas para o método que você selecionou. Por exemplo, se você selecionou Shopify, verá os passos necessários para esse método de instalação.
Se você selecionou o método Code snippet, React, Angular, Vue, ou Ember, receberá um pacote NPM contendo um snippet de código para copiar e colar no código do seu próprio app. Esse snippet já vem preenchido com seu ID único do workspace, então está pronto para uso.
Você também pode encontrar o pacote diretamente no site NPM.
Existem vários outros templates disponíveis, como incluir o snippet de código em um Basic JavaScript ou Single-page app, ou você também pode usar a Rails gem para instalar o snippet.
Clique em Copy code e cole antes da tag </body> em cada página onde você quer que o Messenger apareça no seu app.
Após adicionar o código, você pode visitar qualquer página onde instalou o messenger e ele deve aparecer no canto inferior direito, ou você pode usar a opção Check installation no processo de instalação.
Proteja o Fin Messenger com JWTs
Se você tem o Fin Messenger instalado no seu site para usuários logados, é essencial protegê-lo e evitar que agentes mal-intencionados se passem por seus users ou enviem dados não autorizados.
JSON web tokens (JWTs) impedem que terceiros se passem por seus users logados e vejam suas conversas. Recomendamos fortemente que todos os clientes Fin exijam autenticação JWT.
Com a autenticação JWT ativada, o Fin sincroniza automaticamente os campos de usuário e organização do Zendesk para seu workspace Fin toda vez que o Fin Messenger é iniciado ou uma nova mensagem é recebida via Zendesk Messenger. Essa transferência de dados sem interrupções permite interações mais dinâmicas e personalizadas com clientes dentro dos seus workflows.
Evite depender excessivamente da segmentação baseada em URL: Não use apenas URLs para distinguir entre users logados e deslogados. URLs podem ser salvas como favoritos ou acessadas por usuários não autorizados, tornando isso inseguro. Combine segmentação baseada em URL com JWT para autenticação robusta.
Instalar para mobile
Instalar para mobile
Escolha sua plataforma de instalação
Primeiro, você precisará escolher sua plataforma de instalação preferida; iOS, Android ou React Native. Todas as plataformas escolhidas têm passos específicos e você receberá opções de como instalar o Fin em seus apps móveis e alguns snippets de código para ajudar na instalação.
Inicialize o Fin dentro do seu código
O próximo passo é inicializar o Fin dentro do código do seu app móvel. Você também pode gerenciar suas chaves API durante essa etapa.
As opções de snippet de código para iOS | As opções de snippet de código para Android | As escolhas para React Native |
|
|
|
Siga as instruções
Em seguida, siga as instruções específicas da plataforma para integrar o Fin Messenger no seu app móvel.
Ao configurar o Fin Messenger para iOS
No Zendesk, navegue até Admin Center > Apps and Integrations > Conversations API.
Clique em Create API Key, nomeie sua chave e clique em Save.
Copie a chave gerada — ela aparecerá na sua Conversations API list.
No seu Fin workspace, vá para Deploy > Fin Messenger > Install > iOS e cole a chave no seu código de inicialização.
Importante:
Armazene seu App ID, Key ID e Secret Key com segurança — eles não serão exibidos novamente.
Você pode armazenar até 10 chaves no total.
Você precisará de um plano Zendesk Suite Professional ou superior.
Verificar instalação
Clique em Verificar instalação ao final da configuração para confirmar o sucesso.
Você verá uma confirmação se o Fin Messenger foi detectado, ou uma mensagem de erro se algo deu errado.
Proteja o Fin Messenger com JWTs
Se você tem o Fin Messenger instalado no seu site para usuários logados, é essencial protegê-lo e evitar que agentes mal-intencionados se passem por seus users ou enviem dados não autorizados.
JSON web tokens (JWTs) impedem terceiros de se passarem pelos seus users logados e verem suas conversas. Recomendamos fortemente que todos os clientes Fin exijam autenticação JWT.
Com a autenticação JWT ativada, o Fin sincroniza automaticamente os campos de user e organização do Zendesk para seu workspace Fin toda vez que o Fin Messenger é iniciado ou uma nova mensagem é recebida via Zendesk Messenger. Essa transferência de dados permite interações mais dinâmicas e personalizadas dentro dos seus workflows.
Opcional: Configure notificações push
Nesta etapa, você terá novamente a opção da plataforma de instalação; iOS ou Android. Você pode configurar notificações push nesta seção, mas ela não guiará o processo. Em vez disso, nossos documentos para desenvolvedores devem ser usados para configurar notificações push:
React native não é oferecido como opção para notificações push móveis.
Esta etapa opcional é marcada como concluída quando notificações push são detectadas como configuradas para um app iOS ou Android.
Importante: Xcode 14 agora é necessário para compilar o Fin iOS SDK v13.0.0+
No Xcode 14, vários avisos são registrados no console quando o SDK é instalado. Os avisos vêm do uso do WKWebView pelo Fin. Há um bug no Xcode 14 que gera esses avisos, e não é um problema que o Fin possa corrigir.
São apenas avisos e o Fin continua funcionando normalmente quando eles aparecem.
Aqui estão as mensagens de aviso:
Erro WKWebView - Veja o artigo e você verá isso no console: Erro ao adquirir assertiva: <Error Domain=RBSServiceErrorDomain Code=1 "target is not running or doesn't have entitlement com.apple.runningboard.assertions.webkit" UserInfo={NSLocalizedFailureReason=target is not running or doesn't have entitlement com.apple.runningboard.assertions.webkit}>Este método não deve ser chamado na thread principal pois pode causar falta de resposta da UI.[Sandbox] Não foi possível habilitar Mach bootstrap, errno = 22.
Teste o Fin no Fin Messenger
Garanta que o Fin está pronto
Primeiro, será solicitado que você garanta que deu treinamento suficiente ao Fin. Isso é importante antes de iniciar testes ao vivo.
Recomendamos ler nosso guia completo sobre todas as formas de treinar o Fin para que ele possa responder às perguntas dos seus clientes com a maior precisão possível.
Teste ao vivo
Depois de verificar que o Fin está suficientemente treinado e personalizou o messenger para combinar com a identidade da sua empresa, você pode realizar um teste ao vivo.
Esta é a melhor forma de ver exatamente como o Fin no Fin Messenger vai parecer e se comportar dentro do site ou app onde você o instalou, sem que nenhum cliente veja.
Ativar o teste ao vivo ativa o Fin e liga o messenger atrás de uma URL de teste para o site onde você o tem.
Modo de teste ao vivo ativado
Iniciando o teste ao vivo
Testando no mobile
Para testar no mobile, você precisará instalar primeiro no seu app de staging, para poder realizar qualquer teste antes de colocar no ar.
Valide sua configuração no Zendesk
Recomendamos que você teste se os users corretos estão atribuídos como solicitantes do ticket no Zendesk.
Para confirmar isso:
Inicie uma conversa no Fin Messenger garantindo que o user_id ou email correto está sendo passado.
Quando o Fin transferir a conversa, verifique o novo ticket ou chat ao vivo criado no Zendesk.
Verifique se o solicitante corresponde ao user esperado.
Se o solicitante não corresponder, confirme que o user_id no Fin Messenger está alinhado com o external_id no Zendesk.
Coloque o Fin no ar para o Fin Messenger
Agora você está pronto para colocar o Fin no ar para seus clientes. Vá para Deploy > Fin Messenger > Go Live e selecione Go Live.
Experiência do cliente
Quando um cliente abre o Messenger, ele verá uma saudação do Fin (isso pode ser personalizado).
Depois que um cliente envia uma mensagem, um ticket é criado no Zendesk e a tag Fin-messenger será aplicada. Usando os Triggers do Zendesk, você pode decidir quando o ticket deve ser automaticamente atribuído ao Fin.
Conversas que forem atribuídas ao Fin aplicarão a tag fin-involved.
Se o Fin tiver conhecimento relevante disponível para responder, ele responderá e citará as fontes usadas, marcará o ticket como solved e aplicará as seguintes tags:
fin-resolved: Fin resolveu o ticket (resolução soft ou hard).
fin-soft-resolution: Fin resolveu a conversa, mas o cliente não confirmou.
Se a pergunta for ambígua, o Fin fará perguntas para esclarecer e marcará o ticket como pending, passando para a equipe se o cliente não responder em 3 minutos.
Se não tiver uma resposta, ele passará o ticket para sua equipe desassociando-se e marcando o ticket como open.
O cliente pode fazer perguntas de acompanhamento e o Fin seguirá o mesmo processo.
Se o cliente disser que ajudou, a tag “fin-soft-resolution” será removida e a “fin-hard-resolution” aplicada.
Se o cliente pedir para falar com a equipe, o Fin se desassociará do ticket, removerá as tags “fin-resolved” e “fin-soft/hard-resolution” e aplicará a tag “fin-routed-to-team”. Usando essa tag, você pode criar gatilhos adicionais no Zendesk para encaminhar o ticket. Esse comportamento garante que o status da conversa reflita adequadamente as necessidades do cliente, permitindo transições mais suaves para a equipe e reduzindo a possibilidade de tickets não resolvidos.
Quando o agente responder, aparecerá no Fin Messenger. Se o cliente estiver offline e o e-mail dele for conhecido, uma notificação por e-mail será enviada permitindo que ele continue a conversa por e-mail.
Nota: Você não pode usar o Fin Messenger para mensagens do Fin e Proactive Support (como chats de saída, publicações, tours de produtos, e-mails, etc.)
Aprenda como configurar o Fin para tickets Zendesk.