Customize and install the Widget

The Widget adds your Chatbyte agent to an existing website or product. Customers can open the chat without leaving the page they are using.

Your agent supplies the answers and behavior. The Widget settings control how that conversation looks, how it welcomes visitors, and where it can appear.

Open the Widget settingsCopy Anchor Link

Open your agent, choose Publish, then Widget. The setup has four sections: Appearance, Content, Settings, and Code.

Match your brandCopy Anchor Link

In Appearance, configure:

• Display Name: the name shown at the top of the chat. If empty, Chatbyte uses the agent's name.
• Logo: the image shown in the Widget. Use PNG, JPG, GIF, or WebP, up to 5 MB.
• Primary Color: the color used for buttons, highlights, and interactive elements.
• Widget Position: choose the corner of your website where it appears.

Use the preview to check the combination, including a long display name and the contrast of your chosen color. Choose Save Settings to save your changes.

Welcome visitorsCopy Anchor Link

In Content, use Initial Messages to introduce the agent and explain what it can help with. Keep the welcome short and give visitors a useful starting point.

Suggestions provide questions customers can choose to start a conversation:

• Constant Suggestions are the questions you write yourself.
• Dynamic Suggestions generate suggestions from the current page's content and take precedence over constant suggestions when enabled.

For example, a delivery page could offer “Where is my order?” and “How long does delivery take?” Make sure the agent has the knowledge or tools to answer the questions you suggest.

Floating promptsCopy Anchor Link

Turn on Floating prompts to show selected initial messages above the closed chat bubble once per browser session. Mark the messages you want to show and set Prompt delay to control when they appear. A delay of 0 shows them immediately.

Turning floating prompts off keeps the initial messages available inside the opened chat. Save your changes when you finish.

Choose where it can appearCopy Anchor Link

In Settings, enable Only allow embedding on certain domains to restrict the Widget to the websites you list. Enter a domain such as example.com or app.example.com, without a path. Add the actual hostnames where customers will use the chat. Each domain also covers its www. form; list other subdomains separately. With the restriction on and no domains listed, the Widget loads on no website.

Set Privacy policy URL to your company's public privacy policy. The link appears in the consent note before the visitor's first message. If you leave it empty, Chatbyte uses its default policy.

Choose Save Settings after updating these settings.

Install on your websiteCopy Anchor Link

Open Code and copy the generated embed snippet for your agent. Give it to the person who manages your website, or add it using your site's custom-code feature. Publish the agent before testing it on the website.

The optional identity setup is useful when customers sign in to your product. It lets your application identify the current user securely. Your developer can follow the Widget integration guides.

Check the customer experienceCopy Anchor Link

Open the actual website and check that:

1. The Widget appears in the intended position and opens correctly.
2. Its name, logo, color, welcome messages, and suggestions look right.
3. A real question receives an appropriate answer.
4. The Widget loads on each domain you allowed.
5. If you enabled floating prompts, a fresh browser session shows the selected messages at the intended time.

If something is missing, start with Troubleshooting. For a standalone page instead of a chat bubble, use Pages.