> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Actions

> Configure which Shopify actions the AI can perform during conversations — order lookup, product search, and shop details.

Once your store is [connected](/integrations/shopify/connect), the AI gains three actions it can call during conversations. Each action is enabled by default and can be toggled independently.

## Available actions

<AccordionGroup>
  <Accordion title="Get Order Details" icon="box">
    The AI looks up an order by its order number (e.g. `#1042`, `UK-1003`).

    **What the customer sees:** order status, line items, fulfillment and tracking information, shipping address — the same data a rep would read from the Shopify admin.

    **Privacy guard:** the AI verifies that the customer's email matches the email on the order before revealing details. If the emails don't match, the AI declines the request.

    Requires the `read_orders` scope.
  </Accordion>

  <Accordion title="Search Products" icon="magnifying-glass">
    The AI searches your product catalog by keywords. It uses Shopify's native product search and returns results ranked by relevance.

    **What the customer sees:** matching product names, prices, availability, and descriptions. Useful for pre-sale questions like "do you have black running shoes in size 10?"

    Requires the `read_products` scope.
  </Accordion>

  <Accordion title="Get Shop Details" icon="store">
    The AI retrieves general information about your store — name, description, currency, shipping countries, and supported payment methods.

    **What the customer sees:** factual answers about your store's policies, accepted currencies, and shipping regions. Helpful for questions like "do you ship to Germany?" or "which payment methods do you accept?"

    Requires the `read_products` scope.
  </Accordion>
</AccordionGroup>

## Toggling actions

Each action can be enabled or disabled per organization. Disabled actions are not available to the AI during conversations.

Toggle actions in [Settings → Integrations](https://platform.open.cx/settings/integrations) → Shopify under **Actions Settings**:

| Action                | Default | When to disable                                                                                              |
| --------------------- | ------- | ------------------------------------------------------------------------------------------------------------ |
| **Get Order Details** | Enabled | If you handle order inquiries through a separate system or want the AI to hand off order questions to a rep. |
| **Search Products**   | Enabled | If your catalog is private or you prefer the AI not to recommend products.                                   |
| **Get Shop Details**  | Enabled | Rarely needed — only if shop-level data should not be shared in conversations.                               |

## Multi-store behavior

How the AI handles actions depends on the number of connected stores:

* **Single store:** every action runs against that store directly. No store selection needed.
* **Multiple stores:** the AI identifies the correct store from context — the customer's order number prefix, the store they mention, or the email match. When the customer asks about an order from a specific store, the AI routes the lookup to the right one.

<Note>
  Using distinct **order number prefixes** per store (e.g. `UK-` for your UK store, `NL-` for your Dutch store) makes multi-store routing more reliable. Configure prefixes in your Shopify admin under **Settings → General → Order processing**.
</Note>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Connect Store" icon="plug" href="/integrations/shopify/connect">
    Custom app, scopes, and credentials setup.
  </Card>

  <Card title="Contact Metadata" icon="address-card" href="/integrations/shopify/contact-metadata">
    Customer and order data in the inbox sidebar.
  </Card>

  <Card title="Shopify Overview" icon="shopify" href="/integrations/shopify/overview">
    Full integration capabilities at a glance.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/integrations/shopify/troubleshooting">
    Actions not firing, wrong store, missing data.
  </Card>
</CardGroup>