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

2. Build do pacote:

npm run build

3. 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

2. Login no npm:

npm login

3. Publicar pacote:

npm publish

4. 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