Este guia cobre a configuração do Fin Messenger com o repasse para HubSpot. Os clientes conversam com o Fin pelo 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 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 gerenciar a 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 acesso ao Fin à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 nossos termos de 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 → Settings.
Clique em Connect a channel.
Selecione sua conta Fin Messenger na lista para começar a receber conversas do Fin Messenger na sua inbox do HubSpot.
Clique em Connect with Fin messenger para continuar a configuração.
Clique em Connect para completar a configuração e conectar seu canal Fin Messenger ao seu Helpdesk HubSpot.
Opcionalmente, ative Auto assign conversations para encaminhar automaticamente as conversas recebidas a um colega.
Após instalar, volte ao seu workspace Fin e clique em Refresh status para continuar.
Dica: Teste o Messenger em um ambiente QA antes de instalar 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 your connection to 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 assumidos | Novo |
Aguardando cliente | O Fin move o ticket para aqui enquanto aguarda 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 entre 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 para outro 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 ativar.
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 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 Test 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 aparece apenas 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: Vá ao vivo com o Fin Messenger
Quando estiver pronto, clique em Go live no fluxo de deploy. Isso ativa os quatro workflows HubSpot e o Fin começará a gerenciar conversas com base no workflow e knowledge base configurados. 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 mapped waiting-on-team 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 toda a conversa 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 no HubSpot — isso é um risco sério de segurança. Desative OTP apenas se tiver total confiança na sua 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 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, 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), users devem verificar seu email com uma senha única (OTP) antes da passagem. Isso impede que usuários 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 de Messenger não seguras — não substitui a 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 com 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 para cada audiência.
Como os públicos se combinam
Os públicos não têm uma ordem de prioridade, e um público mais específico não substitui um mais amplo. Fin pode usar um conteúdo para qualquer visitante que corresponda a pelo menos um dos públicos associados a ele.
Por exemplo, se o público de um trecho geral for "URL contém example.com", ele também corresponde a visitantes em example.com/london, então Fin pode usá-lo junto com seu conteúdo específico para Londres.
Para manter o conteúdo geral fora das páginas específicas de localização, adicione uma condição ao público geral que as exclua, como "URL não contém /london".
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 das URLs do seu site. Se você atualizar o conteúdo em uma página sincronizada, será necessário sincronizá-la novamente para que Fin detecte as mudanças — Fin não detecta atualizações automaticamente.
Desativar vs. revogar
Quando precisar pausar ou remover a integração com 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 excluídos permanentemente, 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á lidando ativamente 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. 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 da 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á definido 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. Públicos não têm ordem de prioridade, então se um público geral também corresponder às páginas da localização, adicione uma condição que exclua essas páginas (como "URL não contém /london").
Confirme que os snippets relevantes e sincronizações web estão associados 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.











