Conectar o HubSpot

Atualizado em 20 de nov. de 202616 min de leitura
Português
Nesta página

Conecte sua conta do HubSpot, e sua equipe vê ao lado da conversa o contato do HubSpot de cada cliente, a empresa, os negócios abertos e os tickets do HubSpot abertos. O Deskwoot vincula as pessoas que escrevem para você aos contatos delas no HubSpot, adiciona as que o HubSpot ainda não tem e registra cada conversa resolvida no contato como uma nota. Depois que o cartão do Deskwoot é adicionado no HubSpot, os usuários do HubSpot que são membros do seu workspace veem as conversas do cliente no Deskwoot nos registros de contatos e empresas do HubSpot.

Cada workspace do Deskwoot conecta uma conta do HubSpot, e uma conta do HubSpot pertence a um único workspace do Deskwoot. Todos os planos do Deskwoot podem conectar o HubSpot.

Quem pode conectar

  • No Deskwoot, um administrador conecta o HubSpot, porque depois o Deskwoot grava no HubSpot sozinho. Uma pessoa da equipe com a permissão Gerenciar integrações pode reconectar uma conexão existente ou desconectá-la.
  • No HubSpot, um Superadministrador ou um usuário com acesso ao App Marketplace permite o acesso do Deskwoot.

Conectar o HubSpot

  1. Vá em Configurações > Integrações e clique no cartão HubSpot em CRM e imóveis.
  2. Clique em Conectar HubSpot.
  3. Entre no HubSpot e escolha a conta que este workspace usa.
  4. Permita o acesso do Deskwoot.
  5. Se o HubSpot disser que o app não é verificado, digite a frase de confirmação que o HubSpot mostra nessa página e confirme. O HubSpot pede isso enquanto o app do Deskwoot ainda não está listado no HubSpot App Marketplace.

Depois o HubSpot traz você de volta à página do HubSpot no Deskwoot, que mostra Conectado. Não há nada para importar: o Deskwoot lê o HubSpot ao vivo e começa com as pessoas que escrevem para você depois que você conecta. Se você cancelar no HubSpot, o HubSpot abre a página inicial dele. Volte para a página do HubSpot no Deskwoot e clique em Conectar HubSpot de novo. O Deskwoot nunca vê sua senha do HubSpot.

O que o Deskwoot lê e grava

O HubSpot pede que você permita ao Deskwoot ler contatos, empresas, negócios, tickets e proprietários, e criar contatos, notas, tarefas e tickets. Destes, o Deskwoot grava contatos, notas e tarefas:

  • Contatos: as pessoas que o HubSpot ainda não tem, quando Adicionar clientes novos ao HubSpot está ligado ou sua equipe clica em Adicionar ao HubSpot. O Deskwoot nunca muda os campos de um contato que o HubSpot já tem.
  • Notas: uma nota por conversa resolvida, e as notas que sua equipe adiciona.
  • Tarefas: as tarefas que sua equipe adiciona.

O Deskwoot não guarda cópia dos seus registros do HubSpot. Ele guarda qual contato do HubSpot pertence a qual dos seus contatos, o nome da conta do HubSpot, o e-mail de quem a conectou e, por 90 dias, um registro curto de cada gravação.

A seção HubSpot numa conversa

Numa conversa, a aba Detalhes tem uma seção HubSpot. A página do contato tem a mesma seção em Sistemas conectados, com tudo o que o Deskwoot enviou para o contato. Para um contato do HubSpot vinculado, ela mostra:

  • o nome do contato com Abrir no HubSpot;
  • E-mail, Fase do ciclo de vida, Status do lead, Proprietário (Ainda sem responsável quando o contato não tem proprietário), Cargo, Empresa e Proprietário da empresa (só quando não é o proprietário do contato);
  • até 3 negócios abertos do contato e da empresa principal dele, com etapa, valor e data de fechamento;
  • até 3 tickets do HubSpot abertos, os mais recentes primeiro.

