Como configurar o HubSpot WhatsApp MCP com Claude ou ChatGPT (testado)

Seu pipeline vive na HubSpot. As conversas que o movem acontecem no WhatsApp — no celular de cada vendedor, em grupos de clientes, tarde da noite. A TimelinesAI já sincroniza esses chats com o contato e o negócio certos na HubSpot, então nada se perde quando um vendedor está de folga ou sai da empresa.

Este guia cobre o próximo passo: fazer perguntas que precisam das duas fontes ao mesmo tempo. Quais negócios ficaram em silêncio? O que o cliente realmente disse? Quem da equipe deve uma resposta? Com o conector oficial da HubSpot e o servidor MCP da TimelinesAI ativados no mesmo chat de IA, você pode perguntar exatamente isso, em linguagem natural, e receber uma única resposta.

Configuramos isso na nossa própria conta HubSpot e no nosso próprio workspace do WhatsApp antes de escrever uma palavra. Tudo abaixo é o que vimos, incluindo o que não funcionou de primeira.

Principais pontos

• O conector da HubSpot sabe quando você falou pela última vez com um cliente no WhatsApp. Ele não consegue ver o que foi dito. O servidor MCP da TimelinesAI lê a conversa.
• Ative os dois no mesmo chat — no Claude, ChatGPT ou outro assistente que aceite um servidor MCP remoto — e pergunte "quais negócios estão esperando a gente" em linguagem natural. A configuração leva cerca de 10 minutos, sem código.
• A HubSpot pode continuar somente leitura. Todas as perguntas deste guia funcionam com as permissões padrão.
• Combine os clientes pelo número de telefone, não pelo nome, e agrupe "quem está esperando" pelo responsável no WhatsApp, não pelo dono do negócio.
• Sem custo extra da TimelinesAI ou da HubSpot. O MCP do WhatsApp está incluído no seu plano da TimelinesAI, e os conectores da HubSpot estão disponíveis em todos os níveis. Você só precisa de um plano de IA pago.

O que significa "HubSpot WhatsApp MCP"

MCP (Model Context Protocol) é o padrão aberto que assistentes de IA usam para se conectar a outros aplicativos. Uma configuração de HubSpot WhatsApp MCP significa que seu assistente de IA — Claude, ChatGPT ou outro — está conectado a dois servidores MCP ao mesmo tempo:

• O conector oficial da HubSpot — a conexão da própria HubSpot com seu CRM, disponível para Claude, ChatGPT, Microsoft 365 Copilot e Gemini.
• O servidor MCP de WhatsApp da TimelinesAI — a conexão com as conversas de WhatsApp da sua equipe, em todos os números.

Você não escreve código nem roda nenhum servidor. Você adiciona dois conectores ao seu assistente, e ele decide qual consultar em cada parte da sua pergunta.

Isso não substitui a sincronização. A TimelinesAI continua copiando cada conversa para a HubSpot como faz hoje. O MCP é a forma de fazer perguntas que envolvem os dois.

Quais assistentes de IA funcionam

Você precisa de um assistente que consiga manter as duas conexões ao mesmo tempo. A HubSpot oferece uma conexão oficial para quatro assistentes. A TimelinesAI se conecta a qualquer assistente que aceite um servidor MCP remoto.

Fizemos todos os testes deste guia com o Claude. O conector da HubSpot para o ChatGPT funciona no mesmo modelo de permissões — um superadministrador o aprova e escolhe o que ele pode acessar — então a configuração, os prompts e as armadilhas valem também para ele.

O que cada conector consegue e não consegue fazer

Em uma frase: o conector da HubSpot sabe quando você falou pela última vez com um cliente. A TimelinesAI sabe o que foi dito. Você precisa dos dois para responder "quem está esperando a gente".

O conector da HubSpot, em detalhes

A HubSpot lista tudo o que o conector pode ter permissão para fazer na tela que você vê ao conectá-lo.

