Passar para o conteúdo principal

Fin Messenger: configuração do Zendesk

Como configurar e personalizar o Fin no Fin Messenger e transferir conversas para o Zendesk.

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

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 de API e garante compatibilidade contínua com as mudanças do Zendesk.

  1. Vá para Connect.

  2. Em Connect to Zendesk, selecione Connect to Zendesk.

  3. Faça login no Zendesk usando OAuth e aprove o acesso.

  4. Volte para o Fin para confirmar que a conexão aparece como Connected.

Nota: O Zendesk está descontinuando a autenticação por token de 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 de API continuam funcionando por enquanto, mas você precisa mudar ambas as conexões do Zendesk para OAuth até 31 de janeiro de 2027. Veja Como mudar sua conexão Fin para Zendesk de chaves de API para OAuth.

Conecte-se ao Zendesk Sunshine

Se seu workflow inclui Hand-off to Zendesk agent, você também deve conectar ao Zendesk Sunshine. O Zendesk Sunshine também se conecta com OAuth. Conecte-se primeiro ao Zendesk: Conectar ao Zendesk Sunshine fica indisponível até que sua conta Zendesk esteja conectada. Se você conectou o Zendesk Sunshine com chaves de API antes, veja Como mudar sua conexão Fin para Zendesk de chaves de API para OAuth.

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

  2. Expanda Connect to Zendesk Sunshine e selecione Connect to Sunshine.

  3. Uma janela popup abrirá. Faça login no Zendesk usando OAuth e aprove o acesso.

  4. Volte para o Fin para confirmar que a conexão aparece como Connected.

Se você usa um navegador que bloqueia popups, permita popups para app.intercom.com para que o fluxo OAuth possa ser concluído.

Nota: A API do Zendesk Chat foi descontinuada em favor do Zendesk Sunshine. Você precisará de uma licença Sunshine Conversations para conectar o Zendesk Sunshine.

Se você não vê a opção “Zendesk Sunshine” nas configurações de administrador do Zendesk em Apps and integrations > APIs > Zendesk Sunshine, provavelmente você não tem uma licença Sunshine Conversations e precisará contatar o suporte Zendesk para obtê-la.

Defina o Fin como o respondedor padrão no Zendesk

Após conectar o Zendesk Sunshine, defina o Fin como o respondedor padrão no Zendesk. As conversas do Fin Messenger não chegam em um canal de mensagens do Zendesk, então o Zendesk as envia para seu respondedor padrão. Se o Fin não for o padrão, elas vão direto para seus agentes Zendesk em vez do Fin.

  1. No Zendesk, vá para AI > AI agents > Marketplace bots.

  2. Verifique se o Fin AI Agent mostra um rótulo Default. Se mostrar, o Fin já é o padrão e não há mais nada a fazer.

  3. Se não houver rótulo Default, abra o menu ⋮ ao lado do Fin AI Agent e escolha Set AI agents as default for all channels. Então verifique se o rótulo Default aparece.

Use essa opção de menu somente quando o rótulo Default estiver ausente. Escolhê-la quando o Fin já é o padrão remove o Fin como padrão. Escolher canais na página do Fin AI Agent também não torna o Fin o padrão.

No Fin, você também pode encontrar esses passos em Settings > Fin Messenger > Set Fin as the default responder in Zendesk.

Como o Zendesk Sunshine funciona

O Zendesk Sunshine 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 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 Hand-off to Zendesk agent ou Determined by situation, o Zendesk exige que Multiple conversations esteja habilitado.

Página de configuração do Fin Messenger no Zendesk mostrando o caminho no Admin Center para habilitar Multi-conversations nas configurações de Messaging.
  1. No Fin, vá para Settings > Fin Messenger > Configure in Zendesk.

  2. No Zendesk, vá para Admin Center > Channels > Messaging > Manage settings > Multi-conversations e habilite Multiple Conversations. Você pode clicar em Manage in Zendesk no Fin para abrir o Zendesk.

  3. Volte para o Fin e clique em Refresh.


Construa seu workflow

Configure o workflow de saudação e transferência