As etapas mostram os nomes do próprio HubSpot, e os valores mantêm a moeda do HubSpot. Quando nenhum contato está vinculado, o Deskwoot sugere o contato do HubSpot com o mesmo e-mail, ou então com o mesmo telefone. Sua equipe pode clicar em Vincular, escolher Não é este contato ou usar Buscar contato para procurar no HubSpot por nome, e-mail ou telefone. Vincular ou desvincular não muda nada no HubSpot. Quando o HubSpot mesclou o contato vinculado com outro, a seção oferece Vincular o registro mesclado. Sua equipe só vê a seção para contatos cujas conversas ela pode abrir.

Numa conversa, sua equipe também adiciona ao HubSpot pela seção:

  • Adicionar nota: o texto, um link para a conversa e uma referência, no contato vinculado.
  • Adicionar tarefa: uma tarefa do HubSpot no contato vinculado, com o prazo que a pessoa da equipe indicar. O proprietário é o usuário do HubSpot com o e-mail confirmado dessa pessoa.
  • Adicionar ao HubSpot, enquanto nenhum contato está vinculado: o Deskwoot vincula o contato do HubSpot com o e-mail do cliente ou adiciona um contato novo quando não há nenhum. Isso precisa da permissão Criar clientes, pacientes e contatos em sistemas conectados.

Quando o vínculo é comprovado (alguém da equipe vinculou o contato, manteve o vínculo ou adicionou o contato, o cliente verificou o e-mail, ou o cliente escreveu para você de um e-mail que o contato do HubSpot tem), as notas e tarefas também vão para a empresa principal do contato.

Clientes novos

A cada 5 minutos, o Deskwoot procura no HubSpot as pessoas que escreveram para você pelo e-mail delas e vincula o contato do HubSpot que encontrar. O cartão Clientes novos na página do HubSpot define o que acontece:

  • Adicionar clientes novos ao HubSpot, ligado por padrão: pessoas que o HubSpot ainda não tem viram contatos do HubSpot, no máximo 200 por dia. Um contato novo recebe o nome, o e-mail, o telefone e a empresa da pessoa, e como proprietário o usuário do HubSpot com o e-mail confirmado da pessoa da equipe atribuída à conversa. Quando a configuração do HubSpot de criar e associar empresas está ligada, o HubSpot cria sozinho uma empresa a partir do domínio do e-mail; o Deskwoot nunca cria uma.
  • Caixas de entrada procuradas no HubSpot: sem escolha, todas as caixas de entrada menos as de e-mail, inclusive as que você criar depois. As de e-mail ficam de fora porque também recebem newsletters e e-mails de fornecedores.
  • Base legal para contatos novos: veja a próxima seção.

O Deskwoot só considera pessoas com e-mail que escreveram elas mesmas na conversa. Ele deixa de fora contatos bloqueados, spam, grupos, conversas do Discord e threads de canais do Microsoft Teams. Quando um contato vinculado é excluído no HubSpot, o Deskwoot nunca adiciona essa pessoa de novo sozinho enquanto o HubSpot continuar conectado; sua equipe ainda pode adicioná-la com Adicionar ao HubSpot. Quando os 200 por dia são atingidos, o cartão da conexão avisa, e as pessoas que escrevem nesse meio tempo só são adicionadas se escreverem de novo depois.

Ligar uma opção, escolher mais caixas de entrada e escolher uma base legal exigem um administrador. Uma pessoa da equipe que gerencia integrações pode desligar coisas e escolher menos caixas de entrada.

Associado por e-mail, não verificado

Um contato que o Deskwoot encontrou no HubSpot pelo e-mail mostra Associado por um e-mail dado no chat, não verificado até alguém da equipe clicar em Manter vínculo ou escolher o contato certo com Trocar contato. Até lá, a nota da conversa vai só para o contato, nunca para a empresa ou o negócio dele, e o Copilot é instruído a não passar nenhum dado do HubSpot ao cliente. Se a associação estiver errada, clique em Trocar contato e escolha o contato certo do HubSpot.

