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)
- BranchCode (the code you use to identify each restaurant)
- BranchName (the restaurant name)
- VisitType (type of feedback or social reviews)
- VisitSource (where the feedback came from e.g. reservation).
- 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)
- Section (name and score)
- Question Subject (name, category, score, analysis tag and dish – where applicable)

- GuestID (the ID passed to us from your CRM, if applicable)
- MarketingConsent (Yes/No) 
- ReplyConsent (Yes/No)

If guest consented:
-First name, last name and email.

Getting started

To get started: 
- Documentation for the API can be viewed via here. You can review what endpoints are available.
- Confirm a CRM or BI contact who will be calling the API, and we can share 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: data exports

      A data export enables us to periodically assemble your guest experience data into a CSV or Excel file and send it to an secure shared location (such as SFTP or S3 bucket) for you or your supplier to pick up. What are the benefits? Integrated ...
    • 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: ...