Append feedback
Store transactional feedback records as you send contact data to us

Overview

Airship can store full feedback history for contact records. This is useful to show the sentiment of a particular guest, and can be used in campaigns whereby a broadcast could be suppressed if someone has left feedback recently (for example if you don't want to ask someone for feedback about a recent visit if they've already done so).

Storing feedback

To store feedback, simply include a feedback object as you write a contact to us. We'll store a historic feedback record against the contact.
Field
Notes
type_id
1 = positive
2 = negative
3 = neutral
4 = unknown
You can also retrieve feedback types from the /feedback/types endpoint.
source_id
1 = website
2 = facebook
3 = tablet
4 = email
5 = twitter
unit_id
The unit_id representing the physical location for which this feedback relates.
comments
Pass in a type to tag comment types together (e.g. "Toilets", "Service" etc) along with a text string for this comment.
ratings
Pass in a ratings category_id along with a value for this rating in the rating_text field, and an optional contact_note..
You can retrieve a list of categories from the /feedback/categories endpoint. However, commonly used ones are:
1 - Food
2 - Drink
3 - Service
4 - NPS
1
"account_id": 3,
2
"email: "[email protected].com",
3
//...etc...
4
5
"feedback": [
6
{
7
"type_id": 1, // positive
8
"source_id": 1, // website
9
"unit_id": 8775,
10
"comments": [
11
{
12
"type": "Toilets",
13
"note": "Recently cleared and sparkling!"
14
},
15
{
16
"type": "Other Comments",
17
"note": "Had a great time, will definitely return!"
18
}
19
],
20
"ratings": [
21
{
22
"category_id": 1, // Food
23
"rating_text": "Excellent",
24
"contact_note": "Food was super tasty."
25
},
26
{
27
"category_id": 2, // Drink
28
"rating_text": "Good",
29
"contact_note": "Drinks were great, if a little expensive."
30
},
31
{
32
"category_id": 3, // Service
33
"rating_text": "Poor",
34
"contact_note": "We had to wait 15 minutes to pay at the end."
35
},
36
{
37
"category_id": 4, // NPS
38
"rating_text": "8",
39
"contact_note": "Would definitely recommend to a friend"
40
}
41
]
42
}
43
]
Copied!
Copy link