پایگاه دانش GetMyBot

Widget quickstart

Add chat to your website: choose its layout, prepare replies, install the code and send a first message.

در این صفحه

After this setup, visitors will see a chat button on your site and be able to ask a question. You will receive their messages in the dashboard. To start, a greeting and one working answer, such as a reply about price, are enough. You can add more features later.

Before you start

You need access to the widget settings and the ability to add code to your site, either yourself or through the site administrator. Prepare the site address beginning with https://. If someone else installs the code, send them the snippet from the dashboard. For development on your own computer, HTTP is allowed, for example on localhost.

1. Choose a preset

Open Widget and choose Online school or Internet store. These are presets: starting settings you can change later. If your chat is already configured, review which values will be replaced before applying a preset.

2. Customize the conversation

Set your brand, greeting, quick actions, pre-chat form, working hours and offline message. Select a reaction for each quick-action button: clicking it sends the configured text to the conversation and runs that specific reaction. Contact fields enrich the current visitor profile, but email and phone remain unverified.

3. Add your website

In Allowed sites, add the address without a page path, for example https://example.com. This is called an origin. https://www.example.com and https://shop.example.com count as separate sites; add them if the chat should appear there too. Copy the code from Install and add it once to the site's shared page template. See Site widget for details.

4. Preview important states

Preview the chat button, the short invitation beside it (teaser), greeting, contact form and conversation. Check desktop and mobile against light and dark backgrounds. Look at the message outside working hours separately: it should tell visitors when to expect a reply.

5. Save and install

Save the settings and allowed-site list, then publish the copied code. If a developer installs it, ask them to keep the lines in order: the widget key must be set before the loader script. Add the snippet to each page only once.

6. Run automatic diagnostics

Select an allowed site, enter a page address and click Check installation. The check looks for the code on the page and tries to open the widget in a browser. Only the widget-ready status confirms success. If it times out, open the details: that error alone does not identify the cause. Possible loading restrictions, including the browser's CSP policy, are covered in Site widget.

7. Test the full conversation

Use a private browser window and act like a visitor. Try a quick action, submit or skip the form as configured, send a message and verify the corresponding reaction. Also test outside working hours and make sure the offline copy promises a response rather than live operator presence.

If the 15-minute setup takes longer

If the button does not appear, check the address in Allowed sites, the published code and browser blockers. If the chat opens but the bot does not respond to quick actions, check that every button links to a working reaction. For technical loading issues, see Site widget. Send support the page address and installation-check result.

What's next