Shopify

Visitors talk to your agent from a button on every page of your store. You need a published agent and its Embed code from Agent → Deploy → Website widget.

Add the widget to your theme

1. In Shopify admin, open Online Store → Themes.
2. On your current theme, click ⋯ → Edit code.
3. Open layout/theme.liquid and paste the embed code just before </body>:

<script src="https://evasay.com/voice-widget.js" data-agent="AGENT_SLUG" async></script>

4. Click Save. The button appears on your store at once.

Allow your store's addresses

Under Agent → Deploy → Allowed websites, add each address your store opens at, one per line, for example https://your-store.myshopify.com and https://www.example.com. With www and without are different addresses. Only these websites can pass values and functions to the agent.

Tell the agent about the cart and the customer

Below the embed code in theme.liquid, give the next call what the page knows. Liquid fills these in on Shopify's side; the values come from the visitor's browser, so the agent treats them as unverified.

<script>
  window.evasay = window.evasay || [];
  evasay.push(function (agent) {
    agent.setVariables({
      customer_name: {{ customer.first_name | default: '' | json }},
      page: location.pathname
    });
    agent.update('Cart: {{ cart.item_count }} items', { key: 'cart' });
  });
</script>

Let the agent add to the cart

Add a function of type Runs on your web page named add_to_cart to the agent, with a variant_id parameter, and answer it with Shopify's cart API:

<script>
  window.evasay = window.evasay || [];
  evasay.push(function (agent) {
    agent.registerTool('add_to_cart', async function (args) {
      const response = await fetch('/cart/add.js', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ items: [{ id: Number(args.variant_id), quantity: 1 }] })
      });
      if (!response.ok) throw new Error('Could not add it to the cart');
      return { ok: true, checkout: '/checkout' };
    });
  });
</script>

Give the agent the product and variant IDs it may offer in its knowledge base or instructions. When the theme is replaced or updated, check that the code is still in theme.liquid.