talkward

n8n nodes for Talkward: trigger workflows on new messages, handovers and tags, answer customers, add notes, set status, tags and fields.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: Talkward

Available Nodes

Documentation generating…

Talkward icon
Talkward
Answer customers and manage conversations in Talkward
Talkward Trigger icon
Talkward Trigger
Starts the workflow when something happens in Talkward

Documentation

n8n-nodes-talkward

n8n nodes for Talkward, the customer inbox with AI agent for online shops.

  • Talkward Trigger starts a workflow when something happens in Talkward.
  • Talkward answers customers and manages conversations.

Requires a Talkward workspace on Professional or higher with the add-on n8n (Settings › Add-ons).

Installation

Self-hosted n8n: Settings › Community Nodes › Install, package name n8n-nodes-talkward.

Without the npm registry (e.g. for testing):

npm run build && npm pack

then install the .tgz in ~/.n8n/nodes (npm install <path>/n8n-nodes-talkward-0.1.0.tgz) and restart n8n.
Or point N8N_CUSTOM_EXTENSIONS at the built folder.

Credentials

  1. In Talkward: Settings › Add-ons › n8n › Create key. The key starts with tw_ and is shown once.
  2. In n8n: new credential Talkward API, paste the key. The URL stays https://chat.talkward.app
    unless your workspace runs elsewhere. n8n tests the key against GET /api/v1/ich.

Trigger

Event When
New Customer Message (nachricht_neu) a customer wrote
Message Sent (nachricht_gesendet) a reply of the team, the AI or an automation reached the customer
New Conversation (gespraech_neu) a conversation started
Handover to Team (uebergabe) the AI handed over to a human
Conversation Closed (erledigt) marked as done
Conversation Assigned (zuweisung) assigned to a team member
Tag Added (tag) a tag was added

Optionally only for one brand. Activating the workflow subscribes via POST /api/v1/webhooks,
deactivating unsubscribes. Talkward signs every delivery (X-Talkward-Signatur: sha256=<HMAC-SHA256 of the body>); the trigger rejects calls without a valid signature with 401.

Talkward only delivers to public HTTPS addresses. n8n must be reachable via HTTPS from the internet
(WEBHOOK_URL), also for "Listen for test event". Failed deliveries are retried after 1, 5, 30 and 120 minutes.

Payload (shortened):

{
  "id": 1812,
  "ereignis": "nachricht_neu",
  "zeit": "2026-09-25T14:03:11+00:00",
  "gespraech": {
    "id": 42, "marke": "bertrand", "kanal": "whatsapp", "status": "ki",
    "kunde": { "name": "Anna Muster", "mail": null, "telefon": "+4915112345678" },
    "tags": ["vip"], "felder": { "Bestellnr": "4711" },
    "link": "https://chat.talkward.app/#/posteingang/haupt/42"
  },
  "nachricht": { "id": 991, "von": "kunde", "text": "Wo ist meine Bestellung?", "anhaenge": [] }
}

Actions

Resource Operation API
Conversation Get, Get Many (contact, status, brand) GET /gespraeche/{id}, GET /gespraeche
Conversation Get Messages (optionally with notes) GET /gespraeche/{id}/nachrichten
Conversation Reply (in the conversation's channel) POST /gespraeche/{id}/nachrichten
Conversation Add Note POST /gespraeche/{id}/notizen
Conversation Set Status (AI, team, done, reopen, spam) POST /gespraeche/{id}/status
Conversation Assign POST /gespraeche/{id}/zuweisen
Conversation Update Tags, Set Fields, Update Contact …/tags, …/felder, …/kontakt
Message Send to an email address or WhatsApp number POST /nachrichten
Contact Search GET /kontakte

The Talkward node can also be used as a tool by n8n AI agents.
Limit: 300 requests per minute and key. Errors come back as codes, e.g. Talkward: konversation.nicht_gefunden.

License

MIT

Discussion