Admin

Users & Call Controls

Deployment Methods & System Requirements

Installation Guides

Home » Guides » Adding the Chat Widget Script to a Website

Adding the Chat Widget Script to a Website

Introduction

The RingQ Chat Widget enables real-time messaging between website visitors and your RingQ users, allowing conversations to be handled directly within the RingQ platform. By embedding the widget into your website, administrators can extend customer communication beyond voice while maintaining centralized control and visibility.

This guide explains how to generate, configure, and add the RingQ Chat Widget to your website, ensuring it is properly deployed and ready for use.

The Chat Widget Script

1. Use the below script exactly as given:

Summary Table

Part	Purpose
<script>	Loads external Javascript
chat-embed.php	Chat widget loader
color	Widget theme color
accesstoken	Authenticates widget
img	Chat icon/logo
fqdn	RingQ tenant domain
tokenized	Security & validation token

Customizing the Chat Widget Embed Script

Edit the color (color=)

Your current value:

color=%23e5ddd5 → this means #e5ddd5

To change it:

Pick a hex color (example #1e90ff)
Replace # with %23

Example:

Rule: always encode # as %23.

Edit the access token (accesstoken=)

Replace: accesstoken=7b1a1824-6dfa-417a-b485-73d83b307ef3 with the new token value you want to use.

Example:

accesstoken=NEW_ACCESS_TOKEN_HERE

Important:

The token must be a valid token generated by RingQ for that specific chat widget/config.
If you change the token, the existing tokenized= value may also need to match (depends on how RingQ validates).

Edit the image (img=)

Replace the img= value with a public image URL.

Example:

img=https://yourdomain.com/images/chat-logo.png

Tips:

Use HTTPS
Prefer PNG/SVG (if supported)
Keep it square (e.g., 128×128 / 256×256)

Make sure the image URL has no spaces. If it does, it must be URL-encoded (best is: don’t use spaces in filenames).

Edit the FQDN (fqdn=)

Replace: fqdn=multi.flowersconradplc.ringq.cloud with your target tenant domain, like:

fqdn=multi.yourcompany.ringq.cloud

Important:

fqdn should match the RingQ tenant you want the widget to connect to.
In most cases, the base domain in the script URL should also match that tenant (the https://…ringq.cloud/… part).

Critical note about tokenized=

In many implementations, tokenized is tied to the access token / fqdn / parameters for integrity.

So if you change any of these:

accesstoken
fqdn
sometimes even img / color

…your tokenized= might no longer be valid, and the widget can fail to load.

Best practice:

Generate a fresh embed script from RingQ after changes (or regenerate tokenized value using the platform’s embed generator).

Adding the Script to a Plain HTML Website

1. Open the main HTML file of your website (for example: index.html).

2. Add the script just before the closing </body>tag:

<body>

<!– Your website content –>

</body>

3. Refresh your website in the browser.

4. The chat widget should appear (usually at the bottom corner of the page).