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.
| Table of Contents | ||
|---|---|---|
|
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").
| Note |
|---|
Você só poderá ver esses dados uma vez, para poder salvar a cópia em um local seguro. |
Instalar o NicoApp:
Acesse a seção "NicoApps" no NicoChat.
Selecione e instale a versão mais recente disponível para Hotmart (ex.: 1.1, 1.2).
...
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:
| Code Block | ||
|---|---|---|
| ||
function formatarTelefone(telefone) {
let whatsapp = telefone.replace(/\D/g, '');
// Adicione aqui exceções de DDi que não devem receber o tratamento do Script
if (telefone.startsWith('+55') || telefone.startsWith('55') || (telefone.startsWith('+') && !telefone.startsWith('+55'))) {
return whatsapp;
}
const ddi = "+55";
let ddd;
if (whatsapp.length === 10 || whatsapp.length === 11) {
ddd = whatsapp.slice(0, 2);
whatsapp = whatsapp.slice(2);
if (parseInt(ddd, 10) <= 28) {
whatsapp = '9' + whatsapp.slice(-8);
} else {
whatsapp = whatsapp.slice(-8);
}
return ddi + ddd + whatsapp;
}
return whatsapp;
}
if (payload.data.subscriber) {
return {"email": payload.data.subscriber.email, "phone": "", "body": payload};
} else if (payload.data.buyer) {
const telefone = payload.data.buyer.checkout_phone || payload.data.buyer.phone;
return {"email": payload.data.buyer.email, "phone": formatarTelefone(telefone), "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
Ações Hotmart:
Crie subfluxos no NicoChat para gerenciar ações específicas no bloco de ações > integrações > Hotmart:
...
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!