Shopify
Connecting IC Robotics to your Shopify solution is an easy three-step process.
You can read about the different steps, or simply watch the videos of each individual step below. Want to know about Auto update fields?
Connect Shopify data to IC Robotics
Create a private app in Shopify and connect it to IC Robotics app
In order to integrate data from Shopify, you will first need to set up a private app in Shopify. On your admin page in Shopify:
Create private app
Click on apps in the Shopify admin menu. Then at the bottom of the apps section go to Manage private apps and click Create private app. Create your private app by giving it a Private app name and an Emergency developer email.
- Private app name: Optional
- Emergency developer email:
contact@icrobotic.com
In Admin API permissions you will need to set “Inventory” and “Products” to Read and Write
Webhook API version should always be set to latest version
You should leave Allow this app to access your storefront data using the Storefront API Unchecked
You can now save your private app.
Now you have an API Key and a Password available which you need in order to create the Shopify connector on the IC Robotics platform.
On the IC Robotics plaform:
Create Connector
Go to Data and create an Integration.
Here you will Choose Connector as the integration type, and then choose Shopify.
Now you will need to insert your API Key and Password from your private app into the form. The URL is your shop URL e.g. “ictesting.myshopify.com”. Lastly, you will need to decide if auto-update fields should be left on or off.
A recent update to the Shopify connector has changed the "autoupdate fields" settings a bit. Read more below
You can always edit your integration settings.
You should now have access to all your product data in the IC Robotics app.
Create and write your template
Now that you have created your Shopify connector, simply create a template and start writing your text. Your template section IDs must match the IDs of the Shopify fields you want to automate. You can find a list of your Shopify fields Id’s here under product properties.
Example
The standard “Description” field in Shopify has the id “body_html” If you want to automate the “Description” field, you will need to name your template section “body_html”
Watch the video below for further instructions.
Generate texts to Shopify
In order to generate your text for your products, you will need to Publish your Template and create a webhook. This is easily done on the IC Robotics platform:
Publish Template
Go to Settings -> API and create an API key. Copy the key to your clipboard.
For security reasons, your API Key is only visible in full at the time of creation.
Now go back to your template and Publish it. You can now generate a webhook for your Publication. Simply click the webhook icon on your Publication and insert your API Key.
Copy your webhook to clipboard
Now you only need to insert your webhook URL into your Private app in Shopify. On your Shopify admin page:
Setup webhook
Go to Settings -> Notifications. In the bottom section on the Notifications page, click Create webhook.
Select an event for the webhook to trigger.
We recommend that you create two webhooks with the Product update Event on one and Product creation on the other.
You can use the same webhook URL for both Webhooks. (The URL you got from the IC Robotics platform)
The format should be set to JSON and Webhook API version should be set to (Latest).
You are now ready to automatically generate your product descriptions.
The last part of the video relates to the “auto update” option, when setting up the connector - read more about that below.
About auto update fields
In the configuration of your Shopify integration, you will have to decide whether Auto update fields should be Auto, Semi or Manual.
Leaving Auto update fields on Auto - Auto update fields Auto means that when generating your text for your Shopify solution, all your products will be updated automatically with a text, generated from your template. This means that current text that may already be on your products, will be overwritten - If you want to control some of your products manually, you should leave Auto update fields on Semi or Manual
Leaving Auto update fields on Manual - Auto update fields Manual means that IC Robotics app only will generate a text for a product if the product contains a metafield called ic-include with the string value true. Several metafield apps in Shopify have a “Bulk action” feature, which allows you to apply metafields to several products at once. This gives you the flexibility to choose which products you want to automate and which products you want to control manually.
Leaving Auto update fields on Semi - Auto update fields Semi means that IC Robotics app will generate and update all your products except if a product contains a metafield called ic-exclude with the string value of true. This is useful if you want to control just a few of your products manually.