Customizing the widget

The install snippet only carries your data-site-id. Everything about how the widget looks and behaves is configured in the dashboard — the widget fetches its settings at runtime, so you can change them without touching your site’s code.

Configured in the dashboard

Setting	Options
Accent color	Any hex color.
Title	Header / launcher text.
Welcome message	First message shown when the widget opens.
Position	bottom-right or bottom-left.
Avatar	Optional image shown in the header.
Suggested questions	A list of starter questions, with how many to show.
Contact capture	Ask visitors for name / email, and when to ask.
Ratings	Per-answer satisfaction and end-of-chat rating.
Human handoff	Turn handoff on/off.

See the Widget reference for the full list.

Controlling the widget from your site

Once loaded, the widget exposes a global yamidoo() function you can call to open, close, or drive it:

<script>
  yamidoo('open');            // open the chat
  yamidoo('close');           // close it
  yamidoo('ask', 'Do you offer refunds?'); // open and send a question
</script>

Open from your own button — no JavaScript

Add a data-yamidoo attribute to any element:

<button data-yamidoo="open">Chat with us</button>

Supported values are open, close, and toggle.

Identify a signed-in user

<script>
  yamidoo('identify', { name: 'Jane Doe', email: 'jane@example.com' });
</script>

Note

The full command list — including toggle, show, hide, reset, logout, and event listeners (on / once / off) — is in the Widget reference.