Website widget

Put an agent on any website with one script tag, a publishable pk-so- key and a list of allowed websites.

1. 01Install the widget on your websiteCopy the embed code from the agent's Deploy tab, add your website to Allowed websites, and paste the tag before </body>.Guide2 min
2. 02Widget options: every data- attributeThe script tag's attributes: widget key, agent id, style, colour, bot name and welcome message, with defaults and limits.Reference1 min
3. 03Allowed websitesLimit a widget key to your own domains: exact hosts, www, wildcard subdomains, ports, localhost and how matching works.Reference1 min
4. 04Publishable widget keys (pk-so-)What a pk-so- key can and can't do, how it differs from your secret key, its rate limits, and how to rotate it.Concept1 min
5. 05Install the widget on WordPress, Shopify, Webflow, Next.js and moreWhere to paste the embed code on popular site builders and frameworks, and how to load it in a Next.js or React app.Guide1 min
6. 06Update an old embed (data-api-key)Embeds from before widget.js 1.8 used a secret key and no longer load. Replace the tag and protect your secret key.Troubleshooting1 min