All channels types can be made into a widget, toggle on Enable Wigets
in the channel setting page.After configuring the appearance of the widget, copy the codes provided at the bottom for each widget types.A read-only
display of all the messages of the channel, with a optional CTA button
to be included.Simple set up: Include the iframe code anywhere on your platform!
<iframe
src="https://prod-widgets.returning.ai/channel- widget/NjUwN2M4NjFkJkYTYxNTAzYkY2U5/open-widget"
id="returningAiWidgetIframe"
frameborder="0"
width="100%"
height="100%">
</iframe>
No Authentication: All users who visits your site will be able to see the widget.
CTA button can be linked to any URL: default URL links users to the server.CTA button appears at the bottom right of the page.
Button content and URL can be set up in the settings.
Embed the whole chat room onto your site, users will be able to view and send messages via the widget!Requires more development effort:
1.
Collection and saviong of each user's token
fetch('https://prod-widgets.returning.ai/channel- widget/NjUwN2M4NjFkJkYTYxNTAzYkY2U5/signin',
{
method: 'POST',
headers: {
'returningai-api-key': 'df09a52de262f1f802950815864',
'email': '{email}',
'Content-Type': 'application/json',
}
}).then((res) => {
res.json().then(data => {
localStorage.setItem('returning-ai-widget-token', data.token)
})
}).catch((err) => {
console.log(err)
})
2.
Add Event listerner
to get the token
<script>
window.addEventListener('message', (event) => {
if (event.origin === 'https://prod-widgets.returning.ai') { // Check origin for security
const { type } = event.data;
if (type === 'RETURNINGAI_WIDGET_TOKEN') {
const value = localStorage.getItem('returning-ai-widget-token');
// Send the value back to the parent window
event.source.postMessage({ type: 'RETURNINGAI_WIDGET_TOKEN', value
}, event.origin);
}
}
});
</script>
3.
Add the iframe
into the site's code
<iframe src="prod-widgets.returning.ai/channel- widget/NjUwN2M4NjFkJkYTYxNTAzYkY2U5" allow="clipboard-write" id="returningAiWidgetIframe" frameborder="0" width="100%" height="100%"></iframe>
Modified at 2025-09-09 03:57:36