Connector API
Search…
Messaging
Enable guests to send messages to the enterprise 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 customer messages are then sent through to the enterprise, where employees are notified and can quickly respond with a message reply added to the thread. The typical workflow is as follows:

Step 1: Customer creates a message within your app

The customer or guest creates an instant message within your app, directed to the enterprise.
Penelope: "Hi! I just wanted to let you know I will be arriving late tonight"

Step 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.

Step 3: Your app listens for MessageAdded Webhook events

MessageAdded is a type of 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 enterprise have the Sender property set to "Enterprise". 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.
Enterprise: "Hello Ms Penelope! Thank you for contacting us. What time do you expect to arrive?"

Step 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.
Penelope: "Around 11pm. Please hold my room, thank you."
Enterprise: "Your room will be ready for you, travel safely and we look forward to welcoming you around 11pm."

Testing your integration

Please refer to our general Guidelines for testing integrations.

Further information

For more information about Mews Messaging, the following guides may be helpful. You can also use the Search function to find suitable content in our Help system.
Last modified 4mo ago
Copy link
On this page
Step 1: Customer creates a message within your app
Step 2: Your app creates a new message thread in Mews
Step 3: Your app listens for MessageAdded Webhook events
Step 4: Continue the conversation!
Testing your integration
Further information