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

# Shopify

> Automatically recognize customers from your Shopify store when they call

## What this integration does

The Allo-Shopify integration enriches your calls with customer data from your online store. When customers call, see their order history, customer status, and account details instantly. Perfect for e-commerce businesses providing phone support.

**Key benefits:**

* Automatic customer recognition during calls
* Display order history and customer info
* View customer lifetime value
* Access customer status instantly

<Note>
  This integration requires creating a custom app in your Shopify admin. Follow the setup steps carefully.
</Note>

## Setup

### Create Shopify app

<Steps>
  <Step title="Open Shopify admin">
    Log into your Shopify store admin panel
  </Step>

  <Step title="Navigate to Apps & Sales channels">
    Go to **Settings** > **Apps and sales channels**
  </Step>

  <Step title="Develop Apps">
    Click **Develop apps** (you may need to enable app development first)
  </Step>

  <Step title="Create new app">
    Click **Create an app** and name it "Allo" (or any name you prefer)
  </Step>

  <Step title="Configure Admin API scopes">
    Click **Configure Admin API scopes**
  </Step>

  <Step title="Enable required scopes">
    Search and enable these two scopes:

    * `read_customers`
    * `read_orders`

    Then click **Save**
  </Step>

  <Step title="Install app">
    Click **Install app** to confirm the permissions
  </Step>

  <Step title="Reveal access token">
    Click **Reveal token once** to display your API access token.

    <Warning>
      You can only see this token once. Copy it immediately and store it securely.
    </Warning>
  </Step>

  <Step title="Copy access token">
    Copy the entire access token to your notes app or password manager
  </Step>
</Steps>

### Connect in Allo

<Steps>
  <Step title="Open Allo app">
    Launch Allo mobile app
  </Step>

  <Step title="Go to Integrations">
    Navigate to **Settings** > **Integrations** > **Shopify**
  </Step>

  <Step title="Enter access token">
    Paste the Shopify access token you copied earlier
  </Step>

  <Step title="Enter store domain">
    Add your Shopify store domain (e.g., `your-store.myshopify.com`)
  </Step>

  <Step title="Save and connect">
    Tap **Save** and wait for confirmation
  </Step>
</Steps>

<Info>
  Your Shopify customers will sync to Allo automatically. Customer information displays when they call.
</Info>

## How it works

<CardGroup cols={2}>
  <Card title="Customer recognition" icon="https://mintcdn.com/themobilefirstcompany/0w3bVWjKfZPY4i7y/media/integrations/Shopify.svg?fit=max&auto=format&n=0w3bVWjKfZPY4i7y&q=85&s=1357709a5cca44533206072d919164cb" width="24" height="24" data-path="media/integrations/Shopify.svg">
    Customer info displays automatically when they call, pulled from Shopify.
  </Card>

  <Card title="Order history" icon="https://mintcdn.com/themobilefirstcompany/0w3bVWjKfZPY4i7y/media/integrations/Shopify.svg?fit=max&auto=format&n=0w3bVWjKfZPY4i7y&q=85&s=1357709a5cca44533206072d919164cb" width="24" height="24" data-path="media/integrations/Shopify.svg">
    See recent orders, amounts, and order status during calls.
  </Card>

  <Card title="Customer sync" icon="https://mintcdn.com/themobilefirstcompany/4JKVqOLduvlaK6pG/media/integrations/Allo.png?fit=max&auto=format&n=4JKVqOLduvlaK6pG&q=85&s=de5eaa45a01e052c9506804098dbb8ce" width="256" height="256" data-path="media/integrations/Allo.png">
    All Shopify customers import into Allo contacts.
  </Card>

  <Card title="Lifetime value" icon="https://mintcdn.com/themobilefirstcompany/0w3bVWjKfZPY4i7y/media/integrations/Shopify.svg?fit=max&auto=format&n=0w3bVWjKfZPY4i7y&q=85&s=1357709a5cca44533206072d919164cb" width="24" height="24" data-path="media/integrations/Shopify.svg">
    View total customer spend and order count.
  </Card>
</CardGroup>

### Customer information displayed

When a Shopify customer calls, you see:

* Customer name
* Email address
* Order count
* Total amount spent
* Most recent order date
* Customer status (active/disabled)

### Contact synchronization

