Widget Tools | Yaplet

Overview

Through Copilot or a connected AI app, an AI can read and change your chat widgets: their settings, their look, the Home screen, which AI agent and help center the brand uses, and the install code. It looks the actions below up with find_actions and runs each one with the run tool for its kind — see MCP Server. In Copilot, every change waits for your Confirm first.

Permission required:Brands — shown as Brands & chat widgets in the permission list. An app connected by browser login also needs the Brands area (copilot:widgets) ticked on the login screen.

Actions

Action	Level	What it does
`widgets.get`	Read	Reads one widget's settings: colors, launcher, Home background and layout, behavior, menus, and the Home screen's greeting, cards and quick buttons with their ids.
`widgets.install_code`	Read	Gives the script snippet that installs the widget on a website.
`widgets.create`	Change	Creates a new widget with default settings, together with a new, empty brand to hold it.
`widgets.update_settings`	Change	Changes the widget's name, its brand's language, its behavior (reply time, asking for an email, ratings, showing the team, start screen, browser language, language selector, docs link) and which menu tabs show.
`widgets.update_design`	Change	Changes the colors, the Home background, the card finish, the corners and the launcher.
`widgets.update_home_texts`	Change	Changes the Home screen's greeting and the line under it, in the brand's own language.
`widgets.set_home_cards`	Change	Replaces the Home screen's cards with a new list.
`widgets.set_quick_buttons`	Change	Replaces the quick buttons under the AI box with a new list.
`widgets.set_ai_agent`	Change	Makes one of your AI agents the agent of the widget's brand, or releases the brand's agent without deleting it.
`widgets.set_public_help`	Change	Publishes a knowledge base or documentation set as the brand's public help center or docs, or takes it off. Nothing is deleted.
`widgets.set_roadmap_board`	Change	Chooses the board the widget shows as its roadmap, or takes it off.

How the Widget Actions Work

Creating a widget

widgets.create takes no details. It creates a widget called "New widget", in English, with default settings, and a new brand to hold it. That brand starts empty: it does not get your existing knowledge base, documentation or roadmap, and it has no public address until you set one.
The AI then sets the new widget's name, language and look with the change actions. In Copilot that means several Confirm cards in a row; Confirm all confirms them together.
To restyle a widget you already have, the AI changes that widget instead of creating one.

Only what you ask for changes

Every change action writes only the settings it is given; everything else stays as it is. Hiding one menu tab leaves the others alone, and changing one color keeps the rest of the design.

Colors and the Home background

The colors come from four choices: the widget's background, one to three brand colors, what is painted behind the greeting (nothing, a light tint, a solid block or a gradient) and how the brand color is painted on buttons (flat or a gradient). Every other color is calculated from these and checked for readability.
The Home background is a stack of layers — that backdrop, an uploaded photo, soft glow shapes and thin lines — and every combination is valid. The photo itself is uploaded in the dashboard.
The launcher (the button on your website that opens the chat) has its own shape and follows your brand colors until you give it colors of its own.

Home texts, cards and quick buttons

The greeting, the line under it, card texts and button texts are written in the brand's own language. A text you write exists in that one language, while Yaplet's built-in greeting is said in every visitor's language. Until you translate your texts on the widget's Languages tab (Translate all languages, free), visitors reading another language see your text as written. The AI tells you this after every text change.
An empty text brings back Yaplet's built-in text.
The AI is told to change the greeting and the line under it only when you ask for new Home texts.
Cards and quick buttons are always sent as a whole list. The AI reads the widget with widgets.get first: a card or button that keeps its id keeps its texts in every language, a new one is added, and one left out is removed.
A quick button can send a sentence, open a link, a form, an article, a news post or the documentation, or start a workflow — which must be a switched-on workflow of this widget's brand.
The same plan limits apply as in the dashboard: forms need Tickets, articles the Knowledge base, documentation Documentation, news News and workflows Workflows.
The AI box and the open-conversation card at the top of Home are always there and are not part of the list.

Language and reply time

The language set with widgets.update_settings is the brand's language — the same setting as Brand settings → General. It also decides how knowledge is searched and which language the AI writes in. A visitor who picks a language in the widget keeps their pick.
The reply time is picked from the same eleven options as in the dashboard, from "a few minutes" to "a few days", so every visitor reads it in their own language.

AI agent and public help

A brand has at most one AI agent, and it answers on that brand's widget automatically, so widgets.set_ai_agent is rarely needed. Only an AI agent can be chosen, never a workflow. Releasing the agent keeps the agent and its settings, but the brand no longer has an AI agent.
widgets.set_public_help writes the brand's own choice, the same one made on Brand → Knowledge. The knowledge base or documentation set it publishes is the one served at the brand's public address, and the previous one comes off that address. Nothing it has learned is deleted, so publishing it again later is instant and free. If the AI mentions refreshing training data afterwards, there is nothing to refresh.

What an AI Cannot Do Here

Delete a widget or a brand. Delete a widget at the bottom of the widget designer's Features tab, and a brand under Brand settings → Danger zone.
Add a widget to a brand you already have. Creating a widget always creates a new brand. A brand without a widget gets one on its Chat widget page with Add a chat widget.
Create and style a widget in one step. Creating now takes no details; the AI sets the name, language and look with separate change actions right after.
Upload pictures. The logo, the bot avatar and the Home photo are uploaded on the widget's Design tab.
Write texts in other languages. The AI writes the brand's own language only; translate the rest on the widget's Languages tab.
Reword Yaplet's own texts. The rating question, the tab names and the "let me connect you to an agent" line are said in each visitor's language. There is nothing to set for them, here or anywhere else.
Show or rotate the widget's identity-verification secret. That lives on the widget's Install tab.

Example Prompts

"What does my widget look like right now, and which quick buttons does it have?"
"Give my widget a #1A1A2E background with #E94560 as the brand color and a gradient behind the greeting."
"Hide the news and roadmap tabs and set the reply time to 10–20 minutes."
"Keep my first two quick buttons, drop the rest, and add one that opens our returns form."
"Give me the install code for my widget."