Documentation

1. Backend

The database, sign-in and realtime run on Lovable Cloud and are already connected. Check the Status page to confirm.

2. Create the first agent

Go to Agent dashboard → Create account. Confirm your email, then sign in. The very first account becomes admin and agent automatically.

3. Add teammates

Teammates sign up the same way. They see 'Waiting for access' until an admin turns on Agent for them in Settings → Team.

4. Configure the widget

Settings: brand name, accent color, welcome/offline text, business hours, required email, and allowed domains. With domains set, the widget refuses to start chats on other sites.

5. Install on your site

Publish the app, then copy the snippet from Install widget and paste it before </body>. The snippet loads /embed.js from your published address.

6. Test realtime

Set your status to Online. Open /widget in a private window, send a message, and watch it appear in the Inbox without refreshing. Reply — it appears in the widget instantly. Typing shows on both sides.

Security notes

Visitors get a secret per-conversation token kept only in their browser; the server checks it before reading or writing. Agent data is protected by row-level access rules. Visitors are limited to 5 new chats per hour per network and 12 messages per minute; link floods are rejected.