Principal Integrações com Helpdesks [Hubspot] Guia passo a passo da integração

[Hubspot] Guia passo a passo da integração

Última atualização em Jan 29, 2026

⭐ Resumo

Este artigo explica como realizar a integração entre a ClaudIA e o HubSpot, permitindo atendimento automatizado, uso de webhooks, automações e transbordo para grupos ou agentes específicos.

🎥https://www.loom.com/share/eb03d2d315734b8b9546501cbfc6efc1

Pré-requisitos

  • ✅ Conta ativa e paga no HubSpot

  • 🔐 Permissão de administrador no HubSpot

  • 🤖 Projeto criado no Hub da Cloud Humans

  • 🔑 Usuário do HubSpot com 2FA (MFA) ativo

Passo a passo da integração

1️⃣ Acessar o Hub da Cloud Humans

  1. Acesse o projeto desejado.

  2. Vá em Integrações.

  3. Selecione HubSpot.

  4. No campo Webhook, clique em Gerar Webhook.

🔔 Esse webhook será utilizado na configuração do aplicativo privado no HubSpot.

2️⃣ Criar um aplicativo privado no HubSpot

  1. No HubSpot, acesse Desenvolvimento.

  2. Selecione Aplicativos privados.

  3. Clique em Criar um aplicativo privado.

  4. Preencha o campo Nome. Exemplo: CloudHumans | Connector

🔐 Configurar Escopos

Na seção Escopos, adicione:

  • conversations.read

  • conversations.write

  • forms

  • oauth

  • tickets

  • settings.users.read

  • settings.users.teams.read

⚠️ Atenção: todos os escopos são obrigatórios para o funcionamento correto da integração.

🔗 Configurar Webhooks

  1. Na seção Webhooks, cole a URL gerada no Hub da Cloud Humans.

  2. Clique em Criar assinatura e configure:

    • Qual tipo de objeto? Conversa

    • Monitorar quais eventos?

      • Nova mensagem

      • Alteração de propriedade

    • Quais propriedades? assignedTo

  3. Clique em Assinar, e depois em Criar aplicativo > Continuar criando.

  4. Após, acesse Autenticação > Token de Acesso > Exibir token

  5. Copie o Token de acesso gerado.

3️⃣ Voltar ao Hub da Cloud Humans

  1. Cole o Token de acesso no campo Token.

4️⃣ Configurar autenticação (Senha e MFA)

  1. No campo MFA, informe a chave da autenticação em dois fatores:

    • Se estiver em formato de URL, copie apenas o valor entre secret= e &issuer=HubSpot. Exemplo:
      otpauth://totp/HubSpot:[email protected]?secret=XXXXXXXXXXXXXX&issuer=HubSpot

    • Se estiver no formato XXXX XXX XXX, remova os espaços.

  2. No campo Senha, informe a mesma senha usada para login no HubSpot.

  3. Clique em Salvar. ✅

5️⃣Configurar transbordo de conversas

No campo transbordar conversas para, escolha:

👥 Transbordo para grupos (N2)

  • Copie o ID da Equipe na tabela Equipes do HubSpot.

  • Cole no campo Id N2.

🙋 Transbordo para agente específico

  1. No HubSpot, vá em Configurações > Usuários e equipes.

  2. Abra o perfil do agente.

  3. Copie o número da URL entreuser/ e ?tab=overviweTab

  4. Cole no campo Identificador N2.

⚠️ Observações importantes

  • Certifique-se de que o usuário da ClaudIA no HubSpot esteja na caixa de entrada que irá atuar.

  • A ClaudIA é considerada um agente, portanto: Automações e criação de tickets funcionam normalmente.

  • Não adicione a ClaudIA à equipe de N2: Isso pode causar loop de atendimento e prejudicar a experiência do cliente.