Documentation
Everything you need to set up, configure, and get the most out of Connect.
Getting Started
1. Create Your Account
Sign up at onconnect.one/sign-up using your email. You'll be prompted to create or join an organization through Clerk authentication.
2. Set Up Your Organization
After signing in, your organization is automatically synced. Navigate to the Dashboard to configure your workspace, invite team members, and customize settings.
3. Configure Your Widget
Go to Widgets > Customization to set your brand color, welcome messages, and company name. Click "Publish" to save your configuration.
4. Install on Your Website
Copy the embed script from Widgets > Installation Guide and paste it into your website's HTML before the closing </head> tag. The widget will appear automatically.
Chat Widget
Embedding the Widget
Add the Connect widget to any website by pasting the embed snippet. The script loads asynchronously and won't block your page rendering. Initialize with your organization ID.
Customization Options
Configure your widget
Chat Modes
Visitors can start a chat conversation and connect with your support team in real time. The widget supports fast, reliable messaging.
Conversation History
Returning visitors can view their past conversations through the Inbox tab in the widget. Conversations are linked by email address for continuity.
Unified Inbox
Conversation Management
All customer conversations appear in a unified inbox. Filter by status (active, resolved), search by content, and view real-time message updates.
Reply & Resolve
Respond to customers directly from the inbox. Mark conversations as resolved when complete. Resolved conversations can be reopened if the customer sends a new message.
Real-Time Updates
Messages appear instantly thanks to Convex's reactive data layer. No need to refresh — new messages, status changes, and typing indicators all update in real time.
Team Management
Invite Members
Invite team members by email from the Team section in the dashboard. New members join with the 'member' role by default.
Role-Based Access
Three roles available: Owner (full access), Admin (manage settings and team), and Member (inbox and conversation access). Roles can be changed by owners and admins.
Seat Management
Pro plan includes 10 seats. Additional seats can be managed from the billing section.
Widget Customization
Brand Colors
Set your primary brand color using a hex color picker. The widget automatically adjusts text contrast for readability.
Welcome Messages
Customize the welcome heading, subheading, and agent greeting. Each can be independently configured.
Preview & Publish
Use the live preview to see changes in real time before publishing. Changes only go live when you click Publish.
Security & Compliance
Encryption
All data is encrypted with AES-256 at rest and TLS 1.3 in transit. Encryption keys are managed securely and rotated regularly.
GDPR Compliance
Connect is fully GDPR compliant. Data is hosted in EU (West 1) region. Users can request data export or deletion at any time.
Session Security
Widget sessions use cryptographic tokens validated on every request. Sessions expire after inactivity and are scoped to specific organizations.
Audit Logging
All administrative actions are logged with timestamps and user attribution. Audit logs can be exported on the Pro plan.
API & Integration
Embed Script
The embed script is available at https://connect-widget-virid.vercel.app/embed.js. Initialize with: connect("init", { organizationId: "your_org_id" })
Webhook Support
Clerk webhooks are configured for user and organization sync. Custom webhooks can be set up for conversation events and message notifications.
Convex Backend
Connect uses Convex as its real-time backend. All mutations and queries are fully typed and validated. The API is organized into public (widget-facing) and private (dashboard-facing) endpoints.
Billing & Plans
Free Plan — $0/month (or €0)
Includes 1 team seat, unlimited conversations, and a default widget.
Pro Plan — $15/month (or €15)
Includes 10 team seats, unlimited conversations, branding removal, and full customization.
Payment Processing
Payments are processed through Paddle. Manage your subscription, update payment methods, and view invoices from the Account section in the dashboard.