@guhttps/n8n-nodes-veu 0.0.0-stage → 0.7.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +60 -2
- package/dist/nodes/Veu/Veu.node.js +3517 -0
- package/dist/nodes/Veu/veu.svg +1 -0
- package/package.json +45 -4
package/README.md
CHANGED
|
@@ -1,3 +1,61 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @guhttps/n8n-nodes-veu
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**Véu para o n8n.** Esconde dados pessoais e segredos (CPF, nomes, telefones, e-mails, cartões, chaves de API) antes de o texto ir para a IA e devolve os dados reais na resposta. Ideal para atendimento por WhatsApp com IA sem expor os dados do cliente.
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
Cliente escreve: "Oi, sou a Maria Souza, CPF 529.982.247-25, quero a segunda via"
|
|
7
|
+
A IA recebe: "Oi, sou a [PESSOA_1], CPF [CPF_1], quero a segunda via"
|
|
8
|
+
A IA responde: "Olá [PESSOA_1], a segunda via do CPF [CPF_1] foi enviada"
|
|
9
|
+
O cliente recebe: "Olá Maria Souza, a segunda via do CPF 529.982.247-25 foi enviada"
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Instalar
|
|
13
|
+
|
|
14
|
+
No n8n, abra **Configurações > Nós da comunidade > Instalar** e digite `@guhttps/n8n-nodes-veu`. O nó não tem dependências: a detecção roda dentro do próprio n8n, sem chamar nenhum serviço.
|
|
15
|
+
|
|
16
|
+
## Usar
|
|
17
|
+
|
|
18
|
+
O nó **Véu** tem duas operações:
|
|
19
|
+
|
|
20
|
+
- **Esconder dados:** recebe um texto e devolve `textoProtegido` (com marcadores, como `[CPF_1]`), `encontrados` (quantos dados de cada tipo) e `cofre`. Mande para a IA só o `textoProtegido`.
|
|
21
|
+
- **Restaurar dados:** recebe a resposta da IA e o `cofre` do passo anterior (por exemplo, `{{ $('Véu: esconder').item.json.cofre }}`) e devolve `textoRestaurado`.
|
|
22
|
+
|
|
23
|
+
Opções de "Esconder dados":
|
|
24
|
+
|
|
25
|
+
| Opção | Efeito |
|
|
26
|
+
|---|---|
|
|
27
|
+
| Como esconder | Marcadores (`[CPF_1]`, dá para restaurar), máscara (`***.982.247-**`) ou remover (`[CPF]`) |
|
|
28
|
+
| Recusar se tiver | Tipos que fazem o item dar erro em vez de seguir (padrão: `CHAVE_PRIVADA`) |
|
|
29
|
+
| Nunca esconder | Valores da sua empresa que nunca são escondidos (e-mail de contato, CNPJ) |
|
|
30
|
+
| Campo de saída | Nome do campo com o texto protegido (padrão: `textoProtegido`) |
|
|
31
|
+
|
|
32
|
+
O **cofre tem os dados reais**: passe-o só para o nó "Restaurar dados", nunca para a IA. Ele fica nos dados da execução do n8n, como o texto original já ficaria.
|
|
33
|
+
|
|
34
|
+
## Modelo: WhatsApp com IA (Evolution API)
|
|
35
|
+
|
|
36
|
+
Importe [`modelos/whatsapp-evolution.json`](modelos/whatsapp-evolution.json) em **Fluxos > Importar do arquivo**. Ele recebe a mensagem pelo webhook da Evolution API, esconde os dados, pergunta à OpenAI, restaura a resposta e responde no WhatsApp. Configure a credencial da OpenAI e as variáveis `EVOLUTION_URL`, `EVOLUTION_INSTANCIA` e `EVOLUTION_APIKEY`.
|
|
37
|
+
|
|
38
|
+
## O que é detectado
|
|
39
|
+
|
|
40
|
+
Os mesmos dados da [biblioteca do Véu](https://github.com/guhttps/veu#o-que-é-detectado): nomes, CPF, CNPJ, RG, CNH, telefones, e-mails, endereços, cartões, contas, chave Pix, chaves de API, senhas e documentos de mais 21 países. Nenhuma detecção automática é perfeita: veja o [benchmark](https://github.com/guhttps/veu#benchmark).
|
|
41
|
+
|
|
42
|
+
## In English
|
|
43
|
+
|
|
44
|
+
**Véu for n8n** hides personal data and secrets (names, ID numbers, phone numbers, e-mails, cards, API keys) before text goes to an AI model, and puts the real data back in the answer. It is built for AI customer support over WhatsApp without exposing customer data. The node has no runtime dependencies: detection runs inside n8n and calls no external service.
|
|
45
|
+
|
|
46
|
+
**Install:** in n8n, open **Settings > Community nodes > Install** and enter `@guhttps/n8n-nodes-veu`.
|
|
47
|
+
|
|
48
|
+
**Operations** (the node's interface is in Portuguese):
|
|
49
|
+
|
|
50
|
+
- **Esconder dados** (hide data): takes a text and returns `textoProtegido` (with markers such as `[CPF_1]`), `encontrados` (counts per type) and `cofre` (the vault). Send only `textoProtegido` to the AI.
|
|
51
|
+
- **Restaurar dados** (restore data): takes the AI's answer and the `cofre` from the previous step (for example `{{ $('Véu: esconder').item.json.cofre }}`) and returns `textoRestaurado`.
|
|
52
|
+
|
|
53
|
+
Options of "Esconder dados": *Como esconder* (reversible markers, a mask such as `***.982.247-**`, or removal), *Recusar se tiver* (types that make the item fail instead of continuing; default `CHAVE_PRIVADA`), *Nunca esconder* (your company's own values that are never hidden) and *Campo de saída* (the output field name).
|
|
54
|
+
|
|
55
|
+
**The vault holds the real data:** pass it only to "Restaurar dados", never to the AI. It stays in n8n's execution data, as the original text would.
|
|
56
|
+
|
|
57
|
+
**Template:** import [`modelos/whatsapp-evolution.json`](modelos/whatsapp-evolution.json) (WhatsApp through the Evolution API, with OpenAI). Set the OpenAI credential and the `EVOLUTION_URL`, `EVOLUTION_INSTANCIA` and `EVOLUTION_APIKEY` variables.
|
|
58
|
+
|
|
59
|
+
**Detection:** the same as the [Véu library](https://github.com/guhttps/veu/blob/main/README.en.md): names, Brazilian documents validated by check digits, phones, e-mails, addresses, cards, bank accounts, API keys, passwords and documents from 21 other countries. No automatic detection is perfect.
|
|
60
|
+
|
|
61
|
+
MIT license. Repositório / repository: https://github.com/guhttps/veu
|