Aura Historia Partner Connect

Description

Aura Historia Partner Connect connects a WooCommerce store to Aura Historia.

After you save the Shop ID and API key from Aura Historia, the plugin automatically:

  • creates and maintains exactly three WooCommerce product webhooks:
    • product.created
    • product.updated
    • product.deleted
  • keeps those managed webhooks in sync without creating duplicates
  • repairs plugin-owned webhooks after manual edits or deletion
  • generates and stores the WooCommerce webhook signing secret automatically
  • sends webhook deliveries to Aura Historia using the built-in endpoint pattern
  • pauses plugin-owned webhooks on deactivation
  • removes plugin-owned webhooks and plugin options on uninstall
  • can re-send the current catalog in the background after a successful connection

The plugin keeps the settings surface intentionally small. Merchants only enter:

  • Shop ID
  • API key

Merchants do not enter:

  • a webhook delivery URL
  • a webhook secret

This plugin is intended for merchants who already use Aura Historia. Once valid settings are saved, the plugin sends product data to Aura Historia so the connected catalog can stay in sync.

External services

This plugin connects to Aura Historia, a hosted service required for the plugin to work.

It sends data only after a merchant saves a valid Shop ID and API key, and later when WooCommerce sends managed webhook events or the plugin runs a product backfill.

The service is used to:

  • register the generated WooCommerce webhook secret and current store locale details
  • receive ongoing product webhook deliveries
  • receive background product backfill batches

Data sent to the service may include:

  • Shop ID
  • Aura Historia API key in the x-api-key header
  • generated WooCommerce webhook secret
  • store language and currency
  • product webhook payloads for product.created, product.updated, and product.deleted
  • existing product data during an automatic or manual backfill

Service endpoints:

  • PATCH https://api.aura-historia.com/api/v1/shops/{shopId}
  • POST https://api.aura-historia.com/api/v1/webhooks/woocommerce/{shopId}
  • PUT https://api.aura-historia.com/api/v1/shops/{shopId}/products

Service provider and policies:

Installation

  1. Install and activate WooCommerce.
  2. Install Aura Historia Partner Connect via the WordPress Plugin Directory.
  3. Activate the plugin.
  4. Go to WooCommerce > Aura Historia.
  5. Enter the Shop ID from Aura Historia for this store.
  6. Enter the API key from Aura Historia for this store.
  7. Save the settings.

After a successful save, the plugin syncs the managed webhooks automatically and starts sending product updates to Aura Historia.

FAQ

Do I need an Aura Historia account?

Yes. This plugin is intended for merchants who already use Aura Historia and have a Shop ID and API key for their store.

Which WooCommerce events are sent?

Only product.created, product.updated, and product.deleted.

What data is sent to Aura Historia?

After configuration, the plugin sends the generated WooCommerce webhook secret, store language and currency, product webhook payloads, and existing product data during backfill. See the External services section above for the full overview.

Can I change the delivery URL or webhook secret in wp-admin?

No. The plugin keeps the Aura Historia delivery URL built in and generates the WooCommerce webhook secret automatically.

What happens if I edit or delete one of the managed webhooks?

The plugin repairs plugin-owned webhooks during its sync flow so the required configuration is restored.

Does this plugin backfill existing products?

Yes. After a successful connection, the plugin can send the current catalog to Aura Historia in the background. Merchants can also manually restart that backfill from WooCommerce > Aura Historia.

What happens when the plugin is disabled?

Plugin-owned webhooks are paused on deactivation so WooCommerce stops sending deliveries.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Aura Historia Partner Connect” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

0.1.0

  • Initial release.