palantiriapi

n8n community node for palantiriAPI (WhatsApp API)

Package Information

Downloads: 49 weekly / 1,528 monthly
Latest Version: 0.1.15
Author: Gabriel Darruiz

Available Nodes

Palantiri API icon
Palantiri API
Enviar mensagens e consultar palantiriAPI (WhatsApp)

Documentation

n8n-nodes-palantiriapi

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

Repositório: github.com/gabrieldarruiz/palantiri_api_n8n_community_node

Este pacote segue os 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/palantiri_api_n8n_community_node
  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).
  • API Key: API Key da instância (gerada na palantiriAPI por instância) ou token JWT. A API aceita header X-API-Key.

Operações

Operação Descrição
Status GET status da instância WhatsApp
Enviar texto POST send-text (to + text)
Enviar imagem POST send-image (to, text, base64, mimetype)
Enviar documento POST send-document (to, text, base64, mimetype, file_name)
Listar chats GET chats (lista de conversas)
Listar mensagens GET messages (mensagens de um chat)

Campo "Para" (to)

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

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 NOME_DO_CONTAINER pelo nome que apareceu): 
    docker exec NOME_DO_CONTAINER sh -c 'rm -rf /home/node/.n8n/nodes/package.json /home/node/.n8n/nodes/node_modules'
docker restart NOME_DO_CONTAINER
  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

Discussion