Na tela de integração, clique em Manage workflow. Um modelo é fornecido, mas você pode personalizar completamente:

Visão geral do workflow do Fin Messenger mostrando uma nova conversa, uma mensagem de boas-vindas e uma etapa Deixe o Fin cuidar com um caminho de transferência.
  • Quando o Fin deve responder

  • Como o Fin cumprimenta os clientes

  • O que acontece na escalada

  • Quais dados coletar antes da transferência

No final de qualquer caminho não resolvido, Fin se desatribui e aplica a tag routed-to-the-team.

Clique na etapa Deixe Fin cuidar no seu workflow para personalizar o seguinte:

Painel Deixe Fin cuidar listando opções para treinamento, expectativas de suporte humano, perguntas de transferência, acompanhamento de clientes inativos, CSAT e fechamento automático de conversas abandonadas.
  • Definir expectativa para suporte humano - Mostrar a presença dos colegas em uma conversa no messenger. Desative isso se sua equipe toda trabalhar em outra ferramenta ou ninguém estiver monitorando o inbox.

  • Acompanhar clientes inativos - Decida o que acontece se o cliente não responder após Fin responder.

  • Pedir mais informações antes da transferência - Coletar mais informações quando um cliente pedir para falar com a equipe. Ao coletar mais informações, Fin pode fornecer uma resposta adicional — aumentando a probabilidade de resolução.

  • Criar ticket Zendesk quando Fin responder - Este recurso foi descontinuado e não está mais disponível. Zendesk agora oferece “AI Agent Tickets” para todos os clientes, que criam automaticamente visibilidade em conversas apenas com IA. Os tickets AI Agent do Zendesk estão ativados por padrão. Saiba mais sobre os Tickets AI Agent do Zendesk.

  • Pedir avaliação da conversa (CSAT) - Escolha enviar uma pesquisa CSAT após os clientes interagirem com Fin.

  • Fechar automaticamente conversas abandonadas do Fin - Decida quanto tempo Fin deve esperar antes de considerar um cliente inativo, quando fechar conversas inativas e personalize o que Fin diz ao fechar a conversa.

Configurando as configurações de fechamento automático

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 Deixe Fin cuidar. Siga estes passos para gerenciar e personalizar as configurações de fechamento automático:

  • Dentro da etapa Deixe Fin cuidar, encontre a seção intitulada Fechar automaticamente conversas abandonadas do Fin.

  • 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 Tempo para fechar por inatividade na mesma seção Deixe Fin cuidar. Essas configurações permitem gerenciar quanto tempo 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 (por exemplo, 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 rapidez 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: Faça 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 nas suas condições.

  • Escolher quando Fin responde.

  • Fazer 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 de edição para poder fazer alterações no seu workflow. Selecione Editar no canto superior direito da tela do editor de workflow.

Caminho do workflow Fin terminando em uma ação Criar ticket Zendesk, com uma dica explicando que um ticket separado é criado com o resumo da conversa.
Caminho do workflow Fin terminando em uma ação Transferir para agente Zendesk, com uma dica explicando que um chat ao vivo é criado para um membro da equipe.

No caminho final de transferência do workflow, você pode escolher como Fin transfere a conversa:

O método de transferência selecionado determina quais APIs Zendesk você deve conectar.

Capacidade

Requer Zendesk API (OAuth)

Requer Zendesk Sunshine

Criar ticket Zendesk

Sim ✅

Não ❌

Transferir para agente Zendesk

Sim ✅

Sim ✅

Determinado pela situação

Sim ✅

Sim ✅

  • Criar um ticket Zendesk: Encerra a sessão do usuário no Fin e cria um ticket com um resumo da conversa e dados coletados.

  • Transferir para URL: Redireciona o usuário para uma nova URL na mesma aba.

  • Transferência com JavaScript: Usa handoff_with_javascript para definir ações no Fin Messenger.

  • Transferência para Agente Zendesk: Inicia um chat ao vivo no Zendesk para que um membro da equipe continue a conversa.

Se uma opção de transferência já foi selecionada, você pode removê-la passando o mouse sobre ela, clicando nos 3 pontos que aparecem e selecionando excluir.

Personalize os assuntos dos tickets Zendesk usando atributos

Se sua transferência criar um ticket Zendesk, você pode clicar na ação Criar ticket Zendesk para personalizar o assunto do ticket usando atributos no seu workspace Fin.

Painel Criar ticket Zendesk com o atributo AI Title no campo do título do ticket, um seletor de Formulários e um botão de verificação de e-mail.

Depois 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).

