n8n-nodes-stackzap

Community node do n8n para a API do StackZap.

O node StackZap expõe as operações documentadas da API e as rotas adicionais já disponíveis no servidor atual: instâncias, mensagens, mensagens interativas, grupos, sincronização, contatos, auditoria, agendamento, chamadas, canais, webhooks, integrações Chatwoot, licenciamento, diagnósticos e fila de envio.

Os endpoints GET /ready (Readiness check) e GET /metrics (Métricas Prometheus) ficam intencionalmente fora do node.

Credencial

Crie uma credencial API StackZap com a URL base sem /v1 e sem barra final, além da chave enviada no header X-API-Key.

Corpo e parâmetros

Os parâmetros de caminho e consulta são exibidos conforme a operação escolhida. Os payloads mais usados agora aparecem como campos estruturados: mensagens, mídia, botões, listas, enquetes, grupos, participantes, sincronização, agendamento, webhooks, Chatwoot, canais, licenciamento e fila.

IDs de instância, grupo, contato, mensagem, webhook, chamada, agendamento, auditoria e integração aparecem em selects carregados pela API quando a operação fornece contexto suficiente. Coleções como botões, seções, participantes, telefones e eventos usam entradas repetíveis.

O campo Campos avançados (JSON) fica como escape hatch para payloads livres ou campos ainda não modelados, como custom_payload de simulação e callbacks.

Cada item de entrada gera um item de saída correspondente. Ative Retornar metadados para incluir operação, método e caminho resolvido no resultado.

Desenvolvimento

npm install
npm run build
npm test

O contrato de referência é o OpenAPI servido pelo StackZap em /openapi.json e as rotas adicionais são mantidas alinhadas com internal/http/server.go.