Package Information
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 exemplohttps://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.
