Cansado da complexidade desnecessária?

• De seguir tutoriais intermináveis que constroem castelos no ar com dezenas de nós?
• De montar buffers com Redis ou bases de dados para algo que só vive por alguns segundos?
• Dos "vendedores de fumaça"?

gblabs-n8n-buffer é a sua solução. Um buffer simples, potente e direto para sistemas de chat no n8n.

A verdade sobre as ferramentas "No-Code"

O n8n é uma plataforma maravilhosa, sem dúvida. Dá-nos uma agilidade incrível. Mas sejamos honestos: como toda ferramenta, tem os seus limites. A falta de orientação a objetos ou de um paralelismo real lembra-nos de algo importante.

O verdadeiro poder não vem apenas de arrastar e soltar nós, mas de entender os fundamentos. A promessa de que "você já não precisa saber programar" é o feitiço mais comum dos vendedores de fumaça da nossa era. Muitas das "soluções" que você verá por aí, por exemplo, simplesmente descartam mensagens quando duas conversas colidem, um "detalhe" que convenientemente omitem.

Este nó é um pequeno manifesto. Uma prova de que, com um pouco de código e lógica da velha guarda, podemos superar as limitações nativas para construir soluções mais eficientes e elegantes.

Saber programar continua a ser uma habilidade indispensável. Não se deixe enganar.

Como funciona? A simplicidade é poder.

Em vez de montar uma infraestrutura complexa, apoiamo-nos numa das capacidades mais básicas e potentes: a memória RAM.

1. Variáveis Globais: Usamos uma simples variável global no n8n para manter a fila de mensagens.
2. Buffer em RAM: Cada nova mensagem de uma sessão é guardada num array em memória. Rápido, direto, sem latência de rede ou de disco.
3. Timeout Inteligente: O buffer espera alguns segundos (configurável). Se chegar uma nova mensagem, o contador é reiniciado. Se o tempo passar sem atividade, pronto!
4. Concatenação e Envio: Todas as mensagens no buffer são unidas num único texto и enviadas para o nó seguinte.
5. Desaparecimento Efêmero: Uma vez processado, o buffer dessa sessão é limpo da RAM. Não precisa de persistência porque o seu propósito é temporal, vive apenas por alguns segundos.

É assim tão simples. Sem bases de dados, sem configurações complexas, sem dependências externas.

Diagrama de Fluxo

graph TD
    A["Início: Mensagem Recebida"] --> B{"Buffer para SessionID existe?"};
    B -- "Não" --> C["Cria novo buffer para SessionID"];
    C --> D;
    B -- "Sim" --> D["Adiciona mensagem e timestamp ao buffer"];
    D --> E["Inicia/Reinicia Timeout"];
    E --> F["...aguarda timeout..."];
    F --> G{"É esta a última mensagem recebida?"};
    G -- "Sim<br/>(não chegaram novas mensagens)" --> H["Processa o Buffer"];
    H --> I["1. Concatena todas as mensagens"];
    I --> J["2. Envia o resultado final"];
    J --> K["3. Elimina o buffer da sessão"];
    K --> L["Fim"];
    G -- "Não<br/>(chegou uma nova mensagem)" --> M["Não faz nada<br/>(a nova mensagem tratará disso)"];
    M --> L;

Instalação

npm install n8n-nodes-gbplabs-chat-buffer

Depois, reinicie a sua instância do n8n.

Utilização

Procure o nó Chat Buffer e adicione-o ao seu workflow. Configure os parâmetros:

• Session ID: O identificador único da conversa (ex: {{ $json.jid }}).
• Message: O conteúdo da mensagem a "bufferear" (ex: {{ $json.textMessageContent }}).
• Timeout (ms): Quantos milissegundos esperar (padrão: 3000).
• Separator: O texto que unirá as mensagens (padrão: . ).

Desenvolvido com ❤️ e um pouco de rebeldia por:

Pablo Luis Sánchez Stahlschmidt
[email protected]
Da nova terra da liberdade 🇦🇷