Notification webhook

Overview

After the app is installed, it will automatically ask Shopify to send the order information to the app when a customer made an order, the order information Shopify sent to the app contains all data related to the order e.g line items, fulfillment, and customer data etc, then the app will use the order information and the entries and rules you created in the app admin to send customer either activation code or the file download link

But from 1st July 2023, Shopify will not send information that can identify the customer by default (information like customer names, email, and address, etc), access to protected customer data will require approval from Shopify

To be able to get the order's customer email is important for the app to be able to send the activation/file download email to the customer, we have already submitted an application for protected customer data access. However, the approval process may take some time, and we are uncertain when it will be granted.

To ensure the uninterrupted operation of our app and the successful delivery of customer activation codes and file downloads. The Shopify notification webhook can be used as an alternative way to make the app work while the app is waiting for approval to access the customer data like email (because notification webhook will be able to send the whole customer data like email to the app's webhook endpoint)using.

Setup steps

There are three steps to use the notification webhook

  1. Get the webhook url from the app

  2. Create notification webhook and signature in Shopify admin

  3. Save the webhook signature in the app

Step 1 - Get the webhook url from the app

Go to Shopify admin > Apps > Digital Asset manager > Settings > Notification Webhooks to trigger delivery > Incoming webhook url > copy

The webhook url is the url Shopify will call when a event (e.g order paid) occurred

Step 2 - Create notification webhook and get signature

Follow the following steps

  • Go to the "Settings" section and click on "Notifications."

  • Scroll down to the "Webhooks" section and click on "Create webhook."

  • In the "Event" field, select "Order paid" or "Order created" (depending on your preference).

  • Select JSON as the format

  • Enter the above incoming webhook url as the "Endpoint URL"

  • Save your webhook configuration.

Once the webhook is created, you will the signature at the bottom

Copy the signature (the signature is for the app to verify the webhook is legit and coming from Shopify - on every signle webhook call, shopify will call the url with the signature, then the app will verify the call is legit before processing it)

Step 3 - Save the webhook signature

With the signature copied in the clipboard, go back to the App admin > Settings > Notification Webhooks to trigger delivery and paste in the signature in the signature box > Scroll up and Save the setting

Testing

Once all of the above steps are done, please take the following steps to test it

  1. Set up a new entry with the products in the app

  2. Create a new order in Shopify admin

  3. Make changes to the order, so it will trigger the webhook event you added

  4. Check if the order's customer receive the delivery

Let us know if you encounter any issues or have any questions

Last updated