JavaScript API

When is it available?

window.AskMerra exists as soon as the widget script has executed. Calls made before the widget finished loading are queued and run in order. The script loads async, so to be safe hook in from onReady:

<script>
  window.AskMerraSettings = {
    onReady: function () {
      AskMerra.on('add_to_cart', addToMyCart);
    },
  };
</script>
<script src="https://cdn.askmerra.com/v1/widget.js" data-site-key="pk_live_…" async></script>

Methods

// Your own "Ask an expert" button on product pages
document.querySelector('#ask-expert').addEventListener('click', () => {
  AskMerra.sendMessage('Is this product right for sensitive skin?');
});

// Follow your site's language switcher
languageSwitcher.onChange((lang) => AskMerra.setLocale(lang));

// Logged-in customer: pre-fill the contact form
AskMerra.identify({ email: customer.email, name: customer.firstName });

// Privacy page: let shoppers erase their chat data
document.querySelector('#delete-chat-data').addEventListener('click', async () => {
  await AskMerra.forget();
  alert('Your chat data was deleted.');
});

Events

Add to cart

Enable Add to cart in the widget behavior settings, then handle the event with your platform’s cart API. If no handler is registered, the button simply opens the product page.

AskMerra.on('add_to_cart', async ({ externalId }) => {
  // externalId = WooCommerce product id when your catalog comes from WooCommerce
  const body = new URLSearchParams({ product_id: externalId, quantity: '1' });
  await fetch('/?wc-ajax=add_to_cart', { method: 'POST', body });
  document.body.dispatchEvent(new Event('wc_fragment_refresh'));
});

AskMerra.on('add_to_cart', async ({ externalId }) => {
  // externalId = variant id when your catalog comes from Shopify
  await fetch('/cart/add.js', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ items: [{ id: Number(externalId), quantity: 1 }] }),
  });
});

Sales tracking

The dashboard shows the orders placed within 7 days after a chat (Sales through the assistant) and which lines the assistant suggested or added to cart. The widget reads the purchase on your order confirmation page and links it to the shopper’s chat:

• Only shoppers who chatted. The purchase is sent only if this browser has a chat id. Shoppers who never used the chat are never sent, and nothing is stored for them.
• Only with analytics consent. The widget follows Google Consent Mode (analytics_storage) from your cookie banner. Without a consent signal, nothing is sent.
• No personal data. Order number, amount, currency and products (id, name, price, quantity). Names, emails and addresses are never read.

The widget script must be on the confirmation page too. If your path rules hide the chat there (for example /checkout*), tracking still works. Turn it off under Widget → Behavior → Analytics & sales.

Google Analytics 4 already set up

Nothing to do. The widget reads the standard GA4 purchase event from the dataLayer (Google Tag Manager, gtag(), or the GA4 apps for Shopify, WooCommerce and Magento), and the older Universal Analytics enhanced ecommerce format.

No GA4: push the purchase yourself

<script>
  window.dataLayer = window.dataLayer || [];
  dataLayer.push({ ecommerce: null });
  dataLayer.push({
    event: 'purchase',
    ecommerce: {
      transaction_id: 'ORDER-1001',       // required, unique per order
      value: 64.90,                       // order total
      currency: 'EUR',
      items: [
        // item_id: the product id or SKU from your catalog import
        { item_id: 'SKU-123', item_name: 'Vitamin C serum', price: 29.90, quantity: 1 },
      ],
    },
  });
</script>

Or call AskMerra.trackPurchase() with the same object ({ transaction_id, value, currency, items }). Reloading the page doesn’t count an order twice. If your dataLayer has another name, set AskMerraSettings.dataLayer.

Consent

With Google Consent Mode, the widget sends the purchase as soon as analytics_storage is granted, even if the shopper accepts on the confirmation page itself. If your cookie banner doesn’t use Consent Mode, tell the widget yourself:

// When the shopper accepts analytics in your cookie banner
AskMerra.setConsent({ analytics: true });

// or before the widget loads
window.AskMerraSettings = { consent: { analytics: true } };

Google Tag Manager events

When your page has a dataLayer, the widget pushes these events into it (switch them off under Widget → Behavior → Analytics & sales). Your Tag Manager decides what to forward, under your own consent settings. The text of messages is never pushed.