Add askVela to WordPress

The askVela plugin embeds the widget automatically on every page of your shop – you only need to enter your widget key.

1. 1

   Install from the WordPress directory

   In the WordPress admin: Plugins → Add New, search for askVela and click Install Now.

2. 2

   Alternative: via ZIP

   Prefer manual? Download askvela-widget.zip (don't unzip) and go to Plugins → Add New → Upload Plugin.

3. 3

   Activate the plugin

   After installation, click Activate Plugin.

4. 4

   Connect with askVela

   Under askVela (left menu), click "Connect with askVela" and confirm in your askVela account – the widget key and (for WooCommerce) the order lookup are set up automatically. Alternatively, enter the widget key manually.

5. 5

   Done

   The chat widget appears instantly in your shop. If you use a caching plugin (WP Rocket, LiteSpeed, W3 Total Cache …), clear the cache once.

Works with any WordPress theme. Replace wk_dein_widget_key with your real key and add the snippet so it loads on every page:

<script>
  (function (w, d) {
    w.VelaConfig = {
      appUrl: "https://askvela.pro",
      widgetKey: "wk_dein_widget_key"
    };
    var s = d.createElement("script");
    s.src = w.VelaConfig.appUrl + "/widget.js";
    s.async = true;
    d.head.appendChild(s);
  })(window, document);
</script>

Once the plugin or snippet is active, the widget runs automatically on every page – including product pages, cart and checkout. With our plugin, two things are added automatically:

• Products – integrated: The one-click connection also sets up the product sync – askVela imports your catalog (name, description, attributes, price, stock) directly from WooCommerce. You start the import in the dashboard under Products. (Alternatively, Products → Scan reads the public shop URL.)
• Orders & customer data – integrated: From plugin version 1.1, the plugin provides a secure, HMAC-signed order lookup. This lets AI support find order status and customer data – without any code of your own.

Enable order lookup

The easiest way is via "Connect with askVela" (see Method 1) – the lookup is then set up automatically. To do it manually:

1. 1

   Get the values from the plugin

   In WordPress under askVela (left menu) you'll find the lookup URL and secret (both generated automatically).

2. 2

   Enter them in askVela

   In the askVela dashboard under Settings, paste them into "Your shop's lookup URL" and "Signature secret" and save.

3. 3

   Done

   When a customer asks about their order, askVela retrieves the data signed from your shop. For actions like cancellations (e.g. "cancel my order"), there's also the developer docs.

For Shopware there's (not yet) a 1-click plugin from us – but the setup works just as well with the snippet above. Two reliable ways:

• Checked the widget key? It must be copied exactly from the dashboard (no spaces).
• Clear the cache. Caching/optimization plugins (WP Rocket, LiteSpeed, Cloudflare) often still show the old page – clear the cache once.
• Embed only once. Running the plugin and the snippet at the same time leads to a duplicate widget – use only one method.
• Theme & ad blocker. Very rare themes don't call wp_footer; a browser ad blocker can also hide the widget.

You can adjust the widget's look, color and greeting anytime in the dashboard under Settings → Widget.