Integrations/NicoApps (MiniApps) Nativos/Plataformas de Cursos e Área de Membros/Hotmart

Hotmart

Welcome to the NicoChat integration guide for the Hotmart NicoApp. This documentation provides a detailed step-by-step on how to set up and take advantage of NicoChat features together with Hotmart.

2026-08-12

Introduction

Welcome to the NicoChat integration guide for the Hotmart NicoApp. This documentation provides a detailed step-by-step on how to set up and take advantage of NicoChat features together with Hotmart, one of the leading platforms for online course sales. The integration lets you automate interactions, process data and manage communications efficiently.

Video Tutorial

If you prefer to follow the video tutorial, watch it below:

Miniapp Hotmart - NicoChat

YouTube

Installing and Configuring the NicoApp

Get Credentials on Hotmart:

On Hotmart, go to "Tools" and then "Hotmart Credentials".

Create a new API credential by filling out the form with “API Hotmart”, enter a name for the credential and do not select “Sandbox”.

Copy the Client ID, Client Secret and the Basic token (with only one "Basic").

Attention

You will only be able to see this data once, so save a copy in a safe place.

Install the NicoApp:

Configure Credentials in NicoChat:

In NicoChat, paste the copied credentials into the appropriate fields and save.

Webhook Configuration

Create a Webhook in NicoChat:

In "Tools", go to "Webhooks".

Create a new Webhook, name it "Hotmart" and copy the URL provided.

Click “Edit”, enable “Data Preprocessing” and insert the code below:

javascript

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.');
}