Quando usar
- Você usa HubSpot e quer integrar a ClaudIA
- Você precisa do passo a passo oficial de webhook, app privado, escopos e atribuição
- Você quer entender os pré-requisitos da integração
Pré-requisitos
-
✅ Conta ativa e paga no HubSpot
-
🔐 Permissão de administrador no HubSpot
-
🤖 Projeto criado no Hub Cloud Humans
-
🔑 Usuário do HubSpot com 2FA (MFA) ativo
Sobre este artigo
Este artigo explica como realizar a integração ClaudIA ↔ HubSpot, permitindo atendimento automatizado, uso de webhooks, automações e transbordo para grupos ou agentes específicos.
Passo a passo
Etapa 1 — Acessar o Hub Cloud Humans
-
Acesse o projeto desejado
-
Vá em Integrações → HubSpot
-
No campo Webhook, clique em Gerar Webhook

Esse webhook será usado na configuração do aplicativo privado no HubSpot.
Etapa 2 — Criar aplicativo privado no HubSpot
-
No HubSpot: Desenvolvimento → Aplicativos privados
-
Clique em Criar um aplicativo privado
-
Preencha o Nome — ex:
CloudHumans | Connector
Configurar Escopos
Na seção Escopos, adicione:
-
conversations.read -
conversations.write -
forms -
oauth -
tickets -
settings.users.read(e demais conforme orientação completa do time)
Próximas etapas
Para os passos seguintes (configurar webhook no app, atribuição da ClaudIA aos canais etc.), consulte o vídeo passo a passo acima.
Observações
-
Para configurar atribuição: [HubSpot] Como configurar a atribuição para a ClaudIA
-
Para preencher campo via tags: [HubSpot] Preenchimento automático de campo no ticket com base nas tags
-
Para criar Ticket a partir de Conversation: [HubSpot] Como criar gatilhos para a partir da Conversation criar Tickets