Atribua tickets a organizações Zendesk específicas

Se 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:

  1. Crie ou use uma organização existente no Zendesk com um id externo, isso pode ser criado através da API Zendesk aqui.

    Detalhes da organização Zendesk com ID Externo 457 destacado.
  2. Inclua um campo company no JWT com dois atributos:

    {
    "id": "457", // This should match the external ID of the Zendesk organization.
    "name": "Examply Org"
    }

  3. Configure um workflow Fin Messenger com a transferência Criar ticket Zendesk.

  4. Qualquer ticket criado pelo Fin Messenger será automaticamente atribuído à organização definida pelo external_id no 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 (e-mail não é suportado).

Dica: Você pode criar e gerenciar múltiplos workflows Fin diretamente no seu workspace Fin. Isso permite personalizar experiências para diferentes cenários de mensagens e configurar workflows “teste” 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

Escolha como você gostaria de instalar o Messenger

Primeiro, você precisará escolher como deseja instalar o messenger. Se 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 opção. Para os métodos listados que permitem instalação para Usuários com login e Visitantes sem login, você precisará copiar o snippet de código para cada método de instalação que desejar usar.

Para Usuários com login, você precisará ativar o botão Enable connection to messenger para continuar para o código de instalação.

Siga as instruções fornecidas

Agora siga as instruções para o método que você selecionou. Por exemplo, se escolheu 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 o Rails gem para instalar o snippet.

Clique em Copiar código e cole antes da tag </body> em todas as páginas onde deseja 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 pode usar a opção Verificar instalação no processo de instalação.

Proteja o Fin Messenger com JWTs

Se você instalou o Fin Messenger no seu site para usuários logados, é essencial protegê-lo para evitar que agentes mal-intencionados se passem por seus usuários ou enviem dados não autorizados. ​

JSON web tokens (JWTs) impedem que terceiros se passem por seus usuários 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 permite interações mais dinâmicas e personalizadas dentro dos seus workflows.

Evite depender apenas da segmentação por URL: Não use apenas URLs para distinguir entre usuários logados e não logados. URLs podem ser salvas como favoritos ou acessadas por usuários não autorizados, tornando isso inseguro. Combine segmentação por URL com JWT para autenticação robusta.

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 opções para React Native

  1. Swift

  2. Swift UI

  3. ObjectiveC

  1. Kotlin

  2. Java

  1. iOS

  2. Android

Siga as instruções

Em seguida, siga as instruções específicas da plataforma para integrar o Fin Messenger ao seu aplicativo móvel.

Ao configurar o Fin Messenger para dispositivos móveis

O Fin Messenger funciona com o SDK móvel do Intercom (software development kit), então você não precisa de uma chave Zendesk no código do seu app.

  1. No seu workspace Fin, vá para Deploy e abra Fin Messenger.

  2. Na etapa Install Fin Messenger, selecione Install.

  3. Selecione Install for mobile, depois expanda Install the messenger on your mobile app.

  4. Em Choose how to install the messenger, selecione iOS, Android ou React Native.

  5. Siga Install Intercom in your iOS app. Ative Enable the Messenger API para continuar a instalação, depois adicione o SDK com Swift Package Manager, CocoaPods ou Manual.

  6. Em Initialize Intercom, copie o trecho de código para o seu application delegate. Ele já inclui o app ID do seu workspace e a iOS API Key.

  7. Complete Update your Info.plist file, depois selecione Check the installation.

Você pode ver sua iOS API Key ou Android API Key nesta página a qualquer momento. Regenerate API key cria uma nova, e apps que usam a chave antiga param de funcionar até que você as atualize.

