Channels

Support Widget

Overview

The support widget (also called the support bubble) lets customers start conversations directly from your website without needing to send an email. Messages submitted through the widget appear as tickets in your There There inbox, just like email.

Creating a widget channel

Go to your workspace settings, select "Channels", and create a new channel with the Widget type. Configure the following options:

  • Name: An internal label for the widget channel.
  • Position: Choose where the widget appears on your site (bottom right or bottom left).
  • Primary color: Set the accent color to match your brand.
  • Welcome message: The heading displayed when a visitor opens the widget.
  • Welcome subtext: Additional text shown below the welcome message.
  • Placeholder text: Hint text inside the message input field.

Embedding the widget

After creating the widget channel, you will receive a unique widget ID. Add the following script tag to your website, replacing the ID with your own:

<script src="https://therethere.app/widget/loader/your-widget-id.js" async></script>

Replace your-widget-id with your actual widget ID from the channel settings. Place this snippet before the closing </body> tag on every page where you want the widget to appear.

Domain restrictions

For security, you can restrict which domains are allowed to embed your widget. Add your allowed domains in the channel settings (e.g. yourcompany.com). Wildcard patterns like *.yourcompany.com are supported. If no domains are specified, the widget can be embedded on any site.

Identity verification

Enable the "Require identification" option to ensure that only authenticated users on your site can use the widget. When enabled, your application must provide a signed identity token using the widget's secret key.

How conversations are routed

Widget messages create tickets in the same way email messages do. They appear in your inbox, can be assigned to team members, tagged, and managed with workflows. Replies from your team are displayed to the visitor in real time through the widget.