Description

n8n-nodes-palantiriapi

Nó comunitário n8n para palantiriAPI (API WhatsApp multi-tenant).

Repositório: padrões de community nodes do n8n: nome n8n-nodes-*, keyword n8n-community-node-package, metadados n8n no package.json, e sem dependências de runtime (apenas peerDependencies para n8n-core/n8n-workflow), em linha com os requisitos para verified community nodes.

Instalação no n8n

1. No n8n: Settings → Community nodes → Install.
2. Instale por npm (quando publicar): n8n-nodes-palantiriapi
Ou por repositório: https://github.com/gabrieldarruiz/palantiriapin8ncommunitynode
3. Reinicie o n8n se pedido.

Credenciais

• Base URL: URL base da sua palantiriAPI (ex.: https://api.seudominio.com ou https://n8n.astrasolution.com.br/palantiri).
• Auth Type:

– Instance API Key: envia X-API-Key
– Bearer JWT: envia Authorization: Bearer

• API Key / Bearer Token: conforme o tipo de autenticação escolhido.

Operações

| Operação | Descrição |
|—————–|————————————|
| Status | GET status da instância WhatsApp |
| Health | GET health da instância |
| Buscar QR | GET QR atual da instância |
| Logout | POST logout da instância |
| Enviar texto | POST send-text (to + text) |
| Enviar imagem | POST send-image (to, caption, mídia binária ou base64, mimetype) |
| Enviar áudio | POST send-audio (to, mídia binária ou base64, mimetype) |
| Enviar documento| POST send-document (to, caption, mídia binária ou base64, mimetype, file_name) |
| Enviar vídeo | POST send-video (to, caption, mídia binária ou base64, mimetype) |
| Enviar sticker | POST send-sticker (to, mídia binária ou base64, mimetype) |
| Listar chats | GET chats (lista de conversas) |
| Listar mensagens| GET messages (mensagens de um chat) |
| Listar grupos | GET groups |
| Consultar contato | GET contacts |
| Verificar telefones | POST check-phone |
| Baixar mídia | GET media (retorna binário no output do n8n) |

Campo “Para” (to)

• Número: com código do país, ex.: 5511999999999.
• Grupo: JID do grupo, ex.: 120363167603218039@g.us.

Mídia no n8n

• Operações de mídia aceitam Fonte da Mídia = Binário de Entrada ou Base64.
• No modo binário, use a propriedade padrão data ou informe outro nome em Binary Property.
• O node tenta reaproveitar mimeType e fileName do binário automaticamente quando fizer sentido.

Desenvolvimento

O projeto usa o n8n-node CLI (oficial) para build, lint e release. Para criar um novo nó do zero com o assistente interativo (nome, tipo HTTP API ou Other, template), veja Setting node details interactively. Depois de npm install:

npm run build      # compila TypeScript e copia assets (codex, etc.)
npm run dev        # sobe o n8n local com o nó carregado e hot-reload
npm run lint       # checagem de estilo/erros (n8n-node lint)
npm run lint:fix   # correção automática quando possível
npm run release    # publica no npm (release-it + n8n-node prerelease)

Para testar no n8n em modo dev: npm run dev e acesse http://localhost:5678; ou instale o pacote pelo caminho da pasta (Settings → Community nodes → Install from folder).

Erro “The specified package could not be loaded”

Esse erro costuma vir de cache/instalação antiga na pasta de nós do n8n. Faça o seguinte:

Se o n8n roda em Docker (no servidor):

1. Descubra o nome do container:
docker ps | grep n8n
2. Limpe e reinicie (troque NOMEDOCONTAINER pelo nome que apareceu):

   docker exec NOMEDOCONTAINER sh -c 'rm -rf /home/node/.n8n/nodes/package.json /home/node/.n8n/nodes/node_modules'
   docker restart NOMEDOCONTAINER
   

3. Espere o n8n voltar (alguns segundos) e, na interface: Settings → Community nodes → Install → n8n-nodes-palantiriapi.

Exemplo se o container se chama n8n:

docker exec n8n sh -c 'rm -rf /home/node/.n8n/nodes/package.json /home/node/.n8n/nodes/node_modules'
docker restart n8n

Se o n8n roda direto na máquina (sem Docker):

1. Pare o n8n.
2. rm -rf ~/.n8n/nodes/package.json ~/.n8n/nodes/node_modules
3. Suba o n8n de novo e instale o pacote outra vez.

Há também um script em scripts/fix-n8n-load.sh que tenta fazer a limpeza automaticamente (Docker ou não).

Licença

MIT