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)

• Integration guide: docs.getechostack.com/guides/n8n/
• API reference: docs.getechostack.com/reference/

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:

• Signup: https://getechostack.com/login?utm_source=docs&utm_medium=guide&utm_campaign=n8n&guide=n8n
• Guides: n8n · Inbound lead qualification · vs Zapier
• Design partners: getechostack.com#design-partners

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

Support

• Product: getechostack.com
• n8n guide: docs.getechostack.com/guides/n8n/
• Eval quickstart: docs.getechostack.com/guides/eval-quickstart/
• Issues with this node: [email protected]

License

MIT — see LICENSE.