Uma conta do HubSpot com as configurações de privacidade de dados do HubSpot ligadas (a configuração de GDPR) recusa um contato novo sem uma base legal para o tratamento dos dados dele. O Deskwoot fica sabendo que a configuração está ligada pela primeira recusa do HubSpot. Quem decide a base legal é o seu workspace, então o Deskwoot nunca escolhe uma por você. As opções são as do próprio HubSpot:

  • Nenhuma (o padrão): o Deskwoot não envia base legal.
  • Interesse legítimo: prospect ou lead
  • Interesse legítimo: cliente existente
  • Interesse legítimo: outro
  • Execução de um contrato
  • Consentimento dado livremente pelo contato
  • Não se aplica

Quando o HubSpot recusa um contato novo por falta de base legal:

  • Problemas recentes na página do HubSpot mostra esse contato com o motivo.
  • O cartão Clientes novos avisa ao lado de Base legal para contatos novos que sua conta do HubSpot pede uma.
  • Até um administrador escolher uma, o Deskwoot não adiciona ninguém ao HubSpot automaticamente. Ele continua vinculando as pessoas que o HubSpot já tem. Os contatos que já estavam a caminho e as pessoas novas que escrevem nesse meio tempo ficam de fora, para não se acumularem como problemas; a página do contato mostra o motivo.

Depois que você escolhe uma base legal, o Deskwoot a envia com cada contato que adiciona. As pessoas novas voltam a ser adicionadas, e também as pessoas que ficaram de fora nos últimos 7 dias, as mais antigas primeiro, dentro do limite de 200 por dia. Sua equipe pode adicionar o contato que o HubSpot recusou e as pessoas que o Deskwoot não traz de volta com Adicionar ao HubSpot.

Uma nota por conversa

O cartão Registro de conversas define quais conversas vão para o HubSpot. Com Registrar conversas no HubSpot ligado (o padrão) e a conversa numa das caixas escolhidas em Caixas de entrada registradas (sem escolha, todas), uma conversa resolvida em que o cliente escreveu vai para o contato vinculado do HubSpot como uma nota. Quando a conversa é resolvida de novo depois de novas mensagens, o Deskwoot atualiza essa mesma nota em vez de adicionar outra. O Deskwoot guarda o registro de cada gravação por 90 dias: se a conversa for resolvida de novo mais de 90 dias depois do último registro dela, ou se a nota tiver sido excluída no HubSpot, ele adiciona uma nota nova.

A nota é escrita no idioma e no fuso horário do seu workspace. Ela diz se o cliente estava verificado, cita o número e a caixa de entrada da conversa, traz as mensagens que o cliente viu (nunca notas internas) sem os números de cartão que passam na verificação de Luhn, os IBANs válidos e os números do Seguro Social dos EUA escritos como 123-45-6789 (outros números, como os de documento, continuam no texto), e termina com um link para a conversa que só sua equipe pode abrir. Com um vínculo comprovado, a nota também vai para a empresa principal do contato e, quando exatamente 1 dos negócios do próprio contato está aberto, para esse negócio.

  • Cada nota e cada tarefa que o Deskwoot grava leva uma referência que começa com Ref dw-. Busque por ela no HubSpot para encontrar as entradas do Deskwoot, por exemplo para responder ao pedido de uma pessoa sobre os dados dela.
  • Quando um contato só é vinculado depois que a conversa foi resolvida, o Deskwoot registra as conversas resolvidas nos últimos 7 dias.
  • O Deskwoot não registra grupos, conversas do Discord nem threads de canais do Microsoft Teams, nenhuma conversa em que o cliente nunca escreveu (como uma campanha que ninguém respondeu) e nenhum ticket que recebeu mensagens de outro contato numa mesclagem.
  • O Deskwoot grava as notas de conversas e os contatos novos que adiciona sozinho a no máximo 2 por minuto em uma conta do HubSpot. Depois que você resolve centenas de conversas de uma vez, as notas chegam ao longo de algumas horas.

