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

Hotmart

2026-08-12

Introducción

Bienvenido a la guía de integración de NicoChat con el NicoApp de Hotmart. Esta documentación te ofrecerá un paso a paso detallado sobre cómo configurar y aprovechar las funcionalidades de NicoChat junto con Hotmart, una de las plataformas líderes en ventas de cursos en línea. La integración permite automatizar interacciones, procesar datos y gestionar comunicaciones de forma eficiente.

Tutorial en video

Si prefieres seguir el tutorial en video, míralo a continuación:

Miniapp Hotmart - NicoChat

YouTube

Instalación y configuración del NicoApp

Obtener credenciales en Hotmart:

En Hotmart, accede a "Herramientas" y luego a "Credenciales Hotmart".

Crea una nueva credencial API completando el formulario con “API Hotmart”, ingresa un nombre para la credencial y no selecciones “Sandbox”.

Copia el Client ID, el Client Secret y el token Basic (con solo un "Basic").

Atención

Solo podrás ver estos datos una vez, así que guarda una copia en un lugar seguro.

Instalar el NicoApp:

Configurar credenciales en NicoChat:

En NicoChat, pega las credenciales copiadas en los campos correspondientes y guarda.

Configuración de Webhooks

Crear Webhook en NicoChat:

En "Tools", accede a "Webhooks entrantes".

Crea un nuevo Webhook nombrándolo "Hotmart" y copia la URL proporcionada.

Haz clic en “Editar”, activa “Data Preprocessing” e inserta el código a continuación:

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