scalab

Node comunitário n8n para a API de mensageria WhatsApp da Scalab

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.2
Author: Scalab

Available Nodes

Documentation generating…

Documentation

Scalab para n8n

Node comunitário para integrar workflows do n8n com a API pública de mensageria da Scalab. Usa o gateway Evolution-compatible em /evo e autentica cada chamada com a credencial da API Key.

Este pacote cobre mensageria. Não inclui ações ou gatilhos de ligação/URA.

Credencial

Crie uma credencial Scalab API:

  • URL base da API: domínio público do gateway terminado em /evo, por exemplo https://api.seudominio.com/evo.
  • Nome da instância: nome da instância que os nodes usarão.
  • API Key da conta: chave da conta Scalab, normalmente começando com sk_.

A chave fica armazenada no cofre de credenciais do n8n e é enviada no cabeçalho apikey. Não coloque a chave em campos do workflow.

Nodes

Scalab

  • Instância: criar, listar, consultar, ver estado da conexão e conectar.
  • Mensagem: enviar texto, mídia, áudio WhatsApp, botões e listas.
  • Chat: marcar mensagens como lidas, enviar presença e apagar mensagem para todos.
  • Histórico: pedir sincronização, buscar mensagens, republicar histórico no webhook, obter mídia em Base64 e consultar foto de perfil.
  • Webhook: consultar a configuração atual (somente leitura).

Use números em formato internacional com código do país. Para mídia, informe URL pública ou Base64 conforme o endpoint aceitar. Os campos JSON de botões, listas, filtros e mensagens devem conter JSON válido.

O pacote não configura nem substitui webhooks e não registra um gatilho remoto. Adicionar o node ou ativar um workflow não envia requisições para alterar o webhook da instância.

Instalação pelo painel do n8n

Depois que n8n-nodes-scalab estiver publicado no npm público, cada cliente poderá instalar pelo n8n em Settings → Community Nodes → Install, informando o nome n8n-nodes-scalab. O n8n self-hosted precisa permitir community nodes.

Instalação manual no n8n self-hosted

O pacote local pode ser instalado no host/contêiner do n8n. Copie o .tgz para um local acessível pelo processo do n8n e instale-o no diretório de extensões comunitárias:

mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm install /caminho/para/n8n-nodes-scalab-0.1.2.tgz

Reinicie o n8n após instalar. Em Docker, o pacote precisa estar disponível dentro do contêiner e o diretório ~/.n8n/nodes deve persistir em volume. Consulte a documentação oficial de instalação de community nodes para as opções da sua versão e modo de instalação.

Para distribuir pela tela de Community Nodes do n8n, o pacote primeiro precisa ser publicado em um registry npm acessível ao seu n8n. Este repositório gera o tarball local e não publica o pacote.

Discussion