• Por padrão: ler contatos, empresas, negócios e tickets.
• Com permissões de leitura opcionais: notas, ligações, reuniões, tarefas, e-mails individuais, conversas da caixa de entrada, usuários e equipes, leads, listas, orçamentos, faturas e mais.
• Com permissões de escrita opcionais: criar e atualizar contatos, empresas, negócios, tickets, notas, tarefas e mais. O acesso de escrita precisa ser liberado por um superadministrador da HubSpot.
• Não disponível em nenhum nível de permissão: enviar uma mensagem em qualquer canal, responder ou atribuir uma conversa da caixa de entrada, e o tipo de registro que a HubSpot usa para mensagens de WhatsApp registradas.

O servidor MCP da TimelinesAI, em detalhes

34 ferramentas, cobrindo números do app WhatsApp Business e números da API do WhatsApp Business em toda a sua equipe:

• Buscar e ler: buscar chats por telefone, nome, etiqueta, membro da equipe ou status de leitura; ler o histórico completo, incluindo chats em grupo; ver se a janela de 24 horas de um chat da API ainda está aberta.
• Organizar: atribuir ou remover um membro da equipe, adicionar ou remover etiquetas, fechar ou reabrir um chat.
• Agir (configure para pedir aprovação antes): enviar uma mensagem, responder a uma mensagem específica, reagir, enviar um modelo aprovado, iniciar um novo chat via API.
• Workspace: listar seus números, sua equipe e seu uso.

Como os dois funcionam juntos

Pegue a pergunta "quais dos meus negócios ficaram em silêncio, e por quê". Seu assistente responde em quatro passos:

1. Você pergunta em linguagem natural, em um chat normal.
2. A HubSpot encontra os negócios sem atividade recente, seus contatos e números de telefone.
3. A TimelinesAI encontra o chat de cada cliente pelo número de telefone e lê as últimas mensagens.
4. Seu assistente combina as duas fontes em uma única resposta: quem está esperando, desde quando e sobre o quê.

Se você então pedir uma resposta, o assistente a redige, você aprova, e a TimelinesAI a envia pelo número da sua equipe. A mensagem cai na sua caixa de entrada compartilhada e no registro da HubSpot, como qualquer outra mensagem de WhatsApp.

Quatro formas de conectar HubSpot, WhatsApp e IA

Se você está escolhendo uma configuração, é assim que as opções se diferenciam.

Se sua equipe já usa o WhatsApp pelo canal de caixa de entrada próprio da HubSpot, o conector da HubSpot consegue ler essas conversas — mas ainda não consegue responder. Se você está em qualquer outro plano da HubSpot, usa números do app WhatsApp Business, ou quer que seu assistente aja sobre uma conversa, você precisa de um conector de WhatsApp adicional.

Antes de começar

• Um assistente de IA que aceite os dois conectores: Claude em um plano pago (Pro, Max, Team ou Enterprise), ou ChatGPT em Plus, Pro, Business, Enterprise ou Education.
• HubSpot em qualquer nível, incluindo Free e Starter, e uma conta de usuário da HubSpot.
• TimelinesAI com a integração com a HubSpot ativada, e os números da sua equipe conectados. O MCP do WhatsApp está incluído no seu plano. É novo nisso? Comece pela sincronização do WhatsApp com a HubSpot.
• Permissão para conectar aplicativos na HubSpot. Usuários com acesso ao App Marketplace podem conectar direto; os demais precisam que um superadministrador aprove o conector antes.
• Um plano de IA compatível com o seu volume. Perguntas ocasionais funcionam bem nos planos pagos padrão. Uma equipe que faz isso toda manhã em uma caixa de entrada grande consome bem mais — nosso guia de configuração do WhatsApp MCP tem números medidos.

Configure no Claude (cerca de 10 minutos)

Passo 1: Conecte a HubSpot

No Claude, vá em Personalizar → Conectores, procure HubSpot e clique em Conectar. Faça login na HubSpot e escolha sua conta.

