Pré-requisitos
- Conta HubSpot com acesso ao portal/dados que você precisa.
- Permissão para autorizar o app da HubSpot nesse portal.
Como conectar
1
Abra o painel de Conectores
No chat, clique no + ao lado da caixa de mensagem e selecione Connectors.
Você também pode gerenciar conectores na edição do agente no Agent Studio.

2
Localize HubSpot e clique em Connect
Em Apps, encontre HubSpot e clique em Connect para iniciar a autenticação.

3
Autorize o acesso
Faça login na conta desejada e revise as permissões solicitadas antes de confirmar.
4
Confirme que está ativo
Ao voltar para a Tess, HubSpot deve aparecer em Connected, pronto para chats e agentes.

O que você pode fazer
- Buscar contatos, empresas e deals no CRM
- Resumir status do pipeline e próximos passos das oportunidades
- Criar ou atualizar registros quando a conta tiver permissão de escrita
- Apoiar follow-ups com contexto de notas, propriedades e estágios
- Ajudar times de vendas e CS a agir sem trocar de ferramenta
Exemplos de prompt
- Encontre o deal da Acme no HubSpot e resuma estágio, valor e próximo passo.
- Liste contatos criados esta semana sem owner atribuído.
- Atualize a nota do deal da Acme com o resumo da call de discovery de hoje.
- Quais deals abertos estão parados em Negotiation há mais de 14 dias?
Boas práticas
- Nomeie empresa/deal com clareza para evitar duplicidade.
- Peça confirmação antes de atualizar campos do CRM.
- Em agentes, defina se o HubSpot é para consulta, report de pipeline ou atualização.
Troubleshooting
A autorização falha
A autorização falha
Confirme que você está autorizando o portal HubSpot correto e que seu papel pode conceder acesso ao app.
401 / conexão caiu
401 / conexão caiu
Reconecte o HubSpot em Conectores após mudança de senha ou permissão.
Registro não encontrado ou somente leitura
Registro não encontrado ou somente leitura
O usuário conectado pode não ter permissão nesse objeto. Use uma conta com os escopos necessários.
A Tess age com as permissões da conta conectada. Ela não amplia acessos além do que essa conta já pode fazer.Conectores envolvem acesso a sistemas externos. Conecte apenas contas adequadas ao uso e revise as permissões com cuidado.