Skip to main content
Customize the chat widget to match your brand and user experience requirements.

Visual Customization

Colors

Set the primary color using a hex code:

Position

Place the widget on the left or right:

Behavior Customization

Auto-Open

Automatically open the widget after a delay:

JavaScript API

Control the widget programmatically using the global Chatoura object.

Opening and Closing

Sending Messages

Event Listeners

Setting User Data

Pre-fill user information:

Custom Triggers

Open the widget from custom elements:
Or with event listeners:

Conditional Loading

Load the widget based on conditions:

Hiding the Default Button

If you want to use only custom triggers:
Then trigger with your own button:

Mobile Considerations

Full-Screen Mode

On mobile devices, the widget can open full-screen:

Responsive Triggers

Advanced Configuration

Multiple Agents

Load different agents on different pages:

Passing Context

Send page context with messages:

Testing Customizations

  1. Make changes to your embed code
  2. Clear browser cache or use incognito mode
  3. Verify changes on your site
  4. Test on multiple devices and browsers
  5. Check that all custom triggers work

Troubleshooting

  • Ensure script has finished loading
  • Use window.Chatoura after load event
  • Check for JavaScript errors in console
  • Verify hex color format is correct
  • Clear browser cache
  • Check for CSS conflicts (rare with Shadow DOM)
  • Verify event names are correct
  • Ensure listeners are added after script loads
  • Check for duplicate event listeners