A HubSpot então mostra o que o Claude pode acessar. Os padrões — ler contatos, empresas, negócios e tickets — são suficientes para todas as perguntas deste guia. Se quiser mais, marque só as permissões de Visualizar:

• Notas, ligações, reuniões e tarefas — para "o que aconteceu nesse negócio"
• Usuários e equipes — para que "meus negócios" funcione sem digitar seu nome
• Executar consultas — para totais e recortes de todo o pipeline

Você não precisa de nada que diga criar, alterar ou publicar. Se essas opções estiverem em cinza, um superadministrador da HubSpot precisa liberá-las.

Passo 2: Conecte a TimelinesAI

Ainda em Personalizar → Conectores, clique em + e depois em Adicionar conector personalizado. Dê o nome TimelinesAI e cole a URL do servidor: https://mcp.services.timelines.ai/mcp. Clique em Adicionar e depois em Conectar, faça login na TimelinesAI e aprove. Não há nenhuma chave de API para copiar.

Em um plano Team ou Enterprise, um Owner adiciona o conector uma vez em Configurações da organização → Conectores; depois cada pessoa conecta sua própria conta (guia do Claude).

Por fim, abra as configurações de ferramentas de cada conector e coloque tudo que envia, atualiza ou atribui para pedir aprovação. A HubSpot recomenda o mesmo para o conector dela.

Passo 3: Ative os dois no mesmo chat

Em um chat novo, clique em + no canto inferior esquerdo, abra Conectores e confira se HubSpot e TimelinesAI estão os dois ativados. Os conectores são ativados por conversa.

Passo 4: Confira se está funcionando

Faça duas perguntas rápidas. Se as duas responderem, está tudo pronto:

Quantos negócios em aberto temos na HubSpot, por etapa?

Liste nossos números de WhatsApp na TimelinesAI e diga se cada um está conectado.

A primeira pergunta é da HubSpot; a segunda, da TimelinesAI.

Configure no ChatGPT

1. Conecte a HubSpot. Adicione o conector da HubSpot para o ChatGPT e faça login. Valem a mesma aprovação de superadministrador e as mesmas permissões de dados do Claude.
2. Ative o modo desenvolvedor. No ChatGPT pela web, abra Configurações → Segurança e login e ative o Modo desenvolvedor. Está disponível nos planos Plus, Pro, Business, Enterprise e Education; em uma conta empresarial, seu administrador pode precisar liberá-lo (guia da OpenAI).
3. Adicione a TimelinesAI. Crie um app em modo desenvolvedor com a URL do servidor https://mcp.services.timelines.ai/mcp e depois faça login na TimelinesAI.
4. Pergunte com os dois ativados. Ative a TimelinesAI para o chat e inclua a palavra "HubSpot" na sua pergunta — é a própria dica da HubSpot para trazer o conector dela para a conversa.
5. Mantenha as ações sob aprovação. Configure o conector da HubSpot para pedir aprovação antes de atualizações, como a HubSpot recomenda, e revise cada envio proposto antes de confirmar.

Configure no Claude Code, Cursor ou Codex

Para analistas e equipes técnicas. A TimelinesAI é configurada com uma única linha em cada ferramenta — os trechos de código estão no nosso guia de configuração do WhatsApp MCP. Do lado da HubSpot, os desenvolvedores se conectam ao servidor MCP remoto da HubSpot, que exige um app de autenticação MCP da HubSpot. Rodamos os testes deste guia a partir do Claude Code com os dois conectores conectados.

Uma revisão de pipeline de segunda-feira, do início ao fim

Esta é a pergunta que justifica toda a configuração. Pergunte:

Mostre meus negócios em aberto sem atividade nos últimos 7 dias. Para cada um, encontre a conversa de WhatsApp do cliente na TimelinesAI e me diga o que ele disse por último e se respondemos.

