
Training - Loyalty & Rewards
Webhooks
Webhooks
In the GHL Loyalty & Rewards system there are a number of webhooks you can fire that will help you manage reward member points.
You can find basic examples of these webhooks and how to use them in the Example Workflows & Recipes folder under Automations
In the GHL Loyalty Rewards system you can give points for any action you can pass through a workflow.
So for example you can set up a workflow with a Video Views trigger and give points to a contact when that contact views a certain percentage of your video.
Another exmples is when a customer checks-in, or fills out a form.
You can also trigger a workflow from zapier or make and give points to that contact that way using the following webhook:
Copy the below webhook link, and add the following custom data fields:
https://api.ghlsmartscripts.com/Webhook-SmartScripts-LoyaltyTracking.php
location = {{location.id}}
points = Put the number of points here
action = givepoints
cid = {{contact.id}}
title = *** Reason For Earning Points ***
*** title will display in the transactions record as: You have been awarded 15 points “for TITLE”
So for example of if title equalled “sharing on social media” the transaction record would show: You have been awarded 15 points for sharing on social media.
If you want to give points for a transaction amount (say a customer checked out or purchased something and you want to give points based on the amount someone had spent) you could:
Custom Fields:
Transaction Amount
Divide Transaction Amount by # of points
Update - Rewards - Transaction Points - Custom field with the new value
And use that as your points for the transaction
Set Transaction Points to 0 at end of workflow.
This webhook will expire all points from a contact, resetting their points to 0.
Expiring Points Webhook
Workflow Action => Webhook
URL = https://api.ghlsmartscripts.com/Webhook-SmartScripts-LoyaltyTracking.php
Custom Data:
location = {{location.id}}
points = {{contact.smart_rewards_current_points}}
action = expire
cid = {{contact.id}}
In your workflow, create a webhook with the custom data values above.
This webhook will grant the contact (usually a the referring contact from refer a friend) a specific Promotional Coupon as a gift for referring a new VIP member.
You will need the ID of a promotion you have created using the Custom Campaign Promotion inside of the promotions manager:
*** It’s not recommended to use this to grant a promotion to a regular contact as that can be achieved easier using workflow automotions and updating the SMART Offers List custom field with a new promotion id. ***
Grant Promotion Offer Webhook
URL: https://api.ghlsmartscripts.com/Webhook-SmartScripts-LoyaltyTracking.php
Custom Data Fields:
location = {{location.id}}
promoid = The ID of the Promotion (usually Custom Campaign)
action = grant_promo
cid = {{contact.referred_by_id}}
In the Loyalty & Rewards system instead of having customers redeem points for a voucher, you can give them access to a one time use form, which they can fill out to receive any number of rewards you can think of:
Examples:
Redeem points and register for an event.
Redeem points and opt in for a higher ticket service.
Redeem points to "purchase" a service from the agency or business.
- One agency uses this sytem to gift their customers 5000 points at the start of their subscription. The customer can then spend 1000 points to get custom graphic design work done - redeeming the points, then filling out the form for custom work to be completed.
Redeem points to download an ebook
Redeem points to get a gift card from a third party (using our tango gift card integration).
Redeem points to trigger anything you want to happen in a workflow
*******************
In order to use this sytem you need:
- A form for customers to fill out with the RID field (rewards id) field so we can capture the id of the reward being redeemed.
- A workflow to handle the request after the form is filled out.
When creating a reward item, Select Embed GHL Form in the redmption display dropdown, then sele the form in our rewards manager instead of voucher:
Create a workflow that triggers off of the submitted form you used in your reward, with the following webhook:
Referral Invite Webhook:
https://api.ghlsmartscripts.com/Webhook-SmartScripts-LoyaltyTracking.php?action=referral_invite&points={{ custom_values.rewards__referral_invite_points }}&location={{ custom_values.smart_location_id }}
Referral Lead Webhook:
https://api.ghlsmartscripts.com/Webhook-SmartScripts-LoyaltyTracking.php?action=referral_lead&points={{ custom_values.rewards_referral_lead_points }}&location={{ custom_values.smart_location_id }}
Referral Webhook
https://api.ghlsmartscripts.com/Webhook-SmartScripts-LoyaltyTracking.php?action=referral&points={{ custom_values.rewards_referral_points }}&location={{ custom_values.smart_location_id }}