Allo

Shopify

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

Updated on

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.

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

Open the Shopify Dev Dashboard

Go to dev.shopify.com and sign in with the Shopify account you use for your store. Pick the organization that holds your store.

Create the app

Click Create app, name it Allo and confirm.

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.

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 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.

Release the version

Click Release to make this version active.

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.

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.

Connect Shopify in Allo

Go to Integrations

In Allo, go to Settings > Integrations.

Find Shopify

Find Shopify and click Connect.

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.

Paste the Client ID and secret

Paste the Client ID and Client secret you copied from the Dev Dashboard, then click Connect.

Wait for the customer import

Allo imports your Shopify customers. The integration shows the import in progress until the first sync finishes.

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

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.
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, go to API access requests > Protected customer data access, select Name, Email and Phone, and save. Then disconnect and reconnect Shopify in Allo.

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.

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.

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.