> For the complete documentation index, see [llms.txt](https://docs.webtonative.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.webtonative.com/website-plugins/wordpress/push-notification-woocommerce.md).

# Push notification Guide (WooCommerce)

## 1. Admin Setup

### Step 1:  Enable Push Notifications

1. Navigate to **WebToNative Settings > Push** Notification in the WordPress admin dashboard.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeNj9Z7r73RTopJWP61-rWU1L-37ree5NjSzb4B_DeiYafi0C8cTJrH3QIM-QzdseVWVtrrCpcWIRbRMlNCJyZU9drBPX5dix1u4JMmzJcK2jHbOcHBVdxX45qSuTcsizIYJyIebQ?key=8fypB0WwX012kuShdOKyH1VA" alt="" width="375"><figcaption></figcaption></figure>

2. Enable the **"Enable Push Notification"** checkbox to activate push notifications

### Step 2:  Configure OneSignal Settings

1. Fill in the required fields:
   * **OneSignal App ID**: Enter your OneSignal application ID.
   * **REST API Key**: Enter the REST API key for your OneSignal account.

<figure><img src="/files/VTwfB5UKUisPwh3osBkh" alt=""><figcaption></figcaption></figure>

### Step 3:  Customize Order Status Messages

1. In the Customize Messages section:
   * Provide a **custom message** for each WooCommerce order status (e.g., "Processing," "Completed").
   * These messages will be sent to users as notifications when their order status changes.

### Step 4:  Save Settings

* Click Save Changes to apply the configuration.

## 2. Automatic Notifications for WooCommerce

* Push notifications are automatically triggered when a WooCommerce order status changes.
* The system:
  * Fetches the order details and user information.
  * Hashes the user ID with a secret key to generate an *<mark style="color:green;">**externalUserId**</mark>*.
  * Sends the custom message for the new order status via the OneSignal API.

## 3. Key Features

1. **Dynamic External User ID**: Ensures secure identification of users via hashed <mark style="color:green;">externalUserId</mark>.
2. **Customizable Notifications**: Allows custom messages for different WooCommerce order statuses.
3. **Automatic WooCommerce Event Handling**: Triggers notifications on order status changes.

## 4. Troubleshooting

* Notifications Not Sending?
  * Ensure push notifications are enabled in the settings.
  * Verify the OneSignal App ID and REST API Key.
  * Check that the wton\_notification\_key is properly set.
* Frontend Integration Issues?
  * Confirm the WTN.OneSignal object is available in the app environment.
  * Check the browser console for errors related to the script.