> ## 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.

# Connect Egentify to Your WooCommerce Store — No Coding

> Install the Egentify for WooCommerce plugin, connect your store with a secure OAuth flow, and deploy your AI support agent in minutes.

The Egentify WooCommerce plugin connects your store using a secure OAuth flow — so you never need to manually copy or paste API keys. Once connected, Egentify automatically provisions access to your store and deploys your AI support agent to 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

<Steps>
  <Step title="Open the WordPress plugin directory">
    In your WordPress admin, go to **Plugins > Add New Plugin**.
  </Step>

  <Step title="Search for the plugin">
    Type **Egentify for WooCommerce** in the search box and click **Install Now** when the plugin appears.
  </Step>

  <Step title="Activate the plugin">
    Once installation finishes, click **Activate plugin**. An **Egentify** item appears in your WordPress sidebar.
  </Step>
</Steps>

## Connect your store

<Steps>
  <Step title="Open the Egentify dashboard">
    In your WordPress sidebar, click **Egentify** to open the plugin dashboard.
  </Step>

  <Step title="Start the OAuth flow">
    Click **Connect to Egentify**. You'll be redirected to egentify.com to authorize the connection.
  </Step>

  <Step title="Sign in to Egentify">
    Sign in to your existing Egentify account or create a new one — it only takes a moment.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Widget settings

You can customize the look and behavior of the chat widget from **WP Admin > Egentify > Widget Settings** — no code changes required. The settings take effect immediately and do not require you to reconnect your store.

| Setting              | Options                             | Notes                                                                     |
| -------------------- | ----------------------------------- | ------------------------------------------------------------------------- |
| Primary color        | Hex value                           | Sets the widget's accent color to match your brand                        |
| Widget position      | `bottom-right` / `bottom-left`      | Where the widget launcher appears on screen                               |
| Offset X             | 0–200 px                            | Horizontal distance from the screen edge                                  |
| Offset Y             | 0–200 px                            | Vertical distance from the screen edge                                    |
| Window corner radius | 0–30 px                             | Controls the roundness of the chat window corners                         |
| Welcome text         | Up to 300 characters                | Displayed in the widget header; supports the `{{agent_name}}` placeholder |
| Starter buttons      | Up to 4 buttons, 40 characters each | Pre-filled prompts shown to customers before they type                    |
| Auto-inject          | On by default                       | Automatically adds the widget to every storefront page                    |

## Advanced: using a shortcode

If you prefer to place the chat widget on specific pages rather than every page, disable **Auto-inject** 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 the store from your Egentify project. Your Egentify project and its configuration are preserved — you can reconnect the same store 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.
</Note>