Skip to main content

Survey Links

A survey link is a URL that directs customers to a survey form.

info

Common mediums for sharing survey links include:

  • QR Codes: Generate a QR code that links to the survey, allowing customers to scan it with their mobile devices.
  • Social Media: Post the link on platforms like Instagram, Facebook, or Twitter to reach a wider audience.
  • POS Integration: Some POS systems allow you to send Harlyy survey links directly to customers after a transaction.

You can also manually create survey links using either of the following formats:

https://www.harlyy.com/surveys/<business_id>/<survey_id>
https://www.harlyy.com/surveys/<business_id>/<survey_id>/<location_id>

Preview links can be created, which are useful for testing before sharing with customers:

https://www.harlyy.com/surveys/<business_id>/<survey_id>/preview

Replace <business_id>, <survey_id>, and <location_id> with the appropriate IDs from your Harlyy account.

Harlyy links also support powerful query parameters which make it easier for partners to integrate with Harlyy surveys.

text parameter​

The text parameter allows you to pre-fill the text field in a contact-step in the survey. This can be helpful in many use cases, for example, many of our POS partners use this to inject and order number in order to track submissions back to the order.

https://www.harlyy.com/surveys/<business_id>/<survey_id>?text=<text>
https://www.harlyy.com/surveys/<business_id>/<survey_id>/<location_id>?text=<text>

location:metadata parameter​

The location:metadata parameter allows you to infer the location that a survey link is being used for, based on an internal identifier that you can pass in the URL. In order to use this, a business' locations must have a metadata field setup with a <key>.<value> pair that matches the value you pass in the URL.

https://www.harlyy.com/surveys/<business_id>/<survey_id>?location:metadata=<key>.<value>
https://www.harlyy.com/surveys/<business_id>/<survey_id>/<location_id>?location:metadata=<key>.<value> (will default to <location_id> if no location is found)

For example, if you have an internal identifier for a location called store_id with a value of 12345, you can pass this in the URL like so:

https://www.harlyy.com/surveys/<business_id>/<survey_id>?location:metadata=store_id.12345

and setup each location's metadata in the Harlyy dashboard like this:

Location Metadata Example