echostack

EchoStack Evaluation API community node for n8n — evaluate forms, webhooks, and transcripts; branch on qualification status.

Package Information

Released: 4 mo ago
Downloads: 29 weekly / 269 monthly
Latest Version: 0.2.1
Author: EchoStack

Available Nodes

EchoStack icon
EchoStack
Evaluate structured input against your EchoStack deployment playbook. Branch on {{ $json.status }} and {{ $json.next_action }} to route downstream automation.

Documentation

n8n-nodes-echostack

Official n8n community node for the EchoStack Evaluation API.

Send forms, webhooks, or conversation transcripts to EchoStack with your org API key and branch automation on status and next_action.

Prerequisites

  1. An EchoStack account
  2. An Organization API key (esk_…) from Dashboard → API Keys
  3. An evaluation_id from POST /v1/evaluations (see the eval quickstart)

Install

n8n Cloud

  1. Open Settings → Community Nodes → Install
  2. Enter n8n-nodes-echostack
  3. Restart n8n if prompted

Self-hosted

npm install n8n-nodes-echostack

Restart your n8n instance after install.

Credentials

Create an EchoStack API credential in n8n:

Field Value
Base URL https://api.getechostack.com (use your dashboard value if different)
Organization API Key esk_… from Dashboard → API Keys
Evaluation ID UUID from POST /v1/evaluations

The credential test calls GET /v1/evaluations/:id with the configured Evaluation ID — it validates the key and the evaluation binding without consuming evaluation quota.

You can override the credential's Evaluation ID per request on the Evaluate node (e.g. when one key drives multiple evaluations).

Node: EchoStack → Evaluation → Evaluate

Input mode Use when
Form Fields Prior node outputs flat JSON (webhooks, form tools, CRM triggers). Default: ={{ $json }}
Transcript JSON array of { "role": "user", "content": "..." } turns
Raw JSON Full POST /v1/evaluate request body

Branching

After Evaluate, add a Switch (or IF) on:

  • {{ $json.status }} — QUALIFIED, PARTIAL, FAILED, ESCALATE
  • {{ $json.next_action }} — BOOK_MEETING, GATHER_INFO, NURTURE, DISQUALIFY, ESCALATE_NOW, CLOSE
  • {{ $json.missing_fields }} — required fields still missing
status Common next steps
QUALIFIED Notify sales, update CRM, book a meeting
PARTIAL Ask for missing info, add to a nurture sequence
FAILED Archive or tag as disqualified
ESCALATE Alert a channel or route to human review

Errors

HTTP Meaning
401 Invalid esk_… — regenerate under Dashboard → API Keys
400 Missing or invalid evaluation_id on the credential or Evaluate node
402 Quota exceeded — check message, resetAt, upgradeUrl in the response
429 Rate limited — retry after a short delay

Starter workflow

A sample workflow ships with this package.

After install (self-hosted):

node_modules/n8n-nodes-echostack/example-workflow.json

From npm CDN (any environment):

unpkg.com/n8n-nodes-echostack/example-workflow.json

In n8n: ⋯ → Import from file, attach your EchoStack API credential on the Evaluate node, then run once with the pinned test data.

The template uses a Webhook trigger for easy testing. Replace it with your production trigger (HubSpot, Typeform, custom app, etc.) and wire each Switch branch to your CRM, email, or chat tools.

Distribution (maintainers)

Promote with UTM-tagged links so signups attribute to n8n:

Full checklist: docs/marketing/dev-distribution.md in the echostack-playbooks monorepo.

Support

License

MIT — see LICENSE.

Discussion