n8n-nodes-go-api

Este Community Node permite integrar a GO-API com o N8N, possibilitando automações completas com WhatsApp.

📋 Requisitos

• N8N versão 1.54.4 ou superior
• GO-API instalada e configurada

🚀 Instalação

Via N8N Community Nodes (Recomendado)

1. Acesse as configurações do N8N
2. Vá em "Community Nodes"
3. Pesquise por n8n-nodes-go-api
4. Clique em "Install"

Via NPM (Manual)

cd ~/.n8n/nodes
npm install n8n-nodes-go-api

Depois reinicie o N8N.

📦 Publicação no NPM (Para Desenvolvedores)

Pré-requisitos

1. Conta no NPM: Crie uma conta em npmjs.com
2. Node.js 18+ instalado
3. pnpm instalado: npm install -g pnpm

Passo a Passo

# 1. Clone ou acesse o diretório do projeto
cd n8n-nodes-go-api-main

# 2. Instale as dependências
pnpm install

# 3. Compile o projeto
pnpm build

# 4. Faça login no NPM
npm login

# 5. Publique o pacote
npm publish --access public

Atualizando Versão

Para publicar uma nova versão:

# Atualizar versão (patch: 1.0.0 -> 1.0.1)
npm version patch

# Ou minor (1.0.0 -> 1.1.0)
npm version minor

# Ou major (1.0.0 -> 2.0.0)
npm version major

# Publicar
npm publish --access public

⚙️ Configuração

1. Após instalar, adicione uma nova credencial do tipo "GO-API"
2. Preencha:
   • Server URL: URL da sua GO-API (ex: https://api.seudominio.com)
   • ApiKey: Sua chave de API (obtida no painel da instância)

📌 Recursos Disponíveis

✉️ Mensagens

Envio de diversos tipos de mensagens:

• Texto - Enviar mensagem de texto com menções
• Imagem - Enviar imagem com legenda
• Vídeo - Enviar vídeo com legenda
• Áudio - Enviar áudio (PTT/Gravação de voz)
• Documento - Enviar arquivos PDF, DOC, etc
• Localização - Enviar localização no mapa
• Contato - Enviar cartão de contato
• Enquete - Criar enquetes interativas
• Lista - Enviar lista de opções
• Sticker - Enviar figurinhas
• Reação - Reagir a mensagens com emoji

👥 Grupos

Gerenciamento completo de grupos:

• Criar Grupo - Criar novo grupo
• Atualizar Nome - Alterar nome do grupo
• Atualizar Descrição - Alterar descrição
• Gerenciar Participantes - Adicionar/Remover/Promover/Rebaixar
• Configurações - Alterar configurações do grupo
• Listar Grupos - Buscar todos os grupos
• Link de Convite - Obter/Revogar link de convite
• Participantes - Listar participantes
• Sair do Grupo - Sair de um grupo

💬 Chat

Funcionalidades de chat:

• Buscar Contatos - Listar todos os contatos
• Deletar Mensagem - Apagar mensagem enviada

📢 Newsletter/Canais

Gerenciamento de canais do WhatsApp:

• Listar Newsletters - Ver todos os canais
• Criar Newsletter - Criar novo canal
• Enviar Texto - Postar texto no canal
• Enviar Imagem - Postar imagem no canal
• Enviar Vídeo - Postar vídeo no canal
• Seguir/Deixar de Seguir - Gerenciar inscrição
• Silenciar/Dessilenciar - Gerenciar notificações

🔗 Integrações

Integrações disponíveis:

• Chatwoot - Configurar integração com Chatwoot
• Typebot - Configurar integração com Typebot

📡 Endpoints da API

Mensagens

| Endpoint | Método | Descrição | |----------|--------|-----------| | /api/send/text | POST | Enviar texto | | /api/send/image | POST | Enviar imagem | | /api/send/video | POST | Enviar vídeo | | /api/send/audio | POST | Enviar áudio | | /api/send/document | POST | Enviar documento | | /api/send/location | POST | Enviar localização | | /api/send/contact | POST | Enviar contato | | /api/send/poll | POST | Enviar enquete | | /api/send/list | POST | Enviar lista | | /api/send/sticker | POST | Enviar sticker | | /api/message/react | POST | Reagir mensagem | | /api/message/delete | POST | Deletar mensagem |

Grupos

| Endpoint | Método | Descrição | |----------|--------|-----------| | /api/group/create | POST | Criar grupo | | /api/group/subject | POST | Atualizar nome | | /api/group/description | POST | Atualizar descrição | | /api/group/add | POST | Adicionar participantes | | /api/group/remove | POST | Remover participantes | | /api/group/promote | POST | Promover a admin | | /api/group/demote | POST | Rebaixar admin | | /api/group/settings | POST | Configurações | | /api/group/leave | POST | Sair do grupo | | /api/group/{groupId}/invite | GET | Obter link convite | | /api/group/revoke-invite | POST | Revogar link | | /api/contacts/groups | GET | Listar grupos | | /api/contacts/groups/{groupId}/participants | GET | Listar participantes |

Newsletter/Canais

| Endpoint | Método | Descrição | |----------|--------|-----------| | /api/newsletter | GET | Listar newsletters | | /api/newsletter/create | POST | Criar newsletter | | /api/newsletter/text | POST | Enviar texto | | /api/newsletter/image | POST | Enviar imagem | | /api/newsletter/video | POST | Enviar vídeo | | /api/newsletter/follow | POST | Seguir | | /api/newsletter/unfollow | POST | Deixar de seguir | | /api/newsletter/mute | POST | Silenciar | | /api/newsletter/unmute | POST | Dessilenciar |

Contatos

| Endpoint | Método | Descrição | |----------|--------|-----------| | /api/contacts | GET | Listar contatos |

📖 Documentação

Acesse a documentação completa em: https://usego.com.br/docs

🤝 Suporte

• Site: https://usego.com.br
• Email: [email protected]

📄 Licença

MIT License - Veja o arquivo LICENSE.md para mais detalhes.

Desenvolvido com ❤️ por GO-API