**Shopify to Allo:**\
All Shopify customers sync automatically. New customers appear within 10 minutes.

**One-way sync:**\
Contacts are synced from Shopify to Allo only. Calls are not logged back to Shopify.

## What syncs

<Tabs>
  <Tab title="Shopify to Allo">
    **From Shopify to Allo:**

    * Customer names and phone numbers
    * Email addresses
    * Order history
    * Total amount spent
    * Order count
    * Customer status
    * Customer tags
  </Tab>

  <Tab title="Allo to Shopify">
    **From Allo to Shopify:**

    Nothing syncs from Allo to Shopify. This is a read-only integration for customer recognition only.

    Call recordings and summaries remain in Allo.
  </Tab>
</Tabs>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection failed">
    **Common causes:**

    * Incorrect access token
    * Wrong store domain
    * Missing API scopes
    * Token copied incorrectly

    **Solutions:**

    * Verify you copied the entire access token
    * Check your store domain format (include `.myshopify.com`)
    * Ensure both `read_customers` and `read_orders` scopes are enabled
    * Generate a new access token if needed
  </Accordion>

  <Accordion title="Can't see the access token again">
    Shopify only shows the access token once for security.

    **Solution:**

    1. Go back to Shopify admin
    2. Delete the old Allo app
    3. Create a new app following the setup steps
    4. Copy the new token immediately
  </Accordion>

  <Accordion title="Customers not syncing">
    **Wait for sync:**\
    New customers can take up to 10 minutes to appear in Allo.

    **Check connection:**\
    Verify the integration shows as "Connected" in Allo Settings.

    **Phone number required:**\
    Shopify customers must have a phone number to sync.
  </Accordion>

  <Accordion title="Customer info not showing during calls">
    **Verify phone number:**\
    The calling number must match exactly what's in Shopify customer records.

    **Format differences:**\
    Check that phone numbers are formatted consistently (with or without country code).
  </Accordion>

  <Accordion title="Missing order information">
    **Check API scopes:**\
    Make sure you enabled both `read_customers` AND `read_orders` when creating the app.

    **Solution:**\
    Disconnect, update the Shopify app scopes, and reconnect.
  </Accordion>

  <Accordion title="Need to reconnect">
    To reconnect the integration:

    1. Go to **Settings** > **Integrations** > **Shopify**
    2. Tap **Disconnect**
    3. Generate a new access token in Shopify
    4. Follow the connection steps again
  </Accordion>
</AccordionGroup>

## Manage your integration

### Disconnect Shopify

To disconnect the integration:

1. Open Allo app
2. Go to **Settings** > **Integrations**
3. Select **Shopify**
4. Tap **Disconnect**

<Warning>
  Disconnecting stops customer sync. Existing contacts in Allo remain unchanged.
</Warning>

### Revoke API access

To completely revoke Allo's access to Shopify:

1. Log into Shopify admin
2. Go to **Settings** > **Apps and sales channels** > **Develop apps**
3. Find the Allo app
4. Click **Delete app**

## Use cases

### Customer support

See complete order history when customers call about their orders. Provide informed support without asking them to repeat information.

### Order status inquiries

Quickly check order status, tracking numbers, and delivery dates while on the phone with customers.

### VIP customer recognition

Identify high-value customers instantly based on total spend and order frequency. Provide premium service accordingly.

### Returns and refunds

Access order details immediately when handling return or refund requests. Speed up resolution time.

## Need help?

<CardGroup cols={2}>
  <Card title="Contact Allo support" icon="https://mintcdn.com/themobilefirstcompany/4JKVqOLduvlaK6pG/media/integrations/Allo.png?fit=max&auto=format&n=4JKVqOLduvlaK6pG&q=85&s=de5eaa45a01e052c9506804098dbb8ce" href="/en/support/contact" width="256" height="256" data-path="media/integrations/Allo.png">
    Get help with the integration
  </Card>

  <Card title="Shopify documentation" icon="https://mintcdn.com/themobilefirstcompany/0w3bVWjKfZPY4i7y/media/integrations/Shopify.svg?fit=max&auto=format&n=0w3bVWjKfZPY4i7y&q=85&s=1357709a5cca44533206072d919164cb" href="https://help.shopify.com" width="24" height="24" data-path="media/integrations/Shopify.svg">
    Learn more about Shopify features
  </Card>
</CardGroup>