EchoStack Docs
Integration guides API reference Open dashboard

n8n integration

Send forms, webhooks, or conversation transcripts to your deployed EchoStack playbook and branch automation on status and next_action.

Outcome

An n8n workflow evaluates inbound signals and routes qualified leads to CRM, Slack, or nurture sequences.

Prerequisites

  • Completed Eval API quickstart
  • Live deployment and ech_dw_… secret
  • n8n Cloud or self-hosted instance

Architecture

Trigger (Webhook / HubSpot / Typeform)
    → EchoStack Evaluate
    → Switch on status
        → QUALIFIED → CRM / book meeting
        → PARTIAL → nurture / ask for fields
        → FAILED → archive
        → ESCALATE → alert channel

1. Install the community node

n8n Cloud

  1. 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.

2. Credentials

Create an EchoStack API credential:

Field Value
Base URL https://api.getechostack.com (or your dashboard value)
Deployment Secret ech_dw_… from Dashboard → deployment → Webhook secret

The credential test calls POST /v1/evaluate with a minimal payload. On a live deployment, that counts toward your evaluation quota.

3. Evaluate node

EchoStack → Evaluation → Evaluate

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

4. 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, nurture sequence
FAILED Archive or tag disqualified
ESCALATE Alert a channel or human review

5. Starter workflow

Import the sample workflow shipped with the package:

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, etc.).

6. Verify

  1. Run the workflow once in n8n.
  2. Open your deployment page → Recent evaluations.

Errors

HTTP Meaning
402 Quota exceeded — check message, resetAt, upgradeUrl
429 Rate limited — retry after a short delay

Related