Introdução

Bem-vindo ao guia de integração do NicoChat com o mini app da Hotmart. Esta documentação fornecerá um passo a passo detalhado sobre como configurar e aproveitar as funcionalidades do NicoChat em conjunto com a Hotmart, uma das plataformas líderes em vendas de cursos online. A integração permite automatizar interações, processar dados e gerenciar comunicações eficientemente.

Vídeo Tutorial

Caso prefira seguir o tutorial em vídeo assista abaixo:

Instalação e Configuração do NicoApp

Obter Credenciais na Hotmart:

Na Hotmart, vá em "Ferramentas" e depois em "Credenciais Hotmart".

Crie uma nova credencial API, preenchendo o formulário com “API Hotmart”, insira um nome da credencial e não selecione "Sandbox".

Copie o Client ID, Client Secret e o token Basic (com apenas um "Basic").

Instalar o NicoApp:

1. Acesse a seção "NicoApps" no NicoChat.

2. Selecione e instale a versão mais recente disponível para Hotmart (ex.: 1.1, 1.2).

3. Configurar Credenciais no NicoChat:

No NicoChat, cole as credenciais copiadas nos campos apropriados e salve.

Configuração de Web Hooks

Criar Web Hook no NicoChat:

Em "Tools" ou "Ferramentas", acesse "Webhooks de Entrada".

Crie um novo Webhook nomeando-o como "Hotmart" e copie o URL fornecido.

Clique em “Editar”, ative o “Pré-processamento de dados” e insira o código abaixo:

if (payload.data.subscriber) {
return {"email":payload.data.subscriber.email,"phone":"","body":payload};
} else if (payload.data.buyer) {
return {"email":payload.data.buyer.email,"phone":payload.data.buyer.checkout_phone,"body":payload};
} else if (payload.data.subscription.user) {
return {"email":payload.data.subscription.user.email,"phone":"","body":payload};
} else {
throw new Error('Email não encontrado no payload.');
}

Depois clique em “Pré-visualizar Payload” mapeie os campos de Email, Phone e Webhook Body conforme abaixo:

Phone: $.phone

Email: $email

webhook body: $.body
(caso n tenha pode criar uma variável do tipo JSON)
(Clique em adicionar)

Crie um subfluxo no NicoChat, insira um bloco de ação e selecione Integrações > Hotmart

Depois selecione “Webhook” e insira o JSON de “webhook body” criado anteriormente. Depois Salve.

Depois volte em Ferramentas > Webhooks de Entrada e selecione o fluxo criado:

Registrar Web Hook na Hotmart

Na Hotmart, acesse "Ferramentas" e "Webhook" .

Cadastre um novo Webhook, inserindo o URL copiado, selecione a versão 2.0.0 e selecione os eventos desejados

Testar a Configuração:

Envie um teste de configuração para garantir que tudo está funcionando corretamente.

Uso Prático e Automatização

1. Ações Hotmart:

Crie subfluxos no NicoChat para gerenciar ações específicas no bloco de ações > integrações > Hotmart:

2. Automatizações e Triggers:

Insira triggers de eventos da Hotmart:

Agradecemos por escolher o NicoChat para a integração com a Hotmart, e esperamos que este guia facilite a configuração e melhore a eficiência de suas operações. Até a próxima!