Widget Tools
What an AI can do with your chat widgets through Yaplet or a connected AI app — read a widget and its install code, create a widget, change its settings, design, Home texts, cards and quick buttons, choose its brand's AI agent, public help and roadmap board, and read or set the hours its team is usually online.
Overview
Through Yaplet, the assistant inside your dashboard, 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, the hours its team is usually online, 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 Yaplet, every change waits for your Confirm first.
widgets.set_public_help needs Knowledgebase (help center) or Documentation (docs), and widgets.set_ai_agent needs AI agent.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.get_install_guide | Read | Gives the steps and the exact code for one platform (WordPress, Shopify, Wix, Squarespace, Webflow, UNAS, Shoprenter, Google Tag Manager or any other website), and whether the widget has already loaded on a live website. Without a platform it uses the one recognized on the brand's website, otherwise any other website. The answer also holds a link to send your developer and your chat link. |
widgets.create | Change | Creates a new widget with the name and language you give it and default settings, together with a new, empty brand of the same name to hold it. |
widgets.update_settings | Change | Changes the widget's name, its brand's language, its behavior (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. |
brands.get_team_hours | Read | Reads when a brand's human agents are usually online — one brand, or every brand you can reach, each with its name and a plain-language summary. |
brands.set_team_hours | Change | Replaces a brand's whole weekly team hours, or clears them. |
How the Widget Actions Work
Creating a widget
widgets.createtakes the widget's name (the website or business it is for) and, optionally, its language (English when left out). It creates the widget with that name and language and default settings, and a new brand of the same name 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 look and Home screen with the change actions. In Yaplet 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.
- The launcher's icon has three choices: a message bubble, an AI icon or the Mascot. With the Mascot, the animated Yaplet mascot is itself the button, with no bubble, ring or shape around it; the shape and ring settings are kept but not drawn while it is picked. New widgets start with the Mascot, and existing widgets keep the button they have.
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, which uses AI credits), 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 changes 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.getfirst: 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
- The language set with
widgets.update_settingsis 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.
Team hours
- The team hours are the same ones as Brand settings → Team hours: when the brand's human agents are usually online — not your opening hours, which belong in the knowledge. With them set, Yaplet tells visitors when they can reach a person, and when nobody is available the website chat's "Leave a message" card (or the "all our agents are offline" message on Messenger and Instagram) says when the team is usually back; with none set, nothing mentions hours.
brands.set_team_hoursreplaces the whole weekly table: a time zone (for exampleEurope/Budapest) and, for every day someone is online, one from–to range such as 09:00–17:00. A day left out means nobody is online that day;24:00means until midnight, and a day's range cannot run past it. Giving none clears the hours. A time that is not on the 24-hour clock, an end that is not later than the start, or an unknown time zone is refused. The AI reads the current hours withbrands.get_team_hoursfirst when it only changes part of them.- A team member who can reach only some brands can read and change only those brands' hours.
- Details of what the hours do: Brand settings.
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_agentis 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_helpwrites 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. Only a knowledge base or documentation set that already belongs to this brand can be published; one of another brand is refused — move it to this brand on Brand → Knowledge first.
What an AI Cannot Do Here
- Delete a widget or a brand. Delete a widget under Danger zone on the widget designer's General tab (ticking Also delete the whole brand there deletes the brand too), 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 takes only the name and language; the AI sets the look and Home screen with separate change actions right after.
- Upload pictures. The logo, the Widget icon (shown to your team only; visitors always see Yaplet) and the Home photo are uploaded on the widget's Style 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 "A team member will join this chat." 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 ask visitors to rate their conversations."
- "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."
- "Walk me through installing my widget on Shopify, and give me a link I can send to my developer."
- "Our team answers chats Monday to Friday 9:00–17:00, Budapest time. Set that as the team hours."