Sending Data: Key Results API

Sending Data: Key Results API

Sync your guest experience data with your CRM or BI platform, via the HGEM key results API. 

The API approach enables us to connect your CRM or BI platform with our API, allowing you to call the API to extract the required data to be stored in the relevant database.


What are the benefits?

Information where you need it
Where a guest has consented to receive marketing communications you can import their personal details directly into your CRM system ready to be used in your next campaign.

Integrated communications
Create a more detailed picture of your guests preferences and behaviours by feeding their feedback data (Guest ID , visit date/time, ‘recommend rating’ and any related comments) back into your CRM system. This data can then be used to inform your next campaign (eg, sending targeted marketing only to those guests who scored positively on the ‘recommend’ question). 

Integrated analytics
Where appropriate, we can export your guest experience data to be integrated with data from other sources in your own BI systems.

Available information

- VisitID (unique, numerical, 7-8 digits)
- VisitDateTime (i.e. the date the guest visited)
- Client (client name)
- Brand (brand name, where relevant)
- LocationCode (the code you use to identify each restaurant)
- LocationName (the restaurant name)
- VisitScore (the overall score for the visit expressed out of 100)
- NPS/RecommendScore (out of 10)
- NPS/RecommendComment (left by the guest against the NPS/recommend question)
- GuestID (the ID passed to us from your CRM, if applicable)
- MarketingConsent (Yes/No) 
- ReplyConsent (Yes/No)

Getting started

To get started: 
- Confirm a CRM or BI contact who we can add to a Teams collaboration channel - this contains developer documentation, and we will add an API key which is authenticated to return your data.
- Alternatively your data can be shared via a data export - see here for more information. 

    • Related Articles

    • Sending data: CSV data exports

      A data export enables us to periodically assemble your guest experience data into a CSV file and send it to an sftp location for you or your supplier to pick up. What are the benefits? Integrated communications Create a more detailed picture of your ...
    • Survey feature: data integrity

      As standard, our surveys come with a range of automated measures designed to prevent fake feedback from reaching your analysis. When designing your survey, we can assess which of these are best suited for your circumstances. What are the benefits? ...
    • Survey feature: consent options

      Capture guest data for multiple use cases, and ensure that you remain fully GDPR compliant using our fully branded guest feedback sites. What are the benefits Fully GDPR compliant Personal data from guests can only be captured if you are transparent ...
    • Sending feedback invites from your CRM

      Use your CRM platform to send out feedback requests. This would work by embedding a link to your feedback survey into an email template and building a relevant email campaign for this in your CRM. You would define the parameters/scheduling for the ...
    • List of features for feedback sites

      Getting structured feedback from customers about your business is invaluable – it can help identify your strengths, but also where to make changes within the business, ensuring your business ticks all the right boxes for customers. Survey Features: ...