Webhooks: Reviews
Webhook notifications for Airbnb and Booking.com guest reviews.
Guesty's Open API allows you to send various reviews-related webhook notifications to your application's notification URL(s).
What Notifications Can I Receive?
- New and updated guest reviews from Airbnb and Booking.com.
- New and updated host reviews posted to Airbnb and Booking.com.
Why Create Reviews Webhooks?
Once your Guesty Open API integration is complete and finished with its initial synchronization of data, we recommend you to utilize the reviews webhook notification. Webhook notifications will help you save time and resources. Plus, you get to only synchronize the reviews data that has changed or is new and ignore that which has remained in the same state since the initial synchronization.
Reservation Reviewed Notification
This webhook notification is sent whenever a new guest review is synchronized with your Guesty account from Airbnb or Booking.com. Learn how to create this webhook here.
Notification Payload
Body Parameter | Data Type | Description |
---|---|---|
_id | string | Guesty review ID. |
externalReviewId | string | External review ID. |
accountId | string | Your Guesty account ID |
channelId | string | The review source (airbnb2 or bookingCom ). |
createdAt | string | The date and time the review was written and submitted. |
createdAtGuesty | string | The date time the review was imported into Guesty. |
externalListingId | string | Channel listing ID. |
externalReservationId | string | Channel reservation ID. |
guestId | string | Guesty ID of the guest. |
listingId | string | Guesty listing ID. |
rawReview | object | The review object. |
reservationId | string | Guesty reservation ID. |
updatedAt | string | Date and time of the most recent change on the channel. |
updatedAtGuesty | string | Date and time that Guesty imported the change. |
reviewReplies | [object] | Array of replies. |
event | string | reservation.reviewed |
Airbnb Reservation Reviewed Notification Example
{
"_id":"62d00273f3a7c7ba7e016a14",
"externalReviewId":"test_6",
"accountId":"5db59615f6fc3b001f8ee56f",
"channelId":"airbnb2",
"createdAt":"2022-07-14T11:44:02.563Z",
"createdAtGuesty":"2022-07-14T11:45:08.137Z",
"externalListingId":"604153909318094860",
"externalReservationId":"HMTZ9DWB9W",
"guestId":"62330bdc1e874f003681cf32",
"listingId":"5f90114acc5b51002979b1e0",
"rawReview":{
"id":729460318938454900,
"reviewer_role":"guest",
"reviewer_id":284554274,
"reviewee_role":"host",
"reviewee_id":50038747,
"listing_id":53874861,
"reservation_confirmation_code":"HMTHYT45AD",
"hidden":false,
"submitted":true,
"overall_rating":2,
"public_review":"The location is great and the house has all amenities two families with young kids need.\nHowever check in and check out times (very late and very early out), paired with extremely high cleaning fees (which are not even reflected in an extremely clean house) make it a unsatisfactory experience for the money.",
"private_feedback":"- very late Check in and very early check out\n- for cleaning fee of 175€ you still need to take down the bed linen yourself…\n- additionally cleaning seemed to be only rudimentary done\n- sanitary areas a bit smelly (possibly apartment not used for some time or drains not working properly)\n- difficult to find the key (no distinguishing between inside housing complex or outer circle)",
"id_str":"729460318938454957",
"reviewer_id_str":"284554274",
"reviewee_id_str":"50038747",
"listing_id_str":"53874861",
"expires_at":"2022-10-17T11:07:26.376Z",
"first_completed_at":"2022-10-03T19:00:12.350Z",
"submitted_at":"2022-10-03T19:41:31.457Z",
"category_ratings_communication":3,
"category_ratings_accuracy":2,
"category_ratings_cleanliness":2,
"category_ratings_location":4,
"category_ratings_value":2,
"category_ratings_checkin":1
},
"reservationId":"629208e3d5b216003488065e",
"updatedAt":"2022-07-14T11:44:55.556Z",
"updatedAtGuesty":"2022-07-14T11:45:08.137Z",
"reviewReplies":[
],
"event":"reservation.reviews"
}
Booking.com Reservation Reviewed Notification Example
{
"_id":"62d001e7f3a7c7ba7e016a10",
"externalReviewId":"test_3",
"accountId":"5db59615f6fc3b001f8ee56f",
"channelId":"bookingCom",
"complexId":null,
"createdAt":"2022-07-14T08:34:25.000Z",
"createdAtGuesty":"2022-07-14T11:38:27.840Z",
"externalComplexId":"6848541",
"externalListingId":"684854101",
"externalReservationId":"3117555697",
"guestId":"62bff1d5cd6ede0033a88cb9",
"listingId":"5f90114acc5b51002979b1e0",
"rawReview":{
"created_timestamp":"2022-10-06 14:10:36",
"reply":null,
"url":"https://supply-xml.booking.com/review-api/properties/7080721/reviews/EYg--v5_ktg",
"scoring":{
"staff":10,
"clean":10,
"facilities":10,
"comfort":10,
"review_score":9,
"value":10,
"location":10
},
"last_change_timestamp":"2022-10-06 14:41:37",
"reviewer":{
"is_genius":true,
"country_code":"us",
"name":"Lindsey"
},
"reservation_id":"3419318722",
"review_id":"EYg--v5_ktg",
"content":{
"negative":"You could hear street traffic pretty badly from the bedroom. It wasn’t anything that stopped us sleeping but any light sleeper would be bothered. \nOverflow parking is a nightmare. If you’re coming back late at night and have to cross a dark bridge that also opens down to walk next to a river, it’s terrifying and dangerous. This either needs a lot more lighting and signs to indicate it’s actually where we should park, or guests unfamiliar with your area should get a special parking by the building.",
"language_code":"en-us",
"positive":"The little things like paper towels, cooking utensils, and soaps just made the stay a whole lot easier. It was super close to the center we had an event at. The guide to getting in the place was so straightforward.",
"headline":"Really relaxing."
}
},
"reservationId":"62bff1d6b36c21003322c233",
"updatedAt":"2022-07-14T08:59:40.000Z",
"updatedAtGuesty":"2022-07-14T11:40:28.309Z",
"reviewReplies":[
],
"event":"reservation.reviewed"
}
Updated almost 2 years ago