Passar para o conteúdo principal

Fin Messenger: Configuração do HubSpot

Aprenda a configurar o Fin Messenger com HubSpot para resolver dúvidas do site e encaminhar questões complexas para sua inbox do HubSpot.

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".

    Botão Conectar ao HubSpot no workspace do Fin
  • 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.

Página Deploy › Fin Messenger mostrando visão geral completa dos passos de configuração

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.

  1. Vá para seu portal HubSpot.

  2. Navegue para CRM → Inbox → Settings.

    Página de Configurações do Inbox CRM do HubSpot mostrando a opção de conexão de canal

  3. Clique em Connect a channel.

  4. Selecione sua conta Fin Messenger na lista para começar a receber conversas do Fin Messenger na sua inbox do HubSpot.

    Seleção da conta Fin Messenger na lista de canais do HubSpot

  5. Clique em Connect with Fin messenger para continuar a configuração.

    Botão Connect with Fin Messenger na configuração do canal HubSpot

  6. Clique em Connect para completar a configuração e conectar seu canal Fin Messenger ao seu Helpdesk HubSpot.

    Botão Connect completando a conexão do Fin Messenger ao HubSpot
  7. Opcionalmente, ative Auto assign conversations para encaminhar automaticamente as conversas recebidas a um colega.

    Alternar Auto assign conversations nas configurações do canal Fin Messenger no HubSpot
  8. 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.

Página Deploy › Fin Messenger mostrando o passo Configure your connection to HubSpot

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.

Configurar Fin para HubSpot Messenger página de configurações mostrando o seletor de agente Fin HubSpot e seção Mapear estágios do pipeline


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

Quatro workflows Fin HubSpot mostrados nas configurações de Automação do HubSpot


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?

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"?

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

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

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.

Respondeu à sua pergunta?