Quick Start
Get NexusChat running on your website in under 5 minutes.
Create an account
Sign up at nexuschat.io — no credit card required. The free trial includes full Growth plan access for 14 days.
Create an inbox
Go to Settings → Inboxes → New Inbox. Give it a name, set availability hours, and configure the initial greeting message.
Add the widget to your site
Copy the snippet below and paste it before the closing </body> tag on every page.
<script>
window.NexusChatSettings = {
workspaceId: 'YOUR_WORKSPACE_ID',
primaryColor: '#00e5c8',
position: 'bottom-right'
};
</script>
<script src="https://cdn.nexuschat.io/widget.js"></script>
Test it
Open your website. The chat widget should appear bottom-right. Send a test message — it appears in your inbox immediately.
Installation
Script tag, npm, or native platform integrations.
Script tag (recommended)
Fastest way to get started. Paste before </body>:
npm
NexusChat.init({ workspaceId: 'YOUR_ID' });
| Platform | Method | Notes |
|---|---|---|
| HTML | Script tag | Works on any static site |
| React / Next.js | npm | Add in _app.js or layout |
| Vue / Nuxt | npm | Add in app.vue or plugin |
| Shopify | Native | No code required |
| WordPress | Plugin | Available in WP directory |
Create your first inbox
An inbox is a channel that collects conversations from a specific source.
Steps
- Go to Settings in the left sidebar
- Click Inboxes → Add new inbox
- Choose a channel type: Website, Email, or API
- Enter name and configure settings
- Add agents who receive conversations from this inbox
- Copy widget snippet and add to your site
Widget Customization
Customize appearance and behavior to match your brand.
workspaceId: 'YOUR_ID',
primaryColor: '#00e5c8',
position: 'bottom-right',
welcomeTitle: 'Hi there 👋',
welcomeTagline: 'We reply in minutes',
showAvailability: true,
hideOnMobile: false
};
Authentication
All API requests require your API key as a bearer token.
Getting your API key
Generate from Settings → API → New API key. Never expose it client-side.
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
| Plan | Requests/min | Requests/day |
|---|---|---|
| starter | 60 | 5,000 |
| growth | 300 | 50,000 |
| enterprise | Custom | Unlimited |
Automations
Set up keyword triggers and bot workflows to automate responses.
Go to Settings → Automations to create rules. Each rule has conditions (keywords, URL patterns, visitor attributes) and actions (send message, assign agent, add label).
Routing Rules
Route conversations to the right team automatically.
Configure in Settings → Routing. Route based on URL, visitor location, language, or message keywords. Rules are evaluated in priority order.
Slack Integration
Receive notifications and reply to chats directly from Slack.
Connect in Settings → Integrations → Slack. Authorize NexusChat to post to your chosen channels. You can reply to conversations from Slack using /nc-reply.
HubSpot Integration
Sync contacts and conversations with HubSpot CRM.
Connect in Settings → Integrations → HubSpot. When a visitor starts a chat, NexusChat creates or updates a HubSpot contact and logs the conversation as a CRM activity.
Zapier Integration
Connect NexusChat to 5,000+ apps via Zapier.
Available triggers: New conversation, New message, Conversation resolved. Use these to automate workflows with any app in the Zapier ecosystem.
Conversations API
Programmatically manage conversations.
GET /v1/conversations
# Get single conversation
GET /v1/conversations/:id
# Send a message
POST /v1/conversations/:id/messages
Webhooks
Receive real-time events when things happen in NexusChat.
Register a webhook URL in Settings → Integrations → Webhooks. NexusChat POSTs JSON to your URL for events: conversation.created, message.created, conversation.resolved.