Set up member synchronization

You can set up your Business Central (BC) and HeyLoyalty environments to synchronize changes to member-related data. This means that new member information and changes made to the existing members in Business Central will be sent to HeyLoyalty and vice versa.

Prerequisites

  • Make sure you have decided on the field mapping (exactly which HeyLoyalty fields will be used in the synchronization process, and which BC fields they will be mapped to).
  • Request the API key and API secret from your HeyLoyalty partner for the HeyLoyalty environment you wish to synchronize your member data with.

Procedure

  1. Click the Lightbulb button, search for the HeyLoyalty Integration Setup page and open it.
Cannot find the page? HeyLoyalty integration feature is not enabled by default. To enable it, navigate to NaviPartner Feature Management page, and make sure there is a checkmark in field Enabled on the HeyLoyalty Integration line. Do not forget to log into to the system again after enabling the integration.

  1. Fill in the following fields on the page (see Module Setup Overview: HeyLoyalty Integration Setup, if you need more details on the fields):
Field nameRecommended value
General FastTab
Enable IntegrationYes
Member List Integration Area subsection
Member IntegrationYes
HeyLoyalty Member List IDYour HeyLoyalty list ID
Membership HL Field IDMembership field ID at HeyLoyalty
Required Contact InfoSelect a value from the list
Require GDPR ApprovalYes
Require Newsletter SubscriptionYes
Unsubscribe if BlockedNo
Connection Parameters FastTab
HeyLoyalty Api Urlhttps://api.heyloyalty.com/loyalty/v1
HeyLoyalty Api KeyThe API key you acquired from your HeyLoyalty partner
HeyLoyalty Api SecretThe API secret you acquired from your HeyLoyalty partner
  1. Set up multiple choice field mapping.

  2. Set up Business Central member attribute mapping with HeyLoyalty single choice and text fields.

  3. Set up Business Central collect store mapping with HeyLoyalty stores (the list of stores created in HeyLoyalty).

  4. Set up Business Central country/region mapping with HeyLoyalty countries.