Página Inicial Ferramentas e integraçõesComo integro meus dados de vendas da Hotmart com o Google Sheets?

Busque pela sua dúvida na Central de Ajuda

Como integro meus dados de vendas da Hotmart com o Google Sheets?

Gerenciar os resultados de um negócio digital exige organização e acesso rápido às informações de vendas. Para facilitar essa gestão, a Hotmart permite uma integração direta com as planilhas do Google por meio de uma extensão. Ao centralizar seus dados de vendas e assinaturas em um único lugar, você ganha autonomia para construir dashboards personalizados, analisar o desempenho do seu produto e acompanhar a evolução do seu faturamento sem a necessidade de exportar relatórios manualmente todos os dias.

Neste artigo, você vai entender detalhadamente como funciona o complemento para o Google Sheets. Você aprenderá o passo a passo para realizar a instalação no seu painel do Google, como gerar as credenciais necessárias dentro da plataforma da Hotmart e como conectar ambas as ferramentas. 

 

O que é o Hotmart for Sheets e como ele funciona?

O Hotmart for Sheets é uma extensão desenvolvida para conectar a sua conta de Produtor diretamente ao Google Sheets. Essa ferramenta elimina o trabalho repetitivo de baixar arquivos CSV ou XLSX da plataforma para atualizar seus controles internos. Assim que a conexão é estabelecida, a extensão importa o histórico de transações diretamente para as linhas da planilha de sua escolha.

A integração funciona por meio de chaves de segurança geradas na sua conta de usuário. Essas chaves garantem que apenas a sua planilha tenha acesso autorizado para ler os dados de vendas da plataforma. 

É importante destacar que o complemento foi desenhado para consolidar dados estruturados de faturamento, status de transações e identificação básica de compradores, servindo como uma base de dados sólida para a sua gestão financeira.

 

Como realizo a instalação do complemento no Google Sheets?

O primeiro passo da configuração acontece diretamente dentro do ambiente do Google Sheets. A instalação é feita de forma nativa através da loja de soluções do Google Workspace.

  1. Acesse o seu Google Sheets e abra a planilha em branco na qual você deseja concentrar os dados do seu negócio.
  2. No menu superior da planilha, clique na opção Extensões (ou Complementos/Add-ons), e depois selecione Complementos > Instalar complementos.
  3. Na barra de pesquisa da janela do Google Workspace Marketplace que se abrirá, digite exatamente Hotmart for Sheets.
  4. Clique sobre o ícone do complemento oficial da Hotmart e, em seguida, selecione o botão Instalar.
  5. O Google solicitará permissões normais de acesso para que o complemento possa escrever dados na sua planilha. Clique em Continuar, selecione a sua conta Google correspondente e mude a autorização para Permitir.

Após a conclusão desse processo, uma mensagem confirmará que a instalação foi realizada com sucesso.

 

Como crio as credenciais de acesso na plataforma da Hotmart?

Com a extensão instalada no seu navegador, o próximo passo é coletar as credenciais na Hotmart para que a planilha saiba de qual conta ela deve buscar as informações.

  1. Acesse a sua conta na Hotmart pelo link https://app.hotmart.com 
  2. No menu lateral esquerdo da tela principal, clique na opção Ferramentas.
  3. Na lista de ferramentas disponíveis, localize e selecione a opção Credenciais Hotmart.
  4. Na aba superior, certifique-se de que está visualizando o ambiente correto e clique no botão + Criar Credencial.
  5. Atribua um nome claro para a sua credencial (por exemplo, "Planilha de Vendas Sheets") e clique em Confirmar.
  6. Na tela serão exibidos três códigos essenciais: o Client ID, o Client Secret e o Basic. Copie esses códigos e faça download das informações pois não será possível visualizá-las depois de concluir a criação.

 

Como finalizo a conexão entre a Hotmart e a minha planilha?

