How to set up Shopify Integration

Purpose

The objective of this step-by-step guide is to assist you in configuring the integration with your Shopify Store. This walkthrough provides comprehensive instructions to ensure a successful setup process.

Pre Requisites

Before proceeding with this documentation, you must have an active Shopify store. Ensure that you have set up your Shopify store and have the necessary access credentials ready. This documentation assumes you have an operational Shopify store to work with.

Have a Shopify store

Create and configure an App on Shopify

Before you can begin using the app, you need to create and configure it on your Shopify store.

Create the App on Shopify

To begin using this application, you need to create the app within your Shopify store. Follow these steps to create the app:

1 - We assume that you already have a store created on Shopify

2 - In the main menu you must go to the Apps option

3 - Now you must click on the Develops Apps option

4 - Now you need to press the button Allow custom app development

5 - Now you need to press the Create an app button

6 - Select a name for the application, we recommend that it be "Thiio" to identify it in the future more quickly. Then you must press the Create an app button.

Configure the App on Shopify

This section of the documentation will guide you through the process of fine-tuning your app's settings and options to ensure it operates seamlessly within your Shopify store and our CRM.

1 - On the next screen you need to press Configure Admin API scopes

2 - The following scopes options must be activated:

Assigned fulfillment orders
    write_assigned_fulfillment_orders
    read_assigned_fulfillment_orders
Customers
    write_customers
    read_customers
Discounts
    write_discounts
    read_discounts
Draft orders
    write_draft_orders
    read_draft_orders
Fulfillment services
    write_fulfillments
    read_fulfillments
Merchant-managed fulfillment orders
    write_merchant_managed_fulfillment_orders
    read_merchant_managed_fulfillment_orders
Order editing
    write_order_edits
    read_order_edits
Orders
    write_orders
    read_orders
Payment terms
    write_payment_terms
    read_payment_terms
Products
    read_products
Purchase options
    write_purchase_options
    read_purchase_options
Shipping
    write_shipping
    read_shipping
Third-party fulfillment orders
    write_third_party_fulfillment_orders
    read_third_party_fulfillment_orders

3 - In the “Webhook subscriptions” option select 2023-07 and press the Save button

4 - Then we install the application by pressing the Install App button

5- We will confirm the installation by pressing Install

6 - In the API credentials window we copy the values to configure the integration in our CRM Solution.

You must be careful to copy the "Admin API access token" well since you can only see it once, to be able to see it again you would have to uninstall the app and reinstall it

Configure the integration in our CRM

This section of the documentation is dedicated to guiding you through the process of setting up and fine-tuning the integration between your CRM and Shopify.

Main configuration

1 - It's time to configure the integration in our CRM Solution

2 - Press add Button

3 - Search “Shopify” and press configure

4 - We set the values that we copied before and press the SAVE button

Shop URL: Copy all the URL from your Store, including the “.com”
API Key: Copy from “API Credentials/API key and secret key“ section
API Secret key: Copy from “API Credentials/API key and secret key“ section
Webhooks signature: All your webhooks will be verified with this. This is optional, but recomendable. More description on Webhokks configuration.
Admin API access token: Copy from “API Credentials“ section, this token can be revealed on Shopify.

Webhooks configuration

1 - After successfully creating the integration, proceed to activate it and save the integration's URL. This URL will be used to configure the webhooks in the following steps.

2 - We proceed to activate the action we want to notify to Shoífy.

3 - Now going to Shopify to configure the webhooks used for communicating with our CRM

4 - Then we navigate to the notification menu

5 - We go down to the bottom of the screen and press Create Webhook

6 - For each of the events mentioned in the list, we will fill in the data as follows

Event List:

Checkout creation
Checkout update
Customer creation
Fulfillment creation
Fulfillment update
Order creation
Order update
Order payment
Product creation
Product update
Customer SMS marketing consent update

Format: JSON

URL: Is the URL we copied Webhooks configuration - Step 1 - Point 3

Webhook API Version: 2023-07

Exchange rate configuration

In the configuration section of the Shopify integration in the Exchange Rate tab

Step 1: Managing Exchange Rate Activation

Use this switch to control the activation status of the exchange rate. Toggle it to enable or disable the exchange rate as needed.

Step 2: Default Rate

The default rate is the value that will be applied in case the API supplying the rates encounters an issue or fails.

Step 3: Currency Selection

Choose the currency you wish to convert before sending it to Shopify.

Product and Offers sync

To synchronize the products registered in Shopify with our CRM Solution, you'll need to ensure that you have the necessary API Access scope on Shopify for viewing or managing products, variants, and collections, with the "read_products" option enabled.

After granting the required permissions, you can use the "Sync Products" option. Upon completion of the synchronization process, you will receive a notification.
In the Settings panel, there is an option to enable the sync status of products. If this option is active, when you use the "Sync Products" feature again or receive a webhook from Shopify, your Selling Channels configuration will be replaced by the configuration from Shopify. In addition, we can enable/disable Sync offers. We have this filters:
1. Vendor name
2. Enable sync products
3. Enable sync offers
4. Allow sync status

Sync Customers

To synchronize your customers registered in Shopify with our CRM, you'll need to ensure that you have the necessary API Access scope on Shopify to view or manage orders(read_orders) and customers(read_customers).

In this panel, you can select an optional range of dates to get your customers from the orders on Shopify, all orders from customers are set as notes in customer.

Abandoned Checkout

We have a background process to retrieve all abandoned checkouts, enabling us to reach out to customers and explore additional opportunities for completing a sale. For that, need to have the API Access scope on Shopify to view or manage orders, transactions, fulfillments, and abandoned checkouts, with the option for read_orders.

This process is set to run automatically every 10 minutes by default, after running this, in our CRM we must create a new lead entry and attach a corresponding order note containing the information obtained from the abandoned checkout.