> For the complete documentation index, see [llms.txt](https://alhena.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alhena.gitbook.io/docs/developer-reference/website-sdk/examples.md).

# Code Examples

This section contains ready-to-use code examples for common Alhena chat widget integration scenarios. Each example includes complete, working code that you can adapt for your website.

## Available Examples

| Example                                                                                                        | Description                                           | Use Case                                       |
| -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------- |
| [A/B Test Guidelines](/docs/developer-reference/website-sdk/examples/ab-test-guidelines.md)                    | Customize AI responses based on A/B test groups       | Personalize answers for test vs control users  |
| [Auto-Close After Handoff](/docs/developer-reference/website-sdk/examples/auto-close-after-handoff.md)         | Automatically close the widget after human transfer   | Clean up UI after support handoff              |
| [Human Handoff Widget](/docs/developer-reference/website-sdk/examples/human-handoff-widget.md)                 | Switch to another support tool on human transfer      | Use Freshworks, Zendesk, etc. for human agents |
| [Internationalization](/docs/developer-reference/website-sdk/examples/internationalization.md)                 | Configure widget language and locale                  | Multi-language websites                        |
| [Scroll-Triggered Widget](/docs/developer-reference/website-sdk/examples/scroll-triggered-widget.md)           | Show widget only after user scrolls                   | Reduce initial page load distraction           |
| [Custom Launcher & Nudge UI](/docs/developer-reference/website-sdk/examples/custom-launcher-nudge.md)          | Replace the built-in launcher and nudge with your own | Match chat entry points to your design system  |
| [Price Conversion](/docs/developer-reference/website-sdk/examples/price-conversion.md)                         | Customize how product prices are displayed            | Currency conversion, variant-aware pricing     |
| [WooCommerce Revenue Tracking](/docs/developer-reference/website-sdk/examples/woocommerce-revenue-tracking.md) | Track cart and checkout events in WooCommerce         | E-commerce revenue attribution                 |

***

## Quick Start Template

All examples build on this basic setup:

```html
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Your Page</title>
  </head>
  <body>
    <!-- Your page content -->

    <!-- Alhena SDK -->
    <script>
      document.gleenConfig = {
        company: "your-company-key",
        apiBaseUrl: "https://app.alhena.ai",
      };
    </script>
    <script src="https://app.alhena.ai/sdk/gleenWidget.js"></script>

    <!-- Your custom integration code -->
    <script>
      // Event handlers and customizations go here
    </script>
  </body>
</html>
```

***

## Example Categories

### Widget Control

Learn how to programmatically control the chat widget:

* [**Scroll-Triggered Widget**](/docs/developer-reference/website-sdk/examples/scroll-triggered-widget.md) - Delay widget display until user engagement
* [**Custom Launcher & Nudge UI**](/docs/developer-reference/website-sdk/examples/custom-launcher-nudge.md) - Build your own launcher and nudge driven by the standard nudge logic
* Open/close based on user actions
* Toggle widget from custom buttons

### Human Agent Handoff

Handle transitions from AI to human support:

* [**Auto-Close After Handoff**](/docs/developer-reference/website-sdk/examples/auto-close-after-handoff.md) - Clean up after support transfer
* [**Human Handoff Widget**](/docs/developer-reference/website-sdk/examples/human-handoff-widget.md) - Integrate with external helpdesks

### Localization & Personalization

Support multiple languages and personalized experiences:

* [**A/B Test Guidelines**](/docs/developer-reference/website-sdk/examples/ab-test-guidelines.md) - Customize AI responses for test vs control groups
* [**Internationalization**](/docs/developer-reference/website-sdk/examples/internationalization.md) - Configure UI language

### E-commerce

Customize product display and track revenue:

* [**Price Conversion**](/docs/developer-reference/website-sdk/examples/price-conversion.md) - Format prices with currency conversion or variant-aware pricing
* [**WooCommerce Revenue Tracking**](/docs/developer-reference/website-sdk/examples/woocommerce-revenue-tracking.md) - Implement cart and checkout tracking

***

## Need More Examples?

Check these related documentation pages:

* [JavaScript API](/docs/developer-reference/website-sdk/javascript-api.md) - Complete method reference with examples
* [Events](/docs/developer-reference/website-sdk/events.md) - Event handling examples
* [Styles API](/docs/developer-reference/website-sdk/styles-api.md) - Visual customization examples
* [Custom Data](/docs/developer-reference/website-sdk/custom-data.md) - User personalization examples
* [A/B Testing](/docs/developer-reference/website-sdk/ab-testing.md) - Experiment setup examples
