Documentation/Getting Started/Installation

Installation

Installing the Sensei AI chat widget on client websites.

Note: Sensei AI is deployed centrally by our team. This guide covers installing the chat widget on client websites, not setting up the backend.

Widget Installation

Step 1: Get the Embed Code

1. Go to the Admin Dashboard
2. Navigate to Clients
3. Find the client and click the menu (⋮)
4. Select "Get Embed Code"
5. Copy the script tag

Step 2: Add to Website

Add the script tag to the client's website, just before the closing </body> tag:

<!-- Sensei AI Chat Widget -->
<script 
  src="https://sensei-ai-eight.vercel.app/widget.js" 
  data-client-id="YOUR_CLIENT_ID"
  defer>
</script>
</body>
</html>

Step 3: Verify Installation

Chat button appears in bottom-right corner
Clicking opens the chat panel
Bot name and avatar display correctly
Messages send and receive properly

Platform-Specific Instructions

WordPress

Use a plugin like "Insert Headers and Footers" or add directly to theme's footer.php

Shopify

Online Store → Themes → Edit code → theme.liquid → Add before </body>

Squarespace

Settings → Advanced → Code Injection → Footer

Wix

Settings → Custom Code → Add Code → Body - end

Common Installation Issues

Widget not appearing

Check that the script tag is placed correctly and the client ID is valid.

Widget appears but doesn't work

Verify the client has knowledge base content. Check browser console for errors.

Styling conflicts

The widget uses isolated styles, but some aggressive CSS resets may affect it.