Webhooks Events

Review Updated

This event is triggered when a review is updated. This can happen in one of these cases:

  • One or more attributes of a review have been updated (including a content or rating update from its author)
  • A tag has been assigned or unassigned to this review on Partoo
  • A review has been deleted - this could happen in two ways (see more info below):
    • Permanently, by the author.
    • Temporarily unavailable due to a bug in Google’s system
  • If a review reappears after being temporarily unavailable

⚠️ More info on review deletes:

Because of a bug in Google’s system, some reviews may temporarily disappear from their data as if they were deleted, even though they were not, and then reappear later.

When a review goes missing, we cannot determine whether it was actually deleted or just affected by this bug. We must consider this review as if it can reappear in the future. For that reason, a review_updated event will be sent in both cases.

Here is a sample scenario:

  • September 4: A review is edited by its author.
    • A review_update event is triggered, showing the review updated content.
  • September 10: The review disappears due to the Google bug.
    • Another review_update event is triggered, with the review state set at deleted
  • September 15: The review becomes visible again.
    • Another review_update is then triggered, showing the review state before the soft delete
postWebhookreviewUpdated

Payload

type'review_updated'

Example payload

{
  "payload": {
    "review": {
      "org_id": 42,
      "id": 34,
      "business_id": "5409c35a97bbc544d8e26737",
      "partner": "google_my_business",
      "partner_id": "accounts/114063712393225091258/locations/74805271119400652054",
      "author_name": "Castorche",
      "date": "2017-07-01T16:10:23.156000+02:00",
      "update_date": "2017-08-01T19:15:54.256000+02:00",
      "rating": 3,
      "content": "Magasin un peu vieillot , mais personnel très sympathique, nombreuses références en rayons , un très bon choix côté vin...",
      "comments": [
        {
          "id": 82938,
          "partner_id": "accounts/114063712393225091258/locations/74805271119400652054",
          "created": "2019-08-01T19:15:54.256000+02:00",
          "author_name": "Castorche",
          "content": "Merci ❤️",
          "date": "2017-08-01T19:15:54.256000+02:00",
          "update_date": "2017-08-01T19:15:54.256000+02:00",
          "can_edit": true,
          "review_id": 34,
          "user_id": "123456789abcdef2f60c42ff"
        }
      ],
      "tags": [
        {
          "id": 25,
          "label": "food",
          "color": "#808080"
        }
      ],
      "media_links": [
        "https://lh3.googleusercontent.com/gpms...",
        "https://lh3.googleusercontent.com/gpms-cs-s/AB8u6HYwO..."
      ]
    }
  }
}

Response

Return a 200 status to indicate that the event was properly received

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.