# Shopify

> Recognize your Shopify customers when they call or text, and log your Allo calls and SMS on the Shopify customer

The Shopify integration syncs your Shopify customers to Allo, so callers show up with their Shopify name, email, company, total spent and last order. After each call or SMS, Allo logs it on the matching Shopify customer.

Allo connects to your store through a small app that you create for your own store in the Shopify Dev Dashboard. It takes about 5 minutes and you only do it once.

<Note>
  Since January 1, 2026, Shopify no longer lets stores create custom apps from **Settings** \> **Apps and sales channels** \> **Develop apps**. If you connected Allo before with an Admin API access token, your connection keeps working and you have nothing to do.
</Note>

## How to connect

You need an Allo admin or manager, and the Shopify account that owns the store (or a staff account allowed to develop apps for it).

### Create the Allo app in Shopify

<Steps>
  <Step title="Open the Shopify Dev Dashboard">
    Go to [dev.shopify.com](https://dev.shopify.com) and sign in with the Shopify account you use for your store. Pick the organization that holds your store.
  </Step>
  <Step title="Create the app">
    Click **Create app**, name it `Allo` and confirm.
  </Step>
  <Step title="Choose the access scopes">
    Open the **Versions** tab and create a version. In the scopes section, add these four scopes:

    - `read_customers`
    - `write_customers`
    - `read_orders`
    - `write_orders`

    Pick the Admin API scopes, not the ones that start with `customer_` (such as `customer_write_orders`), which are for a different Shopify API.

    `write_customers` lets Allo log calls and SMS on your customers. The order scopes let Allo read your customers' orders. Allo never deletes a customer or an order.
  </Step>
  <Step title="Allow access to customer data">
    Shopify blocks access to customers until you allow it, even on your own store. Go to the [Shopify Partner Dashboard](https://partners.shopify.com) with the same account, open **Apps** \> **Allo** \> **API access requests** \> **Protected customer data access** and click **Request access**. Select **Protected customer data** and the **Name**, **Email** and **Phone** fields, give a reason and save. If Shopify asks you to choose a distribution method first, choose **Custom distribution** for your store.
  </Step>
  <Step title="Release the version">
    Click **Release** to make this version active.
  </Step>
  <Step title="Install the app on your store">
    From the app's **Home** tab, click **Test app**, choose your store, then click **Install** and approve the scopes.
  </Step>
  <Step title="Copy the Client ID and secret">
    Open the app's **Settings** tab and copy the **Client ID** and the **Client secret**. Keep them for the next step.
  </Step>
</Steps>

<Warning>
  The app must be in the same Shopify organization as your store. If it is not, Shopify refuses the connection.
</Warning>

### Connect Shopify in Allo

<Steps>
  <Step title="Go to Integrations">
    In Allo, go to **Settings** \> **Integrations**.
  </Step>
  <Step title="Find Shopify">
    Find **Shopify** and click **Connect**.
  </Step>
  <Step title="Enter your store">
    Enter your store subdomain, the part before `.myshopify.com`. For `acme.myshopify.com`, enter `acme`. You can also paste your store address or a Shopify admin link such as `admin.shopify.com/store/acme`: Allo keeps only the subdomain.
  </Step>
  <Step title="Paste the Client ID and secret">
    Paste the **Client ID** and **Client secret** you copied from the Dev Dashboard, then click **Connect**.
  </Step>
  <Step title="Wait for the customer import">
    Allo imports your Shopify customers. The integration shows the import in progress until the first sync finishes.
  </Step>
</Steps>

## What syncs

**From Shopify to Allo:**
- Customers that have at least one phone number, with their name, email, phone numbers, company, note and tags
- The total spent, the number of orders and the name of the last order
- A link to the customer in your Shopify admin

**From Allo to Shopify:**
- Calls and SMS, logged on the matching customer

**Sync direction:** Two-way. The first sync imports all your Shopify customers that have a phone number. After that, Allo checks for new and changed customers every 10 minutes.

Allo reads the customer phone number and the phone number of the default address. Customers without any phone number are not imported, because Allo cannot match them to a call or SMS. A customer who loses their last phone number is removed from Allo at the next sync.

## How calls and SMS are logged in Shopify

Shopify does not let apps write on the customer timeline, so Allo logs your calls and SMS in two places on the customer:

- **The customer note:** Allo adds one short line at the top of the note for each call or SMS, with the direction, the result, the duration and the date. Allo never removes or changes what your team wrote in the note. When the note gets long, Allo removes only its own oldest lines.
- **The Allo activity field:** a customer metafield named **Allo activity** keeps the 50 most recent calls and SMS with their details and AI summary. You find it in the **Metafields** section of the customer page.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The connection fails">
    - Check that the app is installed on the store you entered, and that the version with the four scopes is released.
    - Check that the app and the store are in the same Shopify organization.
    - Copy the Client ID and the Client secret again from the app's **Settings** tab. If you rotated the secret in Shopify, use the new one.
    - Enter only the store subdomain, for example `acme` for `acme.myshopify.com`.
  </Accordion>
  <Accordion title="Customers are imported without a name or phone number">
    Shopify protects customer names, emails and phone numbers. If your app does not get them, open the app in the [Shopify Partner Dashboard](https://partners.shopify.com), go to **API access requests** \> **Protected customer data access**, select **Name**, **Email** and **Phone**, and save. Then disconnect and reconnect Shopify in Allo.
  </Accordion>
  <Accordion title="Customers not syncing">
    New and changed customers can take up to 10 minutes to appear in Allo. Only customers with a phone number are imported. Check that the integration shows as connected in **Settings** \> **Integrations**.
  </Accordion>
  <Accordion title="A caller is not recognized">
    Allo matches the phone number of the customer and of their default address. National and international formats of the same number match. Check that the number is saved on the Shopify customer.
  </Accordion>
  <Accordion title="Disconnect or revoke access">
    To stop the sync, go to **Settings** \> **Integrations** \> **Shopify** in Allo and click **Disconnect**. Contacts already in Allo stay in Allo. To revoke Allo's access in Shopify, uninstall the Allo app from your store, or delete it in the Dev Dashboard.
  </Accordion>
</AccordionGroup>
