# 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           |
| [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
* 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://alhena.gitbook.io/docs/developer-reference/website-sdk/examples.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