Agora que você tem o complemento instalado e as chaves de segurança geradas, basta realizar o vínculo final dentro do Google Sheets.

  1. Retorne à planilha em branco que você utilizou no início do processo.
  2. Clique novamente no menu superior em Extensões, localize a opção Hotmart for Sheets e clique no botão Open (Abrir).
  3. Uma barra lateral será aberta no canto direito da sua planilha contendo campos em branco específicos para autenticação.
  4. Preencha cuidadosamente os campos Client ID, Client Secret e Basic com os respectivos códigos que você gerou no painel da Hotmart no passo anterior. Certifique-se de não copiar espaços em branco antes ou depois das letras e números.
  5. Clique no botão Submit (Enviar).

O sistema validará as informações com os servidores da Hotmart. Estando tudo correto, a extensão exibirá uma mensagem de sucesso e liberará a tela de pesquisas para que você comece a importar os dados do seu produto.

 

Perguntas Frequentes:

A integração com o Google Sheets possui algum custo adicional?

Não. O uso do complemento oficial Hotmart for Sheets e a criação de credenciais de acesso dentro da plataforma são recursos totalmente gratuitos disponibilizados para todos os produtores da Hotmart.

Posso conectar mais de um produto ou mais de uma conta na mesma planilha?

A estrutura padrão da extensão realiza a autenticação por meio das credenciais do usuário. Isso significa que, ao inserir as chaves da sua conta, a planilha passará a ter acesso aos dados consolidados de vendas de todos os produtos vinculados àquele perfil de produtor. Se precisar separar os dados por produto, você poderá utilizar os filtros nativos de pesquisa dentro da própria barra lateral da extensão antes de realizar a importação para as células.

Qual é o prazo de atualização dos dados que são enviados para a planilha?

O banco de dados consultado pela extensão trabalha com uma rotina de sincronização programada. Embora a comunicação ocorra de forma automatizada, pode haver um intervalo natural de processamento entre a aprovação da venda no sistema de pagamentos e a exibição da nova linha na planilha do Google. 

Recomenda-se não forçar requisições sucessivas em curtos intervalos de tempo para evitar o bloqueio temporário das credenciais por excesso de acessos.

Por que algumas informações, como o telefone do comprador, não aparecem na planilha?

OÉ importante esclarecer que, por questões de conformidade de segurança e arquitetura padrão da extensão, o complemento Hotmart for Sheets não importa o número de telefone dos compradores

O escopo de dados dessa ferramenta é limitado às informações transacionais básicas, e-mail de identificação e dados de faturamento.

Se a coleta do número de telefone celular ou WhatsApp do comprador for indispensável para a estratégia do seu negócio (como para automações de recuperação de carrinho ou grupos de alunos), você pode configurar uma integração via Webhook ou utilizar as APIs (Hotmart Developers), garantindo previamente que a opção de preenchimento de telefone esteja marcada como "obrigatória" nas configurações de layout do seu Checkout.

O que devo fazer se a minha planilha parar de atualizar automaticamente?

Se o seu dashboard ou a sua lista de vendas parou de receber novos dados de forma automática, a causa mais provável é a expiração ou instabilidade no token de comunicação entre o Google e o Gateway da Hotmart. Para solucionar esse cenário, siga este procedimento de reconfiguração:

  1. Na planilha afetada, vá em Extensões > Hotmart for Sheets > Open.
  2. Se a barra lateral indicar que a conexão foi perdida ou apresentar alguma mensagem de erro, desconecte a conta atual.
  3. Acesse o painel da Hotmart, vá em Ferramentas > Credenciais Hotmart, exclua a credencial antiga e crie uma nova credencial do zero, gerando novos parâmetros de Client ID, Client Secret e Basic.

Insira os novos parâmetros gerados na barra lateral do Google Sheets e clique em Submit. Esse processo renovará as permissões de segurança e restabelecerá o fluxo de sincronização automática da extensão.

Precisa falar com a gente?

Se nossos artigos não te ajudaram, entre em contato e vamos responder assim que possível