Customer messaging
Customer messaging
Section titled “Customer messaging”Enable guests to send messages to the property and receive replies, by connecting your chatbot or instant messaging app into the customer messaging system of Mews Operations.
You can do this through the API with the Messages collection of API operations, in conjunction with the MessageAdded General Webhook.
Message threads or conversations are initiated by the customer (the guest). The customer messages are then sent through to the property, where employees are notified and can quickly respond with a message reply added to the thread. The typical workflow is as follows:
- Customer creates a message within your app
- Your app creates a new message thread in Mews
- Your app listens for MessageAdded events
- Continue the conversation!
1. Customer creates a message within your app
Section titled “1. Customer creates a message within your app”The customer (the guest) creates an instant message within your app, directed to the property.
Penelope:
"Hi! I just wanted to let you know I will be arriving late tonight"
2. Your app creates a new message thread in Mews
Section titled “2. Your app creates a new message thread in Mews”Your app creates a new message thread in Mews and adds the customer message to the thread. Use Add message thread to create a new message thread, then Add messages to create a new message within the thread.
‘How to’ use case | API Operations |
|---|---|
| How to create a new message thread | Add message thread |
| How to create a new message within a thread | Add messages |
3. Your app listens for MessageAdded events
Section titled “3. Your app listens for MessageAdded events”To get message responses in near real time, listen to the MessageAdded General Webhook event.
When a MessageAdded event is received, the event will contain the ID of the newly added message and the ID of the message thread or conversation to which the message belongs.
Messages sent in reply by the property have the Sender property set to “Enterprise” (in the API, we use term ‘enterprise’ rather than ‘property’).
The text of the message can be passed on to the customer through your app. See Webhooks for details of how to set up Webhooks.
‘How to’ use case | API Operations |
|---|---|
| How to listen for new customer messages | General Webhooks (MessageAdded event) |
Property:
"Hello Ms Penelope! Thank you for contacting us. What time do you expect to arrive?"
4. Continue the conversation!
Section titled “4. Continue the conversation!”You can pass messages back and forth, as above, until the conversation is resolved. And if you need to search or fetch your messages or your message threads, you have the Get all messages and Get all message threads API operations.
‘How to’ use case | API Operations |
|---|---|
| How to get messages for your message threads | Get all messages |
| How to get your message threads | Get all message threads |
Penelope:
"Around 11pm. Please hold my room, thank you."> Property:"Your room will be ready for you, travel safely and we look forward to welcoming you around 11pm."
Testing your integration
Section titled “Testing your integration”Please refer to our general Usage guidelines for testing integrations.
Further information
Section titled “Further information”Help Guides: