Skip to content
Yamidoo

Widget & AI settings

A project’s Settings page controls both how the widget looks and how the assistant answers. Changes apply to the live widget without touching your site’s code.

A project's Settings page with the widget appearance and AI behavior sections

General

Section titled “General”
  • Project name and Domain — how the project is labeled in the dashboard and which site it belongs to.
  • Email notifications — the address that receives handoff and leave-a-message emails. Defaults to the workspace owner.
  • Blocked countries — countries where the widget won’t load. A visitor’s country comes from their IP address (IP Geolocation by DB-IP).
  • Live monitor → Mark a visitor idle after — minutes of inactivity (default 10) before the Live view labels a visitor as idle. This only changes the label in the Live view; visitors never see a notice.
  • Delete project — removes the project and its data.

Widget

Section titled “Widget”
  • Title — the widget’s panel header text.
  • Color — your brand/accent color.
  • Position — where the launcher sits.
  • Welcome message — the first thing visitors see when they open the widget.
  • Launcher button — the icon (13 options), an optional label, and whether to show the label.
  • Avatar — your brand or agent image, shown in the header and beside human replies.
  • AI avatar — the assistant’s glyph: orb, sparkle, bot, or twinkle.
  • Suggested questions — starter questions visitors can click; add, remove, and reorder them. Three are shown per visit, in your order; with more than three, a random selection rotates.
  • Floating messages — short bubbles shown near the launcher before the chat opens. A click either sends the text as the visitor’s message or puts it in the message box to edit (When clicked).
  • Contact capture — collect name and email, and choose when to ask (before the first message, before talking to a human, or as an optional prompt).
  • Satisfaction ratings — thumbs-up/down on each AI answer.
  • Conversation rating — off, 5 stars, or 5 emojis at the end of a chat. Ask chooses when: after an agent closes the chat (default), or after every chat ends, including AI-only chats the visitor ends themselves.
  • Ask “Did that answer your question?” — on by default. When a visitor goes quiet for two minutes after an AI answer, the widget offers Yes, thanks (ends the chat, then shows the rating if it’s on) and I still need help. Asked once per chat, never while a team member is in it.
  • Close idle chats after — default 30 minutes without a message (0 = never). The chat is closed with a note to the visitor, which keeps Live and the inbox tidy. Chats waiting for your team’s reply are never closed automatically. The visitor sees “Your chat has ended” with a Start a new chat button.
  • Email transcript — let visitors email themselves the conversation.
  • Hide “Powered by Yamidoo” — Pro plan.

These map to the options covered in Customizing the widget.

Human handoff

Section titled “Human handoff”
  • Allow human handoff — let visitors ask to talk to a human.
  • Require agent online — only offer handoff when at least one teammate is available; otherwise the “Talk to a human” action is hidden. With this off, it’s relabeled Leave a message when nobody is online.
  • AI handoff — let the assistant escalate on its own when it judges a person is needed. On by default.

AI behavior

Section titled “AI behavior”

Shape how the assistant responds:

  • Presets — ready-made instruction sets to start from: Support agent, Sales agent, Knowledge assistant, or Concise.
  • Bot name — what the assistant calls itself.
  • Response language — Auto replies in the visitor’s language, or pick a fixed language.
  • Category — general, e-commerce, SaaS, blog, docs, or other. Grounds the model in what kind of site it’s answering for.
  • What is this website about? — a short description (up to 2,000 characters) the assistant uses as context.
  • System instructions — your own rules, e.g. “be concise” or “always link to the docs.”
  • Read the page the visitor is on — on by default. The assistant sees the text of the page the chat was opened on (or the recipe on it), so it can answer questions about “this product” or “step 3”. When off, it only knows the page’s address and title.
  • Never read these pages — optional paths to skip, one per line, with * as a wildcard (e.g. /members/*). For private areas with their own URLs.