Overview

Zenkraft offers a Self-Service Webhook Tracking solution as an alternative to Scheduled Tracking. Webhook Tracking is ideal for customers who are tracking a high volume of Shipments, or who require updates as soon as possible.

There are three supported methods of adding webhook based tracking to your instance: using the Zenkraft Multi-Carrier Connected App, using a Custom Connected App, and using a Public Site.

For most users, our team recommends using the Zenkraft Multi-Carrier Connected App method. This method allows for a high volume of tracking updates, and utilizes a secure, authenticated connection to receive those updates.

If you would like to limit the access of our Managed Application, you also have the option of creating a Custom Connected App to facilitate the reception of tracking updates. This configuration process requires more steps than the Zenkraft Multi-Carrier Connect App method, but supports the same level of volume.

Finally, there is also the option of using a Public Site to receive Webhook Tracking updates. This option has the least secure connection and can support the lowest volume of all Webhook tracking methods. In rare cases, this may be the preferable solution. If you are considering utilizing Public Site-based Webhooks, please reach out to Zenkraft Support to verify if this may be a good solution for you.

NOTE: In order to utilize our Webhook tracking solutions, please ensure you are using Zenkraft Multi-Carrier Package Version 1.130.1 or later.

Zenkraft Multi-Carrier Connected App Webhooks

For most clients, the Zenkraft Multi-Carrier Connected App Solution will offer the best combination of simplicity of setup, security of connection, and support for high volume.

Create Webhook in Zenkraft Settings

To begin setting up Webhook-based tracking utilizing the ZK MC Connected App option, navigate to Zenkraft Settings and select the Tracking sub-tab.

Under the Webhooks section select Zenkraft Multi-Carrier Connected App as your Webhook type. You can leave Custom Domain blank. Hit save.

Grant Zenkraft API Access

You will then be asked to grant the Zenkraft API access to a number of different functionalities within your Salesforce Instance. Hit allow to proceed.

From there, if you have access to the Zenkraft API Dashboard, you will be redirected to your account's dashboard.

Within the API Dashboard you can click on the Webhook tab on the left side and confirm a Connected App Webhook has been created.

NOTE: If you do not have access to the Zenkraft API Dashboard, this will not have any negative affect on your ability to implement the Webhook solution. After clicking allow, simply close the tab that pops up.

Check and connect app

Navigate back to the tab where Zenkraft Settings is open. There should now be a button to Check and Connect App under the Webhook Section.

Click on this button. You should now see a Connected App Webhook appearing in your instance.

You have now successfully set up Webhook Tracking. Your next step is to disable any batch tracking jobs running in your instance.

Decrease frequency of schedule tracking

Scroll down to the Scheduled Tracking section.

Press the edit icon next to any schedulers which exist. A pop-up will appear where you can alter the cron expression to decrease frequency. You can decrease the frequency of the scheduled tracking job to once a day or or less to preserve Salesforce resources. Repeat for any remaining schedulers.

Custom Connected App Based Webhook Tracking

Create a custom app

Navigate to Setup and search for App Manager in the quick find box. After clicking into App Manager, select the New Connected App button.

In this new connected app enter a Name, API Name and Contact email.

Under API (Enable OAuth Settings) select the Enable OAuth checkbox. In the callback URL field paste the following URL: https://api.zenkraft.com/sf/oauth.
In the Selected OAuth Scopes select Manage User Data via APIs (api) and Perform requests at any time (refresh_token, offline_access.

Select the Require Secret for Web Server Flow checkbox.

Scroll to the bottom of the page and save, then continue.

Public Site Based Webhook Tracking