Como integrar uma plataforma externa ao Hotmart Send via Webhook?

O Hotmart Send permite centralizar a gestão dos seus leads e campanhas de e-mail marketing em um só lugar. Além disso, é possível integrar o Send a outras plataformas externas, automatizando o envio e o recebimento de dados entre sistemas.

Neste artigo, você vai entender o que é uma integração via Webhook, quando ela faz sentido no Hotmart Send e como configurar essa integração passo a passo, tanto para enviar dados do Send para outras plataformas quanto para receber dados externos dentro do Hotmart Send.

O que é Webhook e como ele funciona?

Webhook é um recurso que permite a troca automática de informações entre plataformas, em tempo real. Em vez de realizar integrações manuais, um sistema envia dados para outro sempre que um evento específico acontece.

No contexto do Hotmart Send, isso significa que você pode, por exemplo:

• Enviar automaticamente os leads capturados no Send para outra ferramenta.
• Receber leads gerados em uma plataforma externa e gerenciá-los dentro do Hotmart Send.

Para que a integração funcione, a plataforma externa precisa oferecer suporte a Webhook. Caso isso não seja possível, você pode utilizar uma ferramenta intermediária, como Zapier, Make ou Pluga, que atuam como uma ponte entre os sistemas.

Quais tipos de integração posso fazer no Hotmart Send?

No Hotmart Send, a integração via Webhook pode ser feita de duas formas:

• Enviar dados: os leads coletados no Hotmart Send são enviados para outra plataforma a partir de eventos específicos.
• Receber dados: leads gerados em plataformas externas são enviados para o Hotmart Send e passam a fazer parte da sua base de contatos.

Independentemente do tipo escolhido, é necessário configurar a integração no Hotmart Send e ajustar as definições na plataforma conectada.

Importante: os nomes dos campos, formatos e requisitos podem variar de acordo com a ferramenta externa. Sempre consulte a documentação da plataforma que será integrada.

Como enviar dados do Hotmart Send para outra plataforma?

Esse tipo de integração é indicado quando você deseja que os leads capturados no Send sejam enviados automaticamente para outra ferramenta.

Para configurar, siga o passo a passo abaixo:

1. Acesse sua conta Hotmart pelo link https://app.hotmart.com/.
2. No menu lateral, clique em Marketing e depois em E-mail marketing.
3. Dentro do Hotmart Send, clique em Configurações no menu lateral esquerdo e selecione a opção Integrações via webhook.
4. Na tela seguinte, clique em Nova integração e escolha a opção Para enviar dados.
5. Dê um nome à integração (recomendamos incluir o nome da plataforma para facilitar a organização).
6. Em Provedor, escolha:
   • ActiveCampaign, se essa for a plataforma integrada (integração direta).
   • Webhook, para outras ferramentas. Caso a plataforma não aceite Webhook diretamente, utilize uma ferramenta intermediária.
7. Cole a URL de integração fornecida pela plataforma externa ou pela ferramenta intermediária.
8. Defina o evento que irá disparar o envio dos dados, como Captura de lead ou Marcação em tag.
9. Leia o aviso sobre tratamento de dados, marque a caixa de confirmação e clique em Salvar.

Como receber dados de outras plataformas no Hotmart Send?

Essa opção é indicada quando você deseja trazer para o Hotmart Send os leads gerados fora da plataforma.

Para configurar, siga o passo a passo abaixo:

1. Acesse sua conta Hotmart pelo link https://app.hotmart.com/.
2. No menu lateral, clique em Marketing e depois em E-mail marketing.
3. Dentro do Hotmart Send, clique em Configurações no menu lateral esquerdo e selecione a opção Integrações via webhook.
4. Na tela seguinte, clique em Nova integração e escolha a opção Para receber dados.
5. Dê um nome à integração (recomendamos incluir o nome da plataforma para facilitar a organização).
6. No campo Associar à tag(s), escolha quais tags os leads recebidos devem receber no Send.
   • Também é possível definir a remoção de tags, se necessário.
7. Copie o link e o token gerados pelo Hotmart Send e finalize a configuração colando na plataforma externa que enviará os dados.
8. Confirme a configuração clicando em Salvar filtros.

Importante: o token deve ser incluído no corpo da requisição (body) com o nome hottok, exatamente como gerado pelo Hotmart Send. Esse campo identifica e autoriza o envio das informações. 

Se a plataforma externa não permitir definir o nome do campo ou exigir outro formato, será necessário utilizar uma ferramenta intermediária para ajustar esse envio.

Como testar se a integração está funcionando?

Após concluir a configuração, é importante realizar um teste. Para isso, adicione um lead na plataforma de origem (Hotmart Send ou ferramenta externa, dependendo do tipo de integração) e verifique se ele foi recebido corretamente na plataforma de destino.

Esse teste ajuda a confirmar se os eventos, links e tokens foram configurados corretamente.

Perguntas frequentes

❯ Posso integrar o Hotmart Send com qualquer plataforma externa?

Sim, desde que a plataforma permita integração via Webhook ou possa ser conectada por meio de ferramentas intermediárias.

❯ O que é uma ferramenta intermediária e por que preciso dela?

Ferramentas intermediárias, como Zapier, Make ou Pluga, facilitam a comunicação entre o Hotmart Send e outras plataformas quando não há integração direta disponível. Elas funcionam como uma ponte, recebendo os dados de um sistema e enviando para outro.

❯ Posso enviar e receber dados usando a mesma integração?

Não. É necessário criar integrações separadas: uma para enviar dados e outra para receber dados.

❯ Existe um formato específico para enviar dados ao Hotmart Send?

Sim. Os dados devem ser enviados em formato JSON e o corpo da requisição precisa conter, obrigatoriamente, os campos email e hottok. Outros dados podem ser incluídos, desde que sigam o padrão utilizado pelo Hotmart Send.

❯ Fiz a integração, mas os dados não estão sendo enviados ou recebidos. O que posso verificar?

Se os dados não estiverem sendo transmitidos corretamente entre as plataformas, revise os pontos abaixo:

• Confirme se o link de integração e, no caso de recebimento de dados, o campo hottok foram preenchidos corretamente na plataforma de origem.
• Realize um teste da integração, adicionando um lead na ferramenta de origem (Hotmart Send ou plataforma externa, conforme o tipo de integração) e verificando se ele chega ao destino.
• Verifique se o evento configurado realmente ocorreu, como a captura de lead ou a marcação de uma tag.
• Consulte a documentação da plataforma externa, pois nomes de campos, formatos dos dados e outros requisitos podem interferir na comunicação entre os sistemas.
• Avalie a necessidade de usar uma ferramenta intermediária, como Zapier, Pluga ou Make, caso a plataforma externa não aceite o formato exigido.

Se, após essas verificações, a integração ainda não funcionar, entre em contato com nosso suporte. Envie os detalhes da configuração realizada, incluindo os passos seguidos, os dados utilizados e capturas de tela das telas envolvidas. Essas informações ajudam a equipe a entender o cenário e oferecer uma orientação mais precisa.