Embeddable Widget

Add a floating support button to your website so customers can submit tickets without leaving your site.

The embeddable widget adds a floating chat-style button to any website. When clicked, it opens a ticket submission form — customers can submit a support request without leaving your site.

Go to Support > Settings > Widget
Copy the embed code shown on the page
Paste it into your website before the closing </body> tag

The embed code looks like this:

<script src="https://app.workestra.com/api/widget/support?workspace_id=YOUR_WORKSPACE_ID" async></script>

That's it — one line of code. The widget loads asynchronously and won't slow down your website.

What Customers See

The Button

A blue floating button appears in the bottom-right corner of your website. It displays a chat icon and has a subtle hover animation.

The Form

Clicking the button opens a compact panel with:

Field	Required	Description
Name	Yes	Customer's name
Email	Yes	Email address for replies and tracking
Subject	Yes	Brief summary of the issue
Description	No	Detailed information
Type	No	Support Request, Bug Report, or Feature Request

After Submission

The form shows a success message with the ticket reference number (e.g. TKT-0042). The customer can close the widget and continue browsing your site.

How It Works

Customer fills out the form on your website
The widget submits to Workestra's public ticket API
A ticket is created in your Support module with channel Portal
A CRM contact is created if the email doesn't already exist
Auto-assignment routes the ticket to an agent (if configured)
The customer receives a confirmation email with a tracking link

Customization

The widget uses a clean default design that works on most websites:

Blue accent color
Bottom-right corner positioning
Responsive — adapts to mobile screens
Light mode design

Custom colors, position, and branding options are planned for a future update.

Where to Embed

Common places to add the widget:

Marketing website — Let visitors ask pre-sales questions
Documentation site — Help readers get support when docs aren't enough
Web application — Give logged-in users a quick way to report issues
Landing pages — Capture feedback during campaigns

Rate Limiting

The widget uses the same rate limiting as the customer portal — 10 submissions per hour per IP address.

	Widget	Portal Link
Integration	Embedded on your site	Separate Workestra page
Setup	One line of code	Share a URL
User experience	Never leaves your site	Opens a new page
Ticket tracking	Confirmation only	Full tracking + reply
Best for	Quick submissions	Full support experience

For the best experience, use both — the widget for quick submissions from your site, and the portal link for customers who need to track or reply to tickets.

Next Steps

Customer Portal — Full portal with tracking and replies
Tickets — Manage tickets from the widget
Auto-Assignment — Route widget tickets to agents

Setting Up the Widget