Nos bastidores, a HubSpot encontra os negócios silenciosos e o número de telefone de cada contato; a TimelinesAI encontra o chat de cada um por esse número e lê as últimas mensagens. A resposta volta em uma única tabela: quais negócios estão esperando você, desde quando e sobre o quê.

Depois, peça os follow-ups, sem enviar nada ainda:

Redija um follow-up curto para os três que estão esperando a gente, no idioma em que escreveram. Não envie nada.

Seu assistente redige cada resposta no idioma do cliente. Quando você diz "envie a primeira", ele pede aprovação antes de a TimelinesAI enviar qualquer coisa. Nada chega ao cliente até você autorizar.

Biblioteca de prompts

Copie estes exatamente, ou troque por suas próprias etapas, nomes e intervalos de tempo. Mais ideias em casos de uso do WhatsApp MCP.

Pipeline

• "Quais negócios na etapa Contrato enviado fecham este mês e estão sem atividade há 7 dias? Para cada um, o que o cliente disse por último no WhatsApp?"
• "Antes da minha ligação com [empresa]: resuma o negócio na HubSpot e nossas últimas 30 mensagens de WhatsApp com eles."
• "Quais negócios avançaram esta semana no WhatsApp mas continuam na mesma etapa da HubSpot?"

Equipe

• "Quais clientes nos escreveram por último e ainda não tiveram resposta? Do mais antigo ao mais recente, com o responsável na equipe."
• "Quantos clientes cada pessoa da equipe está devendo resposta agora?"
• "Quais chats de WhatsApp desta semana não estão atribuídos a ninguém?"

Cliente

• "O que prometemos para [empresa] no WhatsApp este mês, e entregamos?"
• "No grupo de WhatsApp com [cliente], quem pediu o quê, e o que ainda está em aberto?"
• "Traduza as últimas 10 mensagens de [cliente] para o português e me diga o que ele precisa."

Ação (pedir aprovação antes)

• "Redija respostas para todos que estão esperando há mais de 24 horas, no idioma deles. Não envie nada."
• "Atribua os chats sem responsável desta semana para [colega]."
• "Quais dos nossos chats da API do WhatsApp Business ainda têm a janela de 24 horas aberta?"

Prefere o terminal? Os mesmos dados de WhatsApp funcionam no Claude Code — veja análise de WhatsApp com o Claude Code.

O que aprendemos ao configurar

1. A conexão padrão da HubSpot é mais limitada do que parece. Ela cobre quatro tipos de registro: contatos, empresas, negócios e tickets. Peça notas, ligações, seu próprio usuário ou uma contagem do pipeline, e o Claude responde: "Este conector requer permissões adicionais". Reconectar sozinho não resolveu no nosso caso: um superadministrador precisa liberar as permissões extras primeiro, e depois cada usuário reconecta.
2. Combine por número de telefone, não por nome. Um contato da HubSpot no nosso teste tinha quatro chats de WhatsApp — um para cada colega que tinha falado com ele — e nenhum tinha o mesmo nome do contato na HubSpot. Negócios criados a partir do WhatsApp também mantêm o nome do chat do dia em que foram criados. Peça para o assistente combinar por telefone e usar o chat com a mensagem mais recente.
3. O dono do negócio nem sempre é quem responde no WhatsApp. Na nossa conta, todo negócio criado a partir do WhatsApp pertencia a um único dono na HubSpot, enquanto os chats estavam atribuídos a colegas diferentes. Para saber "quem deve resposta a quem", use o responsável no WhatsApp.
4. A sincronização é muito precisa. O horário de "último contato" da HubSpot e a última mensagem da TimelinesAI ficaram com 14 segundos de diferença. Confie nas datas da HubSpot para "quem ficou em silêncio" e na TimelinesAI para "o que foi dito".
5. Números desconectados ainda contam. Seu assistente consegue ler o histórico de um número que foi desconectado, mas não consegue enviar por ele — útil quando um vendedor sai da empresa.

