Hotmart

12 min

Objetivo

Integração com a API da Hotmart para consulta de produtos e participantes de vendas (clientes). Permite listar produtos do catálogo do creator, filtrar por status e formato, além de consultar informações detalhadas sobre compradores, afiliados e produtores envolvidos nas vendas.

Criando um fluxo

Acesse Fluxos na plataforma Fluid, clique em Criar Fluxo e selecione o conector Hotmart. Nomeie o fluxo e clique em Avançar.

Criando conexão

Para autenticar com a API da Hotmart, você precisará das credenciais obtidas no painel da Hotmart (Ferramentas > Credenciais Hotmart).

Campo	Obrigatório	Descrição
ID do Cliente	Sim	Client ID fornecido pela Hotmart nas credenciais da API.
Chave Secreta do Cliente	Sim	Client Secret fornecido pela Hotmart nas credenciais da API.
Token Basic	Sim	Token Basic fornecido pela Hotmart nas credenciais da API. Enviado no header Authorization para obter o access_token.

Como obter as credenciais:

Faça login na sua conta Hotmart.

No menu lateral, acesse Ferramentas > Mostrar todas.

Clique em Credenciais Hotmart.

Clique em Criar credencial, selecione API Hotmart e clique em Criar credencial.

Copie os valores de Client ID, Client Secret e Basic exibidos.

Configurando fluxo

Escolha um dos recursos disponíveis e selecione a operação desejada. Cada operação exige parâmetros específicos. Abaixo, listamos os recursos disponíveis.

Recursos e Operações

Recurso: Produto

Listar Produtos

Retorna informações dos produtos do creator, como identificador único, nome, status, data de criação, formato, indicação de assinatura e período de garantia.

Campo	Obrigatório	Tipo	Descrição
Número máximo de itens por página	Não	string	O número máximo de itens por página que podem ser retornados. O valor padrão é 50.
Token de paginação	Não	string	Cursor usado na paginação. Utilize o valor de next_page_token ou prev_page_token retornado na resposta anterior.
ID do Produto	Não	string	Identificador único (ID) do produto (número de 7 dígitos).
Status do Produto	Não	string	A situação do produto. Valores possíveis: DRAFT, ACTIVE, PAUSED, NOT_APPROVED, IN_REVIEW, DELETED, CHANGES_PENDING_ON_PRODUCT.
Formato do Produto	Não	string	O formato do produto criado. Valores possíveis: EBOOK, SOFTWARE, MOBILE_APPS, VIDEOS, AUDIOS, TEMPLATES, IMAGES, ONLINE_COURSE, SERIAL_CODES, ETICKET, ONLINE_SERVICE, ONLINE_EVENT, BUNDLE, COMMUNITY, AGENT.

Recurso: Clientes

Listar Participantes de Vendas

Exibe informações sobre os participantes das vendas. O participante pode ser o comprador, produtor, afiliado ou co-produtor que tenha participação na produção ou venda do produto. Retorna dados como nome, endereço, telefone, entre outros.

Importante: Você precisa adicionar na query os filtros transaction e transaction_status para retornar todos os status desejados. Caso esses filtros não sejam informados, serão retornados apenas os status APPROVED e COMPLETE.

Campo	Obrigatório	Tipo	Descrição
Número máximo de itens por página	Não	string	O número máximo de itens por página que podem ser retornados.
Token de paginação	Não	string	Cursor usado na paginação. Utilize o valor de next_page_token ou prev_page_token retornado na resposta anterior.
ID do Produto	Não	string	Identificador único (ID) do produto vendido (número de 7 dígitos).
Data Inicial	Não	string	Data inicial do período para o filtro. A data deve estar em milissegundos, a partir de 1970-01-01 00:00:00 UTC.
Data Final	Não	string	Data final do período para o filtro. A data deve estar em milissegundos, a partir de 1970-01-01 00:00:00 UTC.
E-mail do Comprador	Não	string	E-mail da pessoa compradora. Utilize para buscar compras de pessoas específicas.
Nome do Comprador	Não	string	Nome da pessoa compradora.
Origem da Venda (SRC)	Não	string	Código SRC utilizado no link da página de pagamento do produto para identificar a origem. Exemplo: pay.hotmart.com/B00000000T?src=nomedacampanha.
Código da Transação	Não	string	Código único de referência para uma transação. Exemplo: HP17715690036014.
Nome do Afiliado	Não	string	Nome da pessoa Afiliada responsável pela venda (quando a venda for realizada por um Afiliado do seu produto).
Tipo de Comissão	Não	string	Como o usuário da conta foi comissionado pela venda. Valores possíveis: PRODUCER, COPRODUCER, AFFILIATE.
Status da Transação	Não	string	Status de compra da transação. Valores possíveis: APPROVED, BLOCKED, CANCELLED, CHARGEBACK, COMPLETE, EXPIRED, NO_FUNDS, OVERDUE, PARTIALLY_REFUNDED, PRE_ORDER, PRINTED_BILLET, PROCESSING_TRANSACTION, PROTESTED, REFUNDED, STARTED, UNDER_ANALISYS, WAITING_PAYMENT.

Conclusão

O conector Hotmart na plataforma Fluid permite consultar produtos e participantes de vendas de forma automatizada. Utilize os filtros disponíveis para refinar as consultas conforme a necessidade do seu fluxo de integração.