> ## Documentation Index
> Fetch the complete documentation index at: https://egentify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Install and Connect Egentify for WooCommerce

> Add an AI support agent to your WooCommerce store that answers product questions and tracks orders. Install the plugin, connect with one click, and go live in minutes.

Installing the Egentify plugin puts an AI support agent on your WooCommerce storefront that answers product questions, looks up orders, and handles returns and refunds. It reads your live products, pages, and policies on every conversation, so there is nothing to import or keep in sync.

The plugin connects through a secure OAuth flow, so you never copy or paste API keys. Once connected, Egentify provisions the access it needs and the chat widget goes live on your storefront.

## Requirements

Before installing, confirm your environment meets the following minimums:

* **PHP** 7.4 or higher
* **WordPress** 6.4 or higher
* **WooCommerce** 8.0 or higher
* An **Egentify account** (free to create at [egentify.com](https://egentify.com))

## Install the plugin

**1. Open the WordPress plugin directory**

In your WordPress admin, go to **Plugins > Add Plugin**.

**2. Search for the plugin**

Search for **Egentify**. The plugin is listed as **AI Chatbot & Helpdesk Agent for WooCommerce by Egentify**. Click **Install Now**.

**3. Activate the plugin**

Once installation finishes, click **Activate plugin**. An **Egentify** item appears in your WordPress sidebar.

## Connect your store

**1. Open the Egentify dashboard**

In your WordPress sidebar, click **Egentify** to open the plugin dashboard.

**2. Start the OAuth flow**

Click **Connect to Egentify**. You'll be redirected to egentify.com to authorize the connection.

**3. Sign in to Egentify**

Sign in to your existing Egentify account or create a new one. It only takes a moment.

**4. Confirm the connection**

Review the permissions and click **Authorize**. You'll be redirected back to your WordPress admin. Egentify automatically provisions the access it needs and the chat widget is now live on your storefront.

## Widget settings

Open **Egentify** in your WordPress sidebar and scroll to the **Widget Settings** section. No code changes required, and the settings take effect immediately without reconnecting your store.

| Setting | Options | Notes |
| - | - | - |
| **Primary Color** | Hex value | The widget's accent color |
| **Widget Position** | Bottom right / Bottom left | Where the launcher appears on desktop. Mobile is always full screen |
| **Side Offset (px)** | 0–200 | Distance from the left or right edge |
| **Bottom Offset (px)** | 0–200 | Distance from the bottom edge |
| **Chat Window Radius (px)** | 0–30 | Corner rounding on the chat window. The launcher stays circular |
| **Welcome Message** | Up to 300 characters | Shown when a customer first opens the chat. Supports the `{{agent_name}}` placeholder |
| **Starter Buttons** | Up to 4, 40 characters each | Quick replies shown when a customer first opens an empty chat. Leave all four blank to use the defaults |
| **Auto Inject Widget** | On by default | Renders the widget automatically in your theme footer |

## Advanced: using a shortcode

If you prefer to place the chat widget on specific pages rather than every page, turn off **Auto Inject Widget** in Widget Settings and use the `[egentify_chat_widget]` shortcode instead:

```text theme={null}
[egentify_chat_widget]
```

Paste this shortcode into the content of any page or post in the WordPress editor. The widget renders only on pages where the shortcode is present, giving you full control over its placement.

## Disconnecting

To unlink your store, go to **WP Admin > Egentify** and click **Disconnect**. This immediately revokes the WooCommerce REST API key, removes the chat widget from your storefront, and unlinks it from Egentify. Your Egentify store and its configuration are preserved, so you can reconnect the same storefront at any time.

> [!NOTE]
>
> The plugin sends a weekly heartbeat to Egentify to confirm the connection is healthy. If Egentify reports that the connection is no longer valid, the plugin automatically disconnects and you will need to reconnect your store.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.