Website Widget
The Mojeeb website widget is a chat bubble that sits on your website, allowing visitors to interact with your AI agent in real-time. No signup is required for visitors — they simply click the chat button and start a conversation. The widget is fully customizable to match your brand and works on both desktop and mobile.
How do I set up the widget?
- Go to Connect in the sidebar
- Find Website in the "Add Connections" section
- Click Connect + (or Edit if already configured)
- Customize the widget appearance and behavior
- Copy the code snippet
- Paste it into your website's HTML before the
</body>tag
For step-by-step embedding instructions, see Embed on Your Website.
What can I customize?
| Setting | Options |
|---|---|
| Colors | Custom brand palette (primary color) |
| Position | Bottom-right, bottom-left, top-right, top-left |
| Welcome message | Custom greeting text for new visitors |
| Language | Arabic, English, or auto-detect |
| Launcher text | Button text (default: "Chat with us") |
| Bot avatar | Custom image URL for the chat agent avatar |
| Agent name | Override the display name shown in chat |
| Chat icon | Custom icon URL for the launcher button |
| Custom CSS | URL to a custom CSS file for advanced styling |
| Powered by badge | Show or hide the Mojeeb branding |
| Auto-open delay | Delay in milliseconds before the chat auto-opens |
What widget modes are available?
Mojeeb offers two widget modes:
- Default mode — A ready-made chat widget with a launcher button. Visitors click the button to open the chat. This is the standard setup for most websites.
- Headless mode — A custom integration with full programmatic control. Use this if you want to build your own chat UI or trigger the widget from custom buttons.
How does the widget handle conversations?
- Visitors can start a conversation without creating an account
- The AI agent responds instantly using your Knowledge Base
- Conversations appear in your Chats dashboard in real time
- Leads are automatically captured from widget conversations
- Visitors can send text, images, audio, and documents
Can I share a direct link to the widget?
Yes. Mojeeb generates a share link for each widget that opens the chat in a standalone page. This is useful for sharing via email, SMS, or social media. Share links have a configurable expiration (default: 30 days).
Does the widget work on mobile devices?
Yes. The widget is fully responsive and optimized for mobile browsers. It adapts to smaller screens and supports touch interactions.
Common questions
Do visitors need to create an account?
No. The widget allows anonymous conversations. Visitors simply click and start chatting. Their information is captured as a lead automatically during the conversation.
Can I install the widget on multiple websites?
You can create multiple widget configurations for the same agent. Each configuration can have different customization settings.
Does the widget affect my website's performance?
The widget loads asynchronously and does not block your page from rendering. It has minimal impact on page load time.
Can I control when the widget appears?
Yes. Use the auto-open delay setting to control when the chat automatically opens, or use headless mode for full programmatic control over when and how the widget appears.