Este guia cobre a configuração do Fin Messenger com a transferência para o HubSpot. Os clientes conversam com o Fin via Fin Messenger no seu site; quando o Fin não resolve o problema, ele encaminha para a fila de agentes do HubSpot ou cria um novo ticket no HubSpot com a transcrição completa da conversa.
Pré-requisitos
Antes de começar, certifique-se de ter o seguinte:
HubSpot conectado via OAuth: Se ainda não conectou, vá para Connect na navegação principal para autorizar o acesso do Fin ao HubSpot — pule esta etapa se já estiver conectado.
Acesso ao site: Acesso ao código do seu site ou app para instalar o snippet do Fin Messenger.
Permissões do HubSpot: Acesso de administrador à sua conta HubSpot para adicionar um canal de inbox.
Dica: Crie um usuário dedicado — por exemplo, "Fin AI" — em vez de usar uma conta pessoal. Isso mantém a propriedade dos tickets do Fin separada das filas dos seus colegas e facilita a gestão da integração caso precise pausar ou revogar.
Parte 1: Conectar ao HubSpot
Vá para Connect na navegação principal para conectar ao HubSpot. A conexão é compartilhada entre HubSpot Tickets e Fin Messenger — se já conectou para HubSpot Tickets, pule para o próximo passo.
Conectar com HubSpot
Conecte sua conta HubSpot para dar ao Fin acesso às conversas e habilitar suporte com IA.
Clique no botão "Connect".
Você será redirecionado para o HubSpot para autenticar
Após autenticar, você será redirecionado de volta ao Fin para continuar.
Ao conectar o Fin ao HubSpot, você concorda com os termos da nossa plataforma de terceiros.
Na página Deploy › Fin Messenger você verá os passos para configurar o Fin Messenger.
Instale o canal Fin Messenger no seu portal HubSpot
Conecte o canal Fin Messenger no seu helpdesk HubSpot para permitir que o Fin responda às perguntas recebidas.
Vá para seu portal HubSpot.
Navegue para CRM → Inbox → Configurações.
Clique em Conectar um canal.
Selecione sua conta Fin Messenger na lista para começar a receber conversas do Fin Messenger na sua inbox do HubSpot.
Clique em Conectar com Fin messenger para continuar a configuração.
Clique em Conectar para completar a configuração e conectar seu canal Fin Messenger ao seu Helpdesk HubSpot.
Opcionalmente, ative Atribuir conversas automaticamente para encaminhar automaticamente as conversas recebidas a um colega.
Após a instalação, volte ao seu workspace Fin e clique em Atualizar status para continuar.
Dica: Teste o Messenger em um ambiente de QA antes de instalá-lo em produção.
Sincronizar dados do HubSpot
Esta etapa é opcional, você deve conectar ao HubSpot primeiro para sincronizar dados. Use esses dados para direcionar seu conteúdo a diferentes públicos, classificar tickets automaticamente e criar ramificações em workflows.
Configure sua conexão ao HubSpot
Na página Deploy › Fin Messenger, clique em Configure sua conexão ao HubSpot. Isso abre uma página de configurações com duas tarefas: selecione o usuário HubSpot que o Fin representa (use uma conta dedicada — por exemplo, ‘Fin AI’ — em vez de uma pessoal), depois escolha seu pipeline e mapeie seus estágios para os estados do Fin.
Estado Fin | O que significa | Estágio padrão do pipeline de suporte |
Novo ticket | O estágio que o Fin monitora para novos tickets a serem atendidos | Novo |
Aguardando cliente | O Fin move o ticket para aqui enquanto aguarda a resposta do cliente | Aguardando contato |
Aguardando sua equipe | Fin move o ticket aqui ao passar para um colega humano | Aguardando por nós |
Resolvido | Fin move o ticket aqui quando resolve uma conversa | Fechado |
Nota: Para encontrar os nomes do seu pipeline e estágio no HubSpot, vá para Configurações > Gerenciamento de Dados > Objetos > Tickets > Pipelines e clique no nome do seu pipeline. Esta configuração é compartilhada em todos os seus canais HubSpot — se você já configurou para HubSpot Tickets, pode pular esta etapa. Para atualizar esta configuração no futuro, vá para Configurações > Canais > Fin Messenger.
Parte 2: Construa seu workflow
Personalize a forma como Fin cumprimenta e responde aos clientes, ou passa adiante quando não consegue ajudar. Na página Deploy › Fin Messenger, clique em Adicionar workflow no seu espaço Fin para personalizar a experiência e ativá-la.
Um workflow com o gatilho quando um cliente abre uma nova conversa no Fin Messenger será preenchido automaticamente com um fluxo padrão. O workflow padrão inclui:
Uma etapa de triagem Fin — Fin tenta resolver a dúvida do cliente usando sua knowledge base e conteúdo
Um caminho de resolução — se Fin resolver a consulta, a conversa é fechada
Um caminho de passagem — se Fin não conseguir resolver, a conversa é escalada para sua fila de agentes HubSpot ou um novo ticket HubSpot é criado com a transcrição completa
Dentro do workflow você pode personalizar:
A mensagem de saudação que Fin envia quando um cliente abre uma conversa
As condições de passagem — quando Fin direciona para um colega vs. cria um ticket, e para qual inbox ou fila HubSpot direcionar. Existem dois modos de passagem para escolher: Passar para agente no HubSpot (quando o canal Fin Messenger está instalado no seu inbox HubSpot) ou Passar para ticket no HubSpot (quando não está).
Parte 3: Instale o Fin Messenger
Instale o Fin Messenger para web
Para instalação web:
Escolha seu método de instalação (Code snippet, React, Angular, Vue, Ember, Shopify)
Siga as instruções específicas do método — copie o pacote NPM/code snippet e cole antes da tag em cada página onde quiser que o Messenger apareça
Use Verificar instalação para confirmar que está funcionando
Instale o Fin Messenger para mobile
Para instalação mobile:
Escolha sua plataforma (iOS, Android ou React Native)
Inicialize o Fin no seu código e siga os passos específicos da plataforma
Gere sua chave API do SDK iOS se usar iOS
Use Verificar instalação para confirmar
Opcional: configure notificações push
Parte 4: Teste
Teste a integração
Use o painel de Teste Fin: Navegue até a aba Teste na barra lateral do Fin para pré-visualizar a qualidade das respostas e verificar os caminhos de escalonamento sem afetar seu site ao vivo.
Controle onde o Messenger é exibido: O Fin Messenger só aparece onde você instalar o code snippet. Para testes, instale em uma URL de staging ou use regras de URL na seção Deploy para restringir a uma página de teste específica (ex.:
yoursite.com/test) antes de liberar para todos os visitantes.
Parte 5: Entre no ar com o Fin Messenger
Quando estiver pronto, clique em Entrar no ar no fluxo de deploy. Isso ativa os quatro workflows HubSpot e o Fin começará a gerenciar conversas imediatamente com base no workflow e knowledge base que você configurou. Sua configuração de escalonamento depende se o canal Fin Messenger está instalado no seu inbox HubSpot.
Passar para agente no HubSpot
Use esta opção quando o canal Fin Messenger estiver instalado no seu inbox HubSpot. Quando Fin não consegue resolver uma conversa, ele atualiza o ticket para seu estágio mapeado aguardando equipe e desassocia o Fin para que um colega possa assumir no HubSpot.
Passar para ticket no HubSpot
Use esta opção quando o canal Fin Messenger não estiver instalado no seu inbox HubSpot. Fin gerencia a conversa completa no seu workspace sem sincronizar com o HubSpot. Na escalada, um novo ticket HubSpot é criado com a transcrição completa.
Importante: Se você desativar a verificação de usuário (OTP) ao passar para ticket, usuários logados não serão mais verificados antes da criação do ticket HubSpot. Sem a verificação de identidade JSON Web Token (JWT), um cliente pode se passar por outro usuário no HubSpot — isso é um risco sério de segurança. Desative OTP apenas se tiver total confiança na sua configuração de autenticação atual. Saiba mais sobre verificação de identidade do cliente com o passo de workflow Email OTP.
Verificação de usuário
Ao usar Passar para ticket no HubSpot, você pode exigir que os users verifiquem seu endereço de email antes da criação do ticket. Isso adiciona uma camada extra de confirmação de identidade no ponto de escalonamento.
Exigir verificação de email antes de passar para ticket: Quando ativado, os users devem verificar com sucesso seu email antes que um ticket HubSpot seja criado em seu nome.
Exigir OTP quando o Messenger não for seguro: Se o Messenger não estiver protegido com verificação de identidade JSON Web Token (JWT), os users devem verificar seu endereço de email com uma senha única (OTP) antes da passagem. Isso impede que users não verificados criem tickets sob a identidade de outra pessoa.
Dica: A configuração mais segura é implementar a verificação de identidade JWT no seu Messenger. OTP é um recurso de fallback para instalações do Messenger sem segurança — não um substituto para verificação adequada de identidade.
Nota: Durante a passagem no Messenger, se o cliente ainda não existir como contato no HubSpot, um novo contato é criado automaticamente usando as informações coletadas durante a conversa.
Segmentação de público e conteúdo
Se você atende múltiplas localidades ou marcas, configure Audiências separadas no Fin para cada uma e anexe os snippets relevantes e sincronizações web a cada audiência.
Regras de prioridade de audiência
Um público mais amplo (por exemplo, "URL contém theescapegame.com") não será automaticamente substituído por um mais específico (por exemplo, "URL contém theescapegame.com/nashville") a menos que o público específico esteja colocado em ordem de prioridade mais alta.
Se um visitante em uma página específica de localização estiver recebendo conteúdo do público errado, verifique se sua regra de público específico está classificada acima da geral.
Importante: Ao atualizar os públicos-alvo do conteúdo após a sincronização, exclua o conteúdo e sincronize novamente. Atualizar apenas o público em conteúdo já sincronizado pode não aplicar corretamente. Este é um comportamento conhecido — não uma limitação permanente — então verifique atualizações.
Nota: Fin pode sincronizar conteúdo diretamente dos URLs do seu site. Se você atualizar o conteúdo em uma página sincronizada, será necessário sincronizá-la novamente para que Fin capte as mudanças — Fin não detecta atualizações automaticamente.
Desativar vs. revogar
Quando precisar pausar ou remover a integração do HubSpot, você tem duas opções, e é importante entender a diferença.
Desativar, pausa a integração sem destruir sua configuração. Todos os workflows do HubSpot criados pelo Fin são desativados, e as conversas param de ser roteadas pelo Fin. Sua configuração, conexão OAuth e propriedades do HubSpot são preservadas. Você pode reativar a qualquer momento e continuar de onde parou.
Revogar, é uma desmontagem completa. A conexão OAuth é destruída, todos os 4 workflows do HubSpot criados pelo Fin são permanentemente excluídos, e sua configuração do Fin é removida. Será necessário passar pelo processo completo de configuração novamente se quiser reconectar.
Assumindo uma conversa do Fin
Se precisar intervir enquanto o Fin está ativamente lidando com uma conversa no Messenger, não desassocie manualmente o Fin antes de responder. Desassociar o Fin primeiro significa que ele não processará mensagens recebidas — porque não está mais atribuído.
Em vez disso, responda diretamente no HubSpot sem alterar a atribuição. O Fin detecta que um colega respondeu e automaticamente se afasta — não enviará mais respostas e limpará as tags do Fin para refletir a transferência.
Perguntas frequentes
Posso impedir que o Fin Messenger abra automaticamente quando um visitante retorna?
Posso impedir que o Fin Messenger abra automaticamente quando um visitante retorna?
Atualmente não há configuração nativa para evitar que o Fin reabra quando um visitante retorna à página. O visitante precisaria clicar manualmente no ícone do Messenger para reabri-lo. Contate sua equipe de contas Fin para registrar demanda por esse recurso.
Posso personalizar a mensagem "Sua conversa foi transferida"?
Posso personalizar a mensagem "Sua conversa foi transferida"?
A mensagem de confirmação de transferência ("Sua conversa foi transferida para um ticket de suporte. Você receberá atualizações por e-mail.") é uma mensagem do sistema e não pode ser editada.
Fin Messenger não aparece no site
Fin Messenger não aparece no site
Confirme que o snippet do Messenger está corretamente instalado no seu site e verifique se o Messenger está configurado como Ao Vivo nas configurações de Deploy do seu workspace Fin. Há um pop-out padrão "Precisa de ajuda?" que aparece após 6 segundos. Esse comportamento não pode ser totalmente desativado atualmente.
Tickets duplicados estão sendo criados no HubSpot
Tickets duplicados estão sendo criados no HubSpot
Tickets duplicados são criados quando ambos os modos de handoff estão ativos ao mesmo tempo. Veja como corrigir com base na sua configuração: Se usar Hand-off para agente no HubSpot: Remova o app Fin Messenger da sua inbox do HubSpot (vá para Configurações → Inboxes no HubSpot). Ter o canal Fin Messenger instalado no HubSpot ao mesmo tempo faz com que cada escalonamento gere dois tickets. Se usar Hand-off para ticket no HubSpot: Não tenha também o canal Fin Messenger instalado na sua inbox do HubSpot. O canal Fin Messenger já cria um ticket no handoff — adicionar um passo Hand-off para ticket no HubSpot duplica isso. Apenas um método de handoff deve estar ativo por vez.
Fin está dando respostas incorretas para uma localização específica
Fin está dando respostas incorretas para uma localização específica
Verifique o seguinte:
Confirme que seus Públicos estão configurados corretamente e que o público específico da localização está classificado acima de qualquer público geral na ordem de prioridade.
Confirme que os snippets relevantes e sincronizações web estão vinculados ao público correto, não ao geral.
Use o recurso Testar do Fin para simular um visitante de uma URL específica e verificar qual conteúdo o Fin está puxando.