n8n-nodes-guru-api

n8n Community Nodes - Guru Digital Manager

Este pacote contém nodes do n8n para integração com a API do Guru Digital Manager, permitindo automações completas de gestão de contatos, transações e assinaturas.

🚀 Características

• ✅ Gestão Completa de Contatos: Criar, ler, atualizar e excluir contatos
• ✅ Controle de Transações: Gerenciar transações com diferentes status
• ✅ Assinaturas: Criar e gerenciar assinaturas de clientes
• ✅ Autenticação Segura: Header Auth Authorization
• ✅ Interface Intuitiva: Fácil configuração e uso
• ✅ Tratamento de Erros: Robustez e confiabilidade

Instalação

Siga as instruções de instalação para n8n community nodes.

Credenciais

Guru Digital Manager API

Para usar este node, você precisa configurar as credenciais da API do Guru Digital Manager:

• User Token: Seu token de usuário do Guru (formato: Bearer {user_token})
• Base URL: URL base da API (opcional, padrão: https://digitalmanager.guru/api/v2)

Nota: Se você encontrar o erro "Node does not have any credentials set", certifique-se de que está usando a versão 1.5.2 ou superior do pacote. Veja CREDENTIALS_SETUP.md para instruções detalhadas de configuração.

Troubleshooting

Erro 404 em Transações

Se você receber o erro "Request failed with status code 404" ao usar o Resource "Transaction", consulte o guia completo de resolução: TROUBLESHOOTING_404.md

Soluções rápidas:

• Configure a URL base correta nas credenciais
• Verifique se o ID da transação é válido
• Teste primeiro com a operação "Get All"
• Verifique os logs de debug no console do n8n

Nodes

Guru Digital Manager

Este node permite interagir com os recursos da API do Guru Digital Manager:

Recursos Suportados

• Contatos (Contacts): Gerenciamento completo de contatos
• Transações (Transactions): Gerenciamento de transações
• Assinaturas (Subscriptions): Gerenciamento de assinaturas

Operações Disponíveis

Para cada recurso, as seguintes operações estão disponíveis:

• Create: Criar um novo registro
• Get: Obter um registro específico por ID
• Get All: Listar todos os registros (com opção de limite)
• Update: Atualizar um registro existente
• Delete: Excluir um registro

Campos Específicos

Contatos

• Nome
• Email
• Telefone
• Documento (CPF/CNPJ)

Transações

• Valor
• Descrição
• Status (Pendente, Concluída, Falhou)

Assinaturas

• Plano
• Status (Ativa, Inativa, Cancelada)
• Data de Início

Desenvolvimento

Pré-requisitos

• Node.js (versão 16 ou superior)
• npm ou yarn

Instalação de Dependências

npm install

Compilação

npm run build

Desenvolvimento

npm run dev

Estrutura do Projeto

src/
├── credentials/
│   └── GuruDigitalManagerApi.credentials.ts
├── nodes/
│   └── GuruDigitalManager/
│       ├── GuruDigitalManager.node.ts
│       └── guruDigitalManager.svg
└── index.ts

🤝 Contribuição

Contribuições são bem-vindas! Por favor, leia nosso Código de Conduta antes de contribuir.

Como Contribuir

• Faça um fork do projeto
• Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
• Commit suas mudanças (git commit -m 'Add some AmazingFeature')
• Push para a branch (git push origin feature/AmazingFeature)
• Abra um Pull Request

📝 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

📞 Suporte

• Issues: GitHub Issues
• Email: [e-mail]
• Documentação: Exemplos de Uso

🙏 Agradecimentos

• n8n pela plataforma incrível
• Guru Digital Manager pela API robusta
• Todos os contribuidores da comunidade