O cartão do Deskwoot no HubSpot

O cartão de app Deskwoot mostra as conversas do cliente no Deskwoot nos registros de contatos e empresas do HubSpot: as 10 mais recentes e quantas existem, cada uma com número, status, canal, última atividade, responsável e um link para o Deskwoot. Ele nunca mostra o texto das mensagens. O registro de uma empresa lista as conversas dos contatos da empresa, até os primeiros 100 contatos.

  • O cartão lista só contatos do HubSpot vinculados a um contato do Deskwoot. Um contato que só tem o mesmo e-mail não mostra nada.
  • Um usuário do HubSpot só vê a lista se o e-mail dele no HubSpot for o e-mail confirmado de um membro do seu workspace, e só as conversas que esse membro pode abrir no Deskwoot, dentro do período de histórico do seu plano.
  • Para adicionar o cartão, um Superadministrador ou um usuário do HubSpot que pode personalizar o layout dos registros adiciona o cartão de app Deskwoot à barra lateral direita dos contatos e das empresas, nas configurações de personalização de registros do HubSpot.
  • A opção Mostrar conversas no HubSpot, no cartão Cartão do Deskwoot no HubSpot, vem ligada por padrão. Num workspace que exige 2FA ou login único, ela fica desligada até que um administrador a ligue. Depois disso, entrar no HubSpot basta para membros com 2FA; membros sem 2FA e membros que precisam entrar com login único veem um aviso para abrir o Deskwoot em vez disso.

IA e privacidade

  • Quando alguém da equipe pergunta ao Copilot sobre um cliente, o Copilot lê a fase do ciclo de vida, o status do lead, os proprietários, o cargo, a empresa, os negócios abertos e os tickets do HubSpot abertos do contato vinculado, nunca um e-mail ou telefone. Ele só lê um contato vinculado, nunca um que apenas corresponde.
  • Esses dados chegam à Anthropic, o provedor de IA do Deskwoot, só para escrever a resposta. Nenhum dado do HubSpot treina um modelo de IA.
  • O Fynn, o agente de IA que responde aos seus clientes, não lê dados do HubSpot.
  • O Deskwoot guarda o acesso ao HubSpot criptografado no banco de dados dele na UE. O HubSpot guarda seus dados no data center que você escolheu para sua conta do HubSpot.
  • Quando os dados de uma pessoa são apagados no Deskwoot, o vínculo com o contato dela no HubSpot e os registros do que foi enviado para ela também são apagados. Você apaga o contato no HubSpot por conta própria.

Desconectar

Desconectar HubSpot no fim da página do HubSpot encerra a conexão. O Deskwoot apaga o acesso, os vínculos entre seus contatos e os contatos do HubSpot e os IDs, nomes de registros e mensagens de erro do HubSpot que guardou do que enviou para lá. Notas e contatos novos que ainda esperam não são enviados. O Deskwoot também remove o app dele da sua conta do HubSpot, e o HubSpot envia um e-mail aos seus administradores do HubSpot sobre isso. Tudo o que já está no HubSpot continua lá.

Se o HubSpot não confirmar que o app foi removido, o Deskwoot avisa: remova o app no HubSpot em Configurações, Integrações, Aplicativos conectados. Excluir seu workspace do Deskwoot desconecta o HubSpot antes, do mesmo jeito. O registro de auditoria do Deskwoot guarda um registro de cada conexão, que continua depois de desconectar.

