Conectores
LMS / Educação
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