Widget Setup
NodeLoom widgets let you embed AI-powered chat interfaces on any website. Each widget connects to a workflow containing AI Agent nodes, inheriting all the tools and capabilities configured in that workflow.
Creating a Widget
Widgets are created from the NodeLoom dashboard. Navigate to Settings → Widgets and click Create Widget. You will be prompted to configure the following:
| Field | Description |
|---|---|
| Widget name | A descriptive name for internal identification (not visible to end users). |
| Connected workflow | The workflow that handles widget messages. Must contain at least one AI Agent node. |
| Welcome message | The initial message displayed when a visitor opens the widget. |
| Input placeholder | Placeholder text shown in the chat input field. |
AI Agent requirement
Workflow Connection
When you connect a widget to a workflow, the widget inherits the full tool access of that workflow's AI Agent. This means if your workflow's agent has access to a database query tool, an API integration tool, or a knowledge base search tool, the widget visitor can interact with all of those capabilities through the chat interface.
You can change the connected workflow at any time. The widget will immediately start using the new workflow for all subsequent messages. Existing conversation history is preserved.
Colors and Branding
Each widget can be customized to match your brand. The following visual properties are configurable from the dashboard:
| Property | Description |
|---|---|
| Primary color | Used for the header background, send button, and accent elements. |
| Background color | The chat window background color. |
| Text color | Primary text color for messages and UI elements. |
| Agent message background | Background color for messages from the AI agent. |
| User message background | Background color for messages from the visitor. |
| Logo | A custom logo displayed in the chat header. |
| Position | Widget button placement: bottom-right or bottom-left of the page. |
Token Authentication
Each widget is assigned a unique authentication token. This token is embedded in the script tag on your website and identifies which widget configuration and workflow to use.
<script
src="https://your-instance.nodeloom.io/widget/embed.js"
data-widget-token="<your-widget-token>"
async>
</script>Token visibility
Rate Limiting
Each widget has configurable rate limits to prevent abuse. Rate limits are enforced per widget token and can be adjusted from the widget settings page.
| Limit | Default | Configurable |
|---|---|---|
| Messages per minute (per visitor) | 20 | Yes |
| Messages per hour (per visitor) | 200 | Yes |
| Concurrent sessions per widget | 100 | Yes |
| Max message length | 4,000 characters | Yes |
When a rate limit is exceeded, the widget displays a friendly message asking the visitor to wait before sending more messages. Rate limit events are logged in the widget analytics dashboard.
Monitoring usage