Node-RED Integration
Put your AI agent, your leads and your chats into any Node-RED flow
Overview
Node-RED is a visual automation tool. You drag boxes onto a canvas, draw wires between them, and the message travels from box to box. Each box is a node. A finished canvas is a flow.
The Asyntai package gives you five nodes. Ask your AI agent a question from anywhere. Start a flow the moment a visitor leaves an email address. Read chat transcripts. Feed fresh knowledge to the agent from the systems you already run.
The Nodes
| Node | What it does |
|---|---|
| ask Asyntai | Sends a question and returns the answer, written from your own website content, your documents and your product feed. |
| Asyntai events | Starts a flow the moment a visitor leaves an email or a phone number, starts a chat, asks for a person, or opens a support ticket. |
| Asyntai leads | Reads the contact details visitors left in the chat. |
| Asyntai chats | Lists recent chats, or returns the full transcript of one chat. |
| Asyntai knowledge | Adds text or a page to what the agent answers from, lists what is stored, and removes an item. |
Requirements
- Node-RED 3.0 or newer, on Node.js 18 or newer
- An Asyntai account on the Starter plan or higher, because the nodes use the Asyntai API
Installation
Follow these steps to add Asyntai to Node-RED:
Install the Nodes
In the Node-RED editor, open the menu, choose Manage palette, then Install. Search for node-red-contrib-asyntai and press Install.
From a terminal, run npm install node-red-contrib-asyntai in your Node-RED user directory, then restart Node-RED.
Get Your API Key
Sign in to Asyntai, open Settings, then API, and copy your API key.
Add the Key Once
Drag any Asyntai node onto the canvas and open it. Next to API, press the pencil. Paste your key and press Test connection. Press Add, then Done, then Deploy.
Every Asyntai node in every flow now shares that one key.
Try It
Wire an inject node into ask Asyntai, and ask Asyntai into a debug node. Set the inject payload to a question your customers ask. Press Deploy, then press the inject button. The answer appears in the debug panel.
Starting a Flow on a New Lead
The Asyntai events node opens an endpoint on your Node-RED. Asyntai posts events to it.
Leave Register ticked and fill in Public URL with the address that reaches your Node-RED from the internet, for example https://node-red.example.com. The node creates the webhook in Asyntai for you, and removes it again when you delete the node.
Untick Register if you want to add the webhook by hand. Then add <your public address>/asyntai in Asyntai under Settings, API, Webhooks.
Asyntai signs every request. When the node registered the webhook itself, it holds the signing secret and drops any request whose signature does not match.
Things to Build
- Send every new lead to your team chat, your CRM or a spreadsheet, the second it arrives.
- Push live stock levels or opening hours from another system into the knowledge base every hour.
- Answer questions on a smart speaker, a kiosk or a factory panel with your own business knowledge.
- Build a daily report of yesterday's chats and email it to yourself.
- Open a ticket in your help desk when a visitor asks for a person.
Tip: Set the same Session ID on every message of one conversation. The agent then remembers what was said before.
Removing It
Open Manage palette, find node-red-contrib-asyntai and press Remove. Delete any Asyntai nodes from your flows first.
Plans & Pricing
The nodes are free. They use the Asyntai API, which needs the Starter plan or higher. View pricing.
Need Help?
If you have any questions or run into issues, contact us at [email protected].