> For the complete documentation index, see [llms.txt](https://docs.mews.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mews.com/connector-api/use-cases/reputation-management.md).

# Reputation management

Reputation management systems typically require reservation information, customer profile information, and the ability to update customer profiles.

## Retrieving reservations

After a customer has checked out from a reservation, Reputation management systems often send a survey through to a customer's email. The integration partner can request all checked-out reservations for a given period using [Get all reservations](/connector-api/operations/reservations.md#get-all-reservations-ver-2023-06-06) with [reservation state](/connector-api/operations/reservations.md#reservation-state) set to `Processed`. For optimal API usage, ensure cascading time periods with short time frames, e.g. request every 4 hours for the previous 4 hour period. To receive notifications that a reservation has been checked-out, you should use [General Webhooks](/connector-api/events/wh-general.md) (`ServiceOrderUpdated` event) or [WebSockets](/connector-api/events/websockets.md) (`Reservation` event).

| 'How to' use case                         | API Operations                                                                                                                                                   |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| How to get checked-out reservations       | [Get all reservations](/connector-api/operations/reservations.md#get-all-reservations-ver-2023-06-06)                                                            |
| How to listen for changes to reservations | [General Webhooks](/connector-api/events/wh-general.md) (`ServiceOrderUpdated` event) or [WebSockets](/connector-api/events/websockets.md) (`Reservation` event) |

## Updating the customer profile

When a Reputation management system links customer feedback to a customer, use [Update customer](/connector-api/operations/customers.md#update-customer) to update the customer profile in Mews. The [customer classification](/connector-api/operations/customers.md#customer-classification) `PreviousComplaint` should be used when negative feedback has been received. Further to this, keywords from the complaint and a URL to the survey or Tripadvisor post can be added to the customer `Notes` field.

| 'How to' use case                  | API Operations                                                            |
| ---------------------------------- | ------------------------------------------------------------------------- |
| How to update the customer profile | [Update customer](/connector-api/operations/customers.md#update-customer) |

## Testing your integration

Please ensure you follow our general [Usage guidelines](/connector-api/guidelines.md) for testing integrations.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mews.com/connector-api/use-cases/reputation-management.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.