Solução de problemas

• "Este conector requer permissões adicionais." A conexão padrão da HubSpot cobre quatro tipos de registro. Peça a um superadministrador que libere as permissões de Visualizar que você precisa, e depois reconecte a HubSpot.
• As opções de permissão aparecem em cinza. Sua conta restringe o que o conector pode acessar. Um superadministrador aprova o conector e suas permissões de dados.
• O assistente responde usando apenas um dos aplicativos. O outro conector não está ativado para este chat. No Claude: + → Conectores, ative os dois. No ChatGPT: ative o app da TimelinesAI e inclua "HubSpot" na sua pergunta. Nomear o app ("na TimelinesAI") ajuda em qualquer caso.
• Não encontra o chat de um cliente. Os nomes dos chats não batem com os nomes na HubSpot, ou o formato do telefone é diferente. Peça para combinar por telefone em formato internacional (+código do país), e confira o campo de telefone do contato na HubSpot.
• Escolheu uma conversa antiga. Um cliente pode ter vários chats, um por número de cada colega. Peça o chat com a mensagem mais recente.
• As contagens de "esperando" por vendedor parecem erradas. O dono do negócio na HubSpot não é o responsável no WhatsApp. Agrupe pelo responsável no WhatsApp.
• A resposta trava ou fica lenta em perguntas grandes. Ler meses de histórico esbarra em limites de uso. Reduza para um intervalo de datas, um número ou uma etiqueta por vez.
• A TimelinesAI pede para você fazer login de novo. A sessão expirou. Reconecte a TimelinesAI nas configurações de conectores do seu assistente.
• Uma mensagem não envia. O número está desconectado, ou a janela de 24 horas de um chat da API já fechou. Reconecte o número, ou envie um modelo aprovado.
• Nenhum dado de atividade ou de conversa vindo da HubSpot. A opção Dados Sensíveis está ativada na sua conta HubSpot, e a HubSpot bloqueia isso por padrão de design — veja as configurações de Dados Sensíveis da HubSpot.

Permissões e segurança

• A HubSpot continua somente leitura a não ser que um superadministrador libere permissões de escrita. Nada neste guia precisa delas.
• Nada chega a um cliente sem sua aprovação quando as ferramentas de envio da TimelinesAI estão configuradas para pedir aprovação. O assistente redige; você decide.
• No Claude, cuidado com o modo Research. O Claude pode chamar as ferramentas dos conectores automaticamente durante o Research, sem pedir aprovação a cada vez. Desative a TimelinesAI, ou mantenha suas ferramentas de envio bloqueadas, antes de rodar o Research.
• No ChatGPT, o modo desenvolvedor é para servidores em que você confia. A recomendação da OpenAI é conectar só servidores MCP confiáveis, e a da HubSpot é revisar cada mudança que o ChatGPT propuser antes de confirmar.
• Só respostas e follow-ups, nunca envio em massa. O WhatsApp restringe números que enviam mensagens não solicitadas em volume. Use isso com pessoas que já estão conversando com você — veja nosso guia de boas práticas de WhatsApp para equipes da HubSpot.
• Tudo fica registrado. Mudanças feitas pelo conector da HubSpot ficam registradas tanto em nome do usuário quanto do conector.
• Dados Sensíveis da HubSpot: se estiver ativado, a HubSpot bloqueia dados de atividade e de conversa do conector dela.

Perguntas frequentes

O que é HubSpot WhatsApp MCP?

É uma configuração em que um assistente de IA como Claude ou ChatGPT se conecta à HubSpot pelo conector oficial da HubSpot e ao WhatsApp da sua equipe pelo servidor MCP da TimelinesAI, ao mesmo tempo. Assim você pode fazer uma única pergunta que precise das duas fontes — por exemplo, quais negócios estão esperando uma resposta no WhatsApp — sem código.

Com quais assistentes de IA funciona?

