BookingSync provides the ability to integrate with the Inbox on multiple different channels/platforms we support. This guide will present how to implement this integration.
The purpose of this feature is to provide a seamless integration between internal messaging systems in certain Channels and the BookingSync platform, for property managers to be able to communicate with guests in a centralized location.
When a Booking is created on the following channels: (Booking.com, Airbnb), a corresponding Inbox Conversation is automatically created on our system, which is synchronized with the Channel’s internal messaging systems.
When an Inbox Conversation is created via a Channel, at least one Client Inbox Participant will be added to the conversation automatically. A Host Inbox Participant may or may not be created via the Channel automatically. Refer to Managing Inbox Participants.
There are multiple ways to fetch an existing Inbox Conversation.
conversationsfield, you could then query the Inbox Conversations endpoints with the provided ids to get Inbox Conversations related to a certain Booking.
To discern which Channel this Inbox Conversation is associated with, you can check
created_by_type attributes of the Inbox Conversation.
created_by_type should be
created_by_id should refer to the Application id. Applications can be identified in Applications endpoint.
It is important to take into account that Inbox Conversations may not be created right away with the Booking, as there could be a delay. It can be beneficial to subscribe to
inbox_conversation_created webhooks (Refer to Webhook subscriptions guide) and/or have periodic polling (Refer to updated_since flow) on the Booking to be notified when the associated Inbox Conversation is created.
WARNING: Please refrain from creating a new Inbox Conversation as it will not be synchronized to the Channel’s messaging system.
After fetching the Inbox Conversation, you could query Inbox Participants endpoints to see the available Inbox Participants and which conversations are they assigned.
You could also use the Inbox Conversations endpoints with
include=participants query to directly inject the associated participants while fetching the Inbox Conversation.
To add a new Host Inbox Participant, please use the Create a new Participant endpoint.
Note: Channels may or may not add a Host Inbox Participant to the created Inbox Conversation. You may have to manage which User has a corresponding Host Inbox Participant in a certain Inbox Conversation.
Note: Please refrain from creating Client Inbox Participants on Channel created conversations, as they are entities managed by the Channel and the Channel only.
Please refer to the Inbox Message endpoints