npm package: @mindz-solyd/n8n-nodes-mindz
Description: Interact with Mindz API to create enrols
Author: Mindz
Latest version: 0.2.1

# Nó Mindz para n8n



## Visão Geral

A **Mindz** é uma plataforma completa para quem deseja criar, vender e gerenciar infoprodutos. Ela transforma seu conhecimento em um negócio digital, oferecendo desde a hospedagem de conteúdo e processamento de pagamentos até ferramentas avançadas de marketing e análise de dados para escalar suas vendas.

A integração Mindz para n8n permite que você conecte sua área de membros a centenas de outros aplicativos, automatizando tarefas repetitivas e criando fluxos de trabalho inteligentes para gerenciar alunos, vendas e comunicação.



## Operações do Nó (Mindz Node)

O nó de ações da Mindz permite que você execute uma vasta gama de operações diretamente na sua plataforma. As operações são agrupadas por **recursos**.

Por exemplo, com o recurso **User**, você pode executar operações como:
* **Create**: Criar um novo usuário.
* **Get**: Obter os dados de um usuário específico.
* **Get All**: Listar todos os usuários.
* **Update**: Atualizar as informações de um usuário.
* **Delete**: Remover um usuário.
* **Change Password**: Alterar a senha de um usuário.

Outros recursos como **Course**, **Enrollment** e **Payment** seguem uma estrutura semelhante, cada um com suas operações específicas para interagir com a plataforma.



## Gatilhos de Eventos (MindzTrigger Node)

O nó de gatilho (trigger) permite que você inicie workflows no n8n com base em eventos que acontecem em tempo real na sua plataforma Mindz.

Por exemplo, você pode configurar um gatilho para ser disparado sempre que um pagamento for concluído (evento `paid` do recurso `Payment`). Isso permite que você execute ações imediatas, como conceder acesso a um curso, enviar uma notificação de confirmação para o cliente ou adicionar o contato a uma ferramenta de e-mail marketing.

### Exemplos de Gatilhos Comuns:
* **User** > **created**: Dispara quando um novo usuário se cadastra.
* **Enrollment** > **created**: Dispara quando um aluno se matricula em um curso.
* **Payment** > **paid**: Dispara quando um pagamento é confirmado.



## Instalação

Para usar o nó, primeiro instale-o em sua instância n8n.

### Instalação via UI do n8n

1.  No seu painel n8n, acesse **Settings > Community Nodes**.
2.  Clique em **Install**.
3.  Digite `@mindz-solyd/n8n-nodes-mindz` no campo "NPM package name".
4.  Confirme clicando em **Install**.

Após a instalação, você precisará recarregar a janela do n8n para que o novo nó apareça.



## Credenciais e Autenticação (Passo a Passo)

Para conectar sua conta Mindz ao n8n, siga este guia detalhado. O processo utiliza o padrão **OAuth2** para garantir uma conexão segura.

### Etapa 1: Iniciando a Configuração no n8n

Primeiro, adicione o nó da Mindz ao seu workflow para obter a URL de Redirecionamento, que é essencial para a conexão.

1.  **Adicione o Nó ao Workflow:** Crie um novo workflow (ou abra um existente), clique no `+` e adicione o nó da **"Mindz"**.
2.  **Crie a Credencial:** Abra as configurações do nó e, no campo "Credential", clique em **"- Create New -"**.
3.  **Copie a URL de Redirecionamento:** Uma janela para criar a nova credencial se abrirá. Localize e copie o campo **"OAuth Redirect URL"**.

Mantenha esta janela do n8n aberta, pois voltaremos a ela na última etapa.



### Etapa 2: Gerando as Chaves de Acesso na Mindz

Agora, com a URL em mãos, vamos acessar sua plataforma Mindz para ativar a integração e gerar as chaves de acesso.

1.  Acesse sua conta Mindz, navegue até **Configurações > Aplicativos** e localize a integração do **n8n**.
2.  Clique em **"Habilitar integrador"** ou **"Editar"** para configurar a conexão.
3.  **Cole a URL de Redirecionamento:** No campo apropriado (geralmente chamado "URLs de Redirecionamento"), cole a **"OAuth Redirect URL"** que você acabou de copiar do n8n.
4.  **Salve e Obtenha as Credenciais:** Clique em **"Salvar"**. Após salvar, a plataforma irá gerar e exibir as seguintes informações. Copie todas elas para usar no n8n:
    * `Client ID`
    * `Client Secret`
    * `Authorization URL` (URL de Autorização)
    * `Access Token URL` (URL de Token de Acesso)

> **Atenção:** Guarde o `Client Secret` em um local seguro, pois ele só será exibido uma vez.



### Etapa 3: Finalizando a Autenticação no n8n

Esta é a etapa final, onde inserimos as chaves da Mindz para autenticar a conexão.

1.  Volte para a janela de criação de credencial no n8n que você deixou aberta.
2.  Preencha os campos com as informações que você acabou de copiar da plataforma Mindz:
    * **Client ID:** Cole o `Client ID` gerado.
    * **Client Secret:** Cole o `Client Secret` gerado.
    * **Authorization URL:** Cole a URL de Autorização.
    * **Access Token URL:** Cole a URL de Token de Acesso.
3.  Com todos os campos preenchidos, clique no botão **"Sign in with Mindz"** (ou similar).
4.  Uma janela pop-up da Mindz se abrirá, solicitando sua permissão. Faça login se necessário e **autorize a conexão**.
5.  Após a autorização, a janela se fechará e a credencial estará salva e conectada com sucesso no n8n.

**Pronto!** Seu nó da Mindz está autenticado e pronto para ser usado nos seus fluxos de trabalho.