Passando para um agente Zendesk ao vivo? Conecte o Zendesk Sunshine uma vez para seu workspace, não para cada app. Veja Conecte-se ao Zendesk Sunshine acima.

Verificar instalação

Clique em Check installation ao final da configuração para verificar 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 por 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á você pelo 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 forem detectadas como configuradas para um app iOS ou Android.

Importante: Xcode 14 agora é obrigató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:

  1. Erro WKWebView - Veja o artigo e você verá isto no console: Error acquiring assertion: <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}>

  2. Este método não deve ser chamado na thread principal pois pode causar falta de resposta da UI.

  3. [Sandbox] Não foi possível ativar 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 começar os 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 antes de entrar 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 testar o Fin antes de entrar 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 o veja.

Para testar o Fin no Fin Messenger antes de entrar ao vivo:

  1. Vá para Deploy > Fin Messenger.

  2. Clique em Test before going live no canto superior direito da página.

    Página Deploy do Fin Messenger mostrando status ao vivo e o botão Test before going live no canto superior direito.
  3. Ative o botão Enable test mode.

    Seção de modo de teste do Fin Messenger com o botão Enable test mode e o campo Launch test URL.
  4. No campo Launch test, insira a URL da página onde seu Fin Messenger está instalado e inicie o teste. Você também pode adicionar ?intercomTest=true ao final da URL dessa página.

Importante: O modo de teste não está disponível enquanto o Fin Messenger estiver ao vivo. Se estiver, o Fin mostrará “Fin Messenger já está ao vivo. Pause-o para usar o modo de teste.” Pausar remove o Fin dos chats dos seus clientes, então pause somente quando estiver pronto.

Iniciando o teste

Navegador mostrando uma URL de página com ?intercomTest=true adicionado, com o lançador do Fin Messenger aberto e anotações apontando para o parâmetro de teste e o messenger.

Testando para dispositivos móveis

Para testar no celular, você precisa 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 usuários corretos estão atribuídos como solicitantes do ticket no Zendesk.

Para confirmar isso:

  1. Inicie uma conversa no Fin Messenger garantindo que o user_id ou email correto esteja sendo passado.

  2. Quando o Fin transferir a conversa, verifique o novo ticket ou chat ao vivo criado no Zendesk.

  3. Verifique se o solicitante corresponde ao usuário esperado.

  4. Se o solicitante não corresponder, confirme se 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 (que pode ser personalizada).

Launcher do Fin Messenger mostrando uma saudação "Oi" e a primeira mensagem, “Oi! O que te traz aqui hoje?”

O Fin responde ao cliente no Fin Messenger. Um ticket Zendesk só é criado quando a conversa é transferida para sua equipe, e é marcada com as tags fin-routed-to-team e fin-unresolved. Use o workflow no Fin para decidir quando o Fin responde.

Se o Fin tiver conhecimento relevante disponível para responder, ele responderá e citará as fontes usadas. Nenhum ticket Zendesk é criado.

Conversa no Fin Messenger onde o Fin lista as fontes, pergunta se a resposta foi útil e oferece os botões “Isso ajudou” e “Falar com uma pessoa”.

Se a pergunta for ambígua, o Fin fará perguntas para esclarecer.

Se não tiver uma resposta, ele transferirá a conversa para sua equipe, e um ticket Zendesk será criado para eles.

O cliente pode fazer perguntas de acompanhamento e o Fin seguirá o mesmo processo.

Se o cliente pedir para falar com a equipe, o Fin transfere a conversa e um ticket Zendesk é criado com a tag “fin-routed-to-team”. Usando essa tag, você pode criar gatilhos Zendesk adicionais para encaminhar o ticket.

Ticket Zendesk com status Aberto e a tag fin-routed-to-team após o cliente pedir para falar com uma pessoa.

Quando o agente responder, aparecerá no Fin Messenger. 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.

Nota: Você não pode usar o Fin Messenger para mensagens tanto do Fin quanto de Proactive Support (como chats de saída, posts, tours de produto, email, etc.)

Aprenda como configurar o Fin para tickets Zendesk.

Respondeu à sua pergunta?