Solução de problemas

  • O HubSpot não concedeu todas as permissões de que o Deskwoot precisa. Conecte de novo e permita todas.
  • Faltam permissões na página do HubSpot: o HubSpot não concede mais todas as permissões de que o Deskwoot precisa. Clique em Reconectar e permita todas.
  • Precisa entrar de novo: o HubSpot não aceita mais o acesso do Deskwoot, por exemplo porque alguém removeu o Deskwoot no HubSpot. Os administradores recebem um e-mail. Clique em Reconectar em até 30 dias depois da data que a página mostra. Até lá, o Deskwoot não consegue ler nem gravar no HubSpot; depois de 30 dias, ele remove a conexão e os vínculos entre seus contatos e os contatos do HubSpot, como ao desconectar.
  • Esta conta do HubSpot já está conectada a outro workspace do Deskwoot. Desconecte primeiro naquele workspace.
  • O HubSpot conectou o Deskwoot só para o seu usuário do HubSpot, não para a conta inteira. Escreva para hello@deskwoot.com para resolvermos isso.
  • O HubSpot não deixa você instalar o Deskwoot. Até o HubSpot listar o Deskwoot no App Marketplace dele, o HubSpot permite o app do Deskwoot em no máximo 25 contas do HubSpot. Se o HubSpot recusar a instalação, escreva para hello@deskwoot.com.

Problemas recentes na página do HubSpot lista os 10 itens mais recentes que não puderam ser enviados nos últimos 7 dias:

  • Isso precisa de um contato do HubSpot vinculado: notas e tarefas vão para um contato vinculado. Vincule um. Se for uma nota ou tarefa da sua equipe, clique depois em Tentar de novo na linha dela na conversa; a nota da conversa vem sozinha se a conversa foi resolvida nos últimos 7 dias.
  • O contato do HubSpot vinculado não existe mais: ele foi excluído no HubSpot. Vincule outro. Se for uma nota ou tarefa da sua equipe, clique depois em Tentar de novo na linha dela na conversa; a nota da conversa vem sozinha se a conversa foi resolvida nos últimos 7 dias.
  • O HubSpot não deixa o Deskwoot ver este contato: nada foi gravado. Adicione a nota ou a tarefa no HubSpot você mesmo.
  • O HubSpot não aceitou isso: em seguida vem o motivo do próprio HubSpot.
  • O HubSpot já tem um contato com este e-mail, e sua equipe disse que não é esta pessoa: vincule o contato certo do HubSpot com Buscar contato.
  • Sua conta do HubSpot pede uma base legal: escolha uma em Clientes novos (veja Base legal para contatos novos).
  • O HubSpot não está mais conectado: reconecte o HubSpot para o Deskwoot voltar a escrever lá.

Perguntas frequentes

O Deskwoot importa meus contatos do HubSpot?

Não. O Deskwoot lê um contato ao vivo enquanto sua equipe olha para ele e não guarda cópia dos seus registros do HubSpot. Ele guarda qual contato do HubSpot pertence a qual dos seus contatos, o nome da conta do HubSpot, o e-mail de quem a conectou e, por 90 dias, um registro curto de cada gravação. Em clientes novos, o Deskwoot começa com as pessoas que escrevem para você depois que você conecta.

O Deskwoot muda contatos no HubSpot?

Não. Ele adiciona contatos novos, notas e tarefas, e só atualiza as próprias notas de conversa. Ele nunca muda os campos de um contato que o HubSpot já tem.

Posso impedir que o Deskwoot adicione pessoas ao HubSpot?

Sim. Desligue Adicionar clientes novos ao HubSpot no cartão Clientes novos. O Deskwoot continua vinculando as pessoas que o HubSpot já tem, e os contatos que esperavam para ser adicionados não são enviados.

Por que as caixas de e-mail não adicionam clientes novos por padrão?

As caixas de e-mail também recebem newsletters e e-mails de fornecedores, que virariam contatos do HubSpot. Escolha essas caixas em Caixas de entrada procuradas no HubSpot se elas recebem só e-mails de clientes.

Posso conectar 2 contas do HubSpot a um workspace?

Não. Cada workspace conecta uma conta do HubSpot, e cada conta do HubSpot pertence a um workspace.

Este guia foi útil?

Continue lendo

Perguntar ao Fynn sobre este guia

Receba uma resposta curta deste guia e do resto da Central de Ajuda.

Ainda precisa de ajuda?

Fynn responde no chat a partir destes guias, e você também fala com a equipe por lá.