Conectar o HubSpot

Conecte o HubSpot quando sua equipe de vendas ou de sucesso do cliente trabalha no HubSpot e sua equipe de suporte trabalha no FyneDesk. Novos tickets e respostas voltadas ao cliente podem ser registrados no contato correspondente do HubSpot para que todos vejam o contexto do suporte.

Antes de começar

• Você precisa ser um Administrador do FyneDesk.
• Você precisa de uma conta no HubSpot na qual tenha permissão para criar ou gerenciar um token de acesso de aplicativo privado.
• Decida se o FyneDesk deve criar um contato no HubSpot quando o solicitante de um ticket ainda não existir no HubSpot.
• Decida como o FyneDesk deve registrar a atividade de suporte no HubSpot: como uma nota, como um ticket ou ambos.

Passo 1 — Criar o token de acesso do HubSpot

1. Abra o HubSpot e vá para a área onde os aplicativos privados são gerenciados.
2. Crie um aplicativo privado para o FyneDesk, ou use um existente dedicado ao registro de helpdesk.
3. Dê a ele permissão para ler e atualizar a linha do tempo do contato, e para criar o tipo de atividade que você planeja usar.
4. Copie o token de acesso assim que ele for gerado.

Se você não for o administrador do HubSpot, peça ao administrador do HubSpot para criar o token e inseri-lo no FyneDesk com você. O token dá acesso aos seus dados do HubSpot, então trate-o como uma senha.

Passo 2 — Conectar o HubSpot no FyneDesk

1. No FyneDesk, abra Configurações → Conexões → HubSpot.
2. Cole o token de acesso do HubSpot no campo do token.
3. Escolha se o FyneDesk deve criar contatos ausentes no HubSpot.
4. Escolha onde a atividade de suporte deve aparecer no HubSpot: Nota, Ticket ou Ambos.
5. Clique em Conectar ou Salvar alterações.

Escolhendo as opções certas

Criar contatos ausentes é útil quando o suporte recebe e-mails de pessoas que ainda não estão no HubSpot. Se você quiser manter o HubSpot rigorosamente controlado, deixe desativado e crie os contatos manualmente.

Registrar como Nota é simples e funciona bem quando o HubSpot é usado principalmente como uma linha do tempo do cliente.

Registrar como Ticket é útil quando sua equipe do HubSpot quer que a atividade de suporte apareça como trabalho de serviço estruturado dentro do HubSpot.

Registrar como Ambos dá a maior visibilidade, mas também pode gerar mais ruído. Comece com Nota se estiver em dúvida.

Passo 3 — Testar a conexão

1. Crie ou abra um ticket de teste no FyneDesk para um contato que exista no HubSpot.
2. Adicione uma resposta pública ao ticket.
3. Abra o contato no HubSpot e verifique se a atividade de suporte aparece na linha do tempo ou na área de ticket que você selecionou.
4. Volte a Configurações → Conexões → HubSpot e abra os registros de entrega se precisar confirmar se um evento foi entregue.

Gerenciar ou desconectar

• Altere as opções a qualquer momento em Configurações → Conexões → HubSpot.
• Rotacione o token criando um novo token no HubSpot, colando-o no FyneDesk e salvando.
• Desconecte na mesma página se não quiser mais que o FyneDesk registre atividade no HubSpot.

Solução de problemas

O token é rejeitado. Verifique se foi copiado corretamente do HubSpot, se não foi revogado e se inclui as permissões necessárias para o tipo de atividade que você escolheu.

O contato não é encontrado no HubSpot. Verifique se o e-mail do solicitante do ticket corresponde ao e-mail do contato no HubSpot. Se a pessoa não existir no HubSpot, ative Criar contatos ausentes ou crie o contato manualmente.

A atividade aparece no contato errado. A correspondência do HubSpot depende do endereço de e-mail. Confirme o e-mail do solicitante no ticket e o e-mail do contato no HubSpot.

Os eventos estão atrasados ou falharam. Abra os registros de entrega na página de conexão do HubSpot. Eventos com falha geralmente indicam um token revogado, permissões ausentes no HubSpot ou um problema temporário do HubSpot.

Privacidade e confiança

O FyneDesk envia apenas a atividade de suporte necessária para a integração. Os tokens são armazenados com segurança e não são exibidos por completo após salvar. Não inclua segredos, senhas ou detalhes internos privados nas respostas públicas de tickets, porque as respostas públicas são a parte da conversa do ticket que pode ser registrada no HubSpot.