Core Features
Chat Widget Integration
Learn how to embed, customize, and secure the Sentrup interactive chat widget on any website. Our script is optimized for performance, loading asynchronously without blocking rendering.
Embedding the Widget
To deploy the widget, paste the following HTML snippet right before the closing `</body>` tag of your website:
<script src="https://www.sentrup.com/embed/chat-widget.js" data-tenant-id="your-workspace-tenant-id" defer ></script>
Make sure to replace your-workspace-tenant-id with the actual ID located in your Sentrup Admin Dashboard settings.
Visual Customization
You can style the widget button and popup container to match your brand styling. You can configure these in the Admin Settings panel or pass them as script attributes:
- data-theme-color: Set the hex code for buttons and highlights (e.g., `#FF4D6D`).
- data-title: Define the custom greeting title (e.g., `Sentrup Support`).
- data-placeholder: Define the input box placeholder text.
- data-position: Position the floating icon on the page (`left` or `right`).
<script src="https://www.sentrup.com/embed/chat-widget.js" data-tenant-id="your-workspace-tenant-id" data-theme-color="#FF4D6D" data-title="Sentrup Support" data-placeholder="Ask us anything..." data-position="right" defer ></script>
Allowed Domain Security
To prevent third-party sites from hosting your assistant and draining your API usage quotas, configure the **Allowed Origins** setting in the dashboard.
Once domains are declared (e.g., https://mywebsite.com), the widget will verify the hosting URL before opening connection channels. Requests originating from unregistered origins will fail validation.