Claude e ChatGPT para a rotina completa, além de Claude Code, Cursor e Codex para equipes técnicas. As conexões da HubSpot com Copilot e Gemini cobrem só perguntas de CRM.

A IA da própria HubSpot consegue ler nossas mensagens de WhatsApp?

Não as que a TimelinesAI sincroniza. No nosso teste, o conector da HubSpot mostrava quando um cliente foi contatado pela última vez e quantas vezes, mas não as mensagens. Se você usa o canal de caixa de entrada de WhatsApp próprio da HubSpot, o conector consegue ler essas conversas da caixa de entrada — mas não consegue respondê-las.

Preciso da integração de WhatsApp própria da HubSpot?

Não. O canal de WhatsApp da HubSpot exige Marketing Hub ou Service Hub Professional ou Enterprise, e não aceita contas pessoais. A TimelinesAI funciona em todos os planos da HubSpot, com números do app e da API do WhatsApp Business.

É a mesma coisa que os resumos de IA dentro da HubSpot?

Não. Os resumos no registro são a IA da própria HubSpot. Isso é para equipes que já trabalham no Claude ou ChatGPT e querem fazer uma única pergunta que abranja a HubSpot e o WhatsApp de cada vendedor.

Preciso dar à IA acesso de escrita à HubSpot?

Não. Todas as perguntas deste guia funcionam com a conexão padrão somente leitura da HubSpot.

O assistente consegue atualizar negócios, notas e tarefas na HubSpot?

Sim, no Claude e no ChatGPT, se um superadministrador liberar permissões de escrita. O conector do ChatGPT atualiza até 10 registros por vez. A HubSpot recomenda configurar o conector para pedir aprovação antes de cada atualização.

Qual a diferença entre o servidor MCP da HubSpot e o conector da HubSpot para o Claude?

O conector é o app pronto que você adiciona dentro do Claude ou ChatGPT — é o que se usa neste guia. O servidor MCP remoto da HubSpot é a que desenvolvedores conectam suas próprias ferramentas de IA.

Funciona com números do app WhatsApp Business, ou só com a API?

Os dois, em toda a sua equipe.

Funciona no plano HubSpot Free ou Starter?

Sim. Tanto o conector da HubSpot quanto a TimelinesAI funcionam em todos os planos da HubSpot.

Consegue ler chats em grupo?

Sim, incluindo quem enviou cada mensagem.

Tem custo extra?

Não por parte da TimelinesAI: o MCP do WhatsApp está incluído no seu plano da TimelinesAI. A HubSpot também não cobra separadamente pelos conectores dela — eles estão disponíveis em todos os planos da HubSpot, incluindo o Free. O que você precisa é de um plano de IA pago, e uma equipe que faz isso toda manhã em uma caixa grande deve considerar um plano superior.

Posso usar o ChatGPT em vez do Claude?

Sim. O conector oficial da HubSpot para o ChatGPT lê seu CRM e, se permitido, o atualiza. A TimelinesAI se conecta pelo modo desenvolvedor do ChatGPT nos planos Plus, Pro, Business, Enterprise e Education.

Funciona com o Microsoft Copilot ou o Gemini?

Para perguntas de CRM, sim: a HubSpot tem um agente para o Microsoft 365 Copilot e um conector somente leitura para o Gemini. Não verificamos uma forma de adicionar a TimelinesAI a nenhum dos dois, então para perguntas que precisam de WhatsApp, use Claude ou ChatGPT.

Guias relacionados

• Como funciona a sincronização de WhatsApp com a HubSpot
• Guia de configuração do WhatsApp MCP
• Caixa de entrada compartilhada de WhatsApp para equipes HubSpot
• Boas práticas de WhatsApp e HubSpot
• Casos de uso do WhatsApp MCP
• Análise de WhatsApp com o Claude Code

Pronto para testar no seu próprio pipeline? Comece grátis com a TimelinesAI, conecte o WhatsApp da sua equipe à HubSpot e faça sua primeira pergunta.