Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.poly.ai/llms.txt

Use this file to discover all available pages before exploring further.

Use webchat to deploy your agent on your website alongside voice. Webchat lets customers interact with the same agent logic through text, with channel-specific styling, safety filters, and widget configuration. Configure the chat experience from Channels > Chat in the sidebar.

​
Chat channel pages

Chat configuration

Configure LLM, style prompt, greeting, and safety filters

Widget

Create, style, and deploy widgets to your website
To embed the webchat widget on your website, see the widget deployment guide. This requires adding a code snippet to your site.

​
Getting started

Setting up webchat involves two main steps:
1

Configure chat settings

Go to Channels > Chat > Chat Configuration to:
  • Select your language model
  • Add an optional style prompt for chat-specific tone
  • Set your greeting message
  • Configure safety filters
2

Create and deploy a widget

Go to Channels > Chat > Widget to:
  • Create a new widget for your website
  • Style the appearance (header, colors, agent avatar)
  • Configure disclaimers and consent
  • Generate and embed the script tag

​
Key features

​
LLM and style control

Select the language model powering chat responses – PolyAI’s Raven 3.5 is recommended for chat, delivering natural paraphrasing and strong grounding. Optionally add a style prompt to tailor tone and formatting specifically for the chat channel.

​
Multiple widgets

Create separate widgets for different websites, variants, or environments. Each widget can have unique styling and configuration.

​
Safety filters

Configure channel-specific content filtering with adjustable strictness levels for violence, hate, sexual content, and self-harm categories.

​
Markdown support

Chat messages support formatted markdown including bold, italics, lists, links, and code blocks. See chat configuration for details.

​
Variant support

Select which variant each widget connects to for location-specific or configuration-specific chat experiences.

​
Environment alignment

Chat configuration changes take effect immediately when saved. Unlike other project settings, webchat does not follow the environment branching system – there is no Sandbox, Pre-release, or Live promotion step. Use the Test Agent Chat panel to verify changes before saving.

Chat configuration

Configure LLM, greeting, and safety filters

Widget

Create and deploy chat widgets

Widget installation

Embed the widget on your website

Variant management

Configure multi-site setups
Last modified on April 20, 2026