aivo

Community nodes do n8n para a suite Aivo

Package Information

Downloads: 45 weekly / 403 monthly
Latest Version: 0.1.2
Author: Aivo

Available Nodes

Aivo Accounts
Operacoes do modulo Aivo Accounts
Aivo Pagamentos
Operacoes de cobranca da suite Aivo
Aivo Vendas icon
Aivo Vendas
Operacoes de vendas e CRM da Aivo
Aivo Comunicacao icon
Aivo Comunicacao
Operacoes do modulo Aivo Comunicacao

Documentation

Aivo n8n

Pacote de Community Nodes do n8n para integrar os produtos da suite Aivo.

Visao geral

Este projeto centraliza a automacao entre o n8n e os produtos Aivo. A estrategia inicial e core-first, com foco nos modulos:

  • Aivo Accounts (login unificado, modulos, convites, creditos)
  • Aivo Pagamentos (API de cobranca da suite)
  • Aivo Vendas (leads, CRM, SDR)
  • Aivo Comunicacao (canais como WhatsApp e evolucao omnichannel)

Estrutura do projeto

Aivo n8n/
|- nodes/
|  |- Accounts/
|  |  |- Accounts.node.ts
|  |- Pagamentos/
|  |  |- Pagamentos.node.ts
|  |- Vendas/
|  |  |- Vendas.node.ts
|  |- Comunicacao/
|  |  |- Comunicacao.node.ts
|- docs/
|  |- CONVENTIONS.md
|- index.ts
|- package.json
|- tsconfig.json

Requisitos

  • Node.js >= 20.15
  • npm >= 10

Setup local

  1. Instalar dependencias:
npm install
  1. Build do pacote:
npm run build
  1. Desenvolvimento com watch:
npm run dev

Publicacao e instalacao no n8n Community Nodes

Nome do pacote publicado no npm:

  • n8n-nodes-aivo

Passo a passo:

  1. Gerar build:
npm run build
  1. Login no npm:
npm login
  1. Publicar pacote:
npm publish
  1. Instalar no n8n:
  • Abrir Settings -> Community Nodes
  • Clicar em Install
  • Informar n8n-nodes-aivo
  • Reiniciar o n8n se solicitado

Como os modulos estao hoje

  • Aivo Vendas ja esta com estrutura de Resource + Action e catalogo de endpoints do SDR.
  • Aivo Vendas usa credencial dedicada Aivo Vendas API (base URL + token).
  • Aivo Comunicacao ja esta com estrutura de Resource + Action e catalogo de endpoints do Aivo Com.
  • Aivo Comunicacao usa credencial dedicada Aivo Comunicacao API (base URL + token).
  • Aivo Accounts e Aivo Pagamentos permanecem como stubs iniciais.

Documentacao de endpoints mapeados de Vendas:

  • nodes/Vendas/ENDPOINTS.md

Documentacao de endpoints mapeados de Comunicacao:

  • nodes/Comunicacao/ENDPOINTS.md

Credencial do Aivo Vendas

Ao usar o node Aivo Vendas, crie uma credencial Aivo Vendas API com:

  • Base URL: https://vendas.aivosuite.com
  • API Token: token Bearer da API

Credencial do Aivo Comunicacao

Ao usar o node Aivo Comunicacao, crie uma credencial Aivo Comunicacao API com:

  • Base URL: https://com.aivosuite.com
  • API Token: token Bearer da API

Roadmap sugerido (proximos passos)

  1. Criar credenciais compartilhadas (AivoApi) para autenticar nos servicos.
  2. Implementar operacoes reais por modulo core.
  3. Adicionar tratamento padrao de erros e paginação.
  4. Expandir para os demais produtos: Forms, Calendar, Indica, Social, Governanca, Financas, Pages, Cursos e Empresarial.

Convencoes

As convencoes de nomenclatura, versao e organizacao dos modulos estao em:

  • docs/CONVENTIONS.md

Discussion