Connect & Sync is where you link a Property Management System (PMS), a channel manager, or an OTA account to Duve, and where you check that the connection is still running. Each connection is called a sync source. Duve reads your rentals and your future reservations from the source, and, on integrations that support it, writes information back.
You can connect more than one source to the same account, and give each one a nickname so it is easy to tell apart in the list.
Find it at Settings, General, Connect & Sync: frontdesk.duve.com/settings.
Use cases
- Connect your PMS or channel manager when you first set up Duve, so reservations and rentals flow in automatically.
- Check that reservations are still arriving, by looking at when the source last synced.
- Connect an OTA messaging connection (Airbnb, Booking.com, Expedia) so OTA reservations and guest messages reach Duve.
- Add a second source when you manage properties across more than one system.
- Replace your existing source when you migrate to a different PMS.
- Turn specific write-back permissions on or off, for example writing check-in status or guest documents back to the PMS.
Before you start
- You need the Manager role. Other roles do not see Connect & Sync.
- You need credentials for the system you are connecting. What that means differs per provider: an API key and secret, a user and password, a property or hotel code, an OAuth sign-in, or a list of iCal URLs.
- Some providers also need a step on their side first, such as enabling the Duve integration or inviting Duve as a user. The connect screen for each provider links to its own setup guide.
Reading the connections list
The table lists every connected source, one row each. It has four columns.
- Booking Source: the name of the PMS, channel manager, or OTA. If you gave the source an internal nickname, it appears in parentheses after the name.
- Username/ID: the user or account identifier Duve connects with. It is blank for integrations that do not use one, such as Duve Connect and Uplisting.
- Last Sync: the date and time the source last synced into Duve. On a healthy connection this is usually within the last 10 to 15 minutes.
- Status: Active, Waiting, or Inactive. Active means the source is connected and syncing.
Select any row, or the arrow at the end of it, to open that source and see its details.
OTA connections used for guest messaging are listed on their own sub-tab, OTA Messaging, rather than here. That tab shows the same table without the Last Sync column.
How to add or replace a source
Select Add or Replace Source under the table. You get two options.
Add New Source
- Select Add New Source. The connect screen opens.
- Pick your PMS, channel manager, or OTA from the list. The list is alphabetical and covers more than 100 integrations.
- Fill in the credential fields. They change per provider, so follow the labels on screen and the provider guide linked there.
- Select Verify if the provider requires it. Duve checks the credentials against the provider before letting you save.
- Review the sync permissions under What we sync, and turn the optional write-back permissions on or off.
- Save. The source appears in the list, and the first sync starts.
If your account has no PMS, you can still bring reservations in with iCal links. Airbnb, Vreasy, SuperControl, iPro Software, AvaiBook, and Hostify are available as iCal integrations, where you paste one listing URL per rental instead of entering credentials.
Replace Existing Source
Use this when you are moving from one PMS to another. Selecting it opens a warning first, because replacing a source affects existing reservations and matched rentals.
- Select Replace Existing Source.
- Read the warning and open the linked article, Changing your Integration Source, before you continue.
- Complete the steps in that article.
- Select Done and ready. The connect screen opens, and you add the new source as above.
Source details and settings
Opening a source shows its connection details and the settings you can change. What appears depends on the integration, so not every account sees every item.
- Internal nickname: a name only your team sees, useful when you run several sources of the same type.
- Credentials: the fields you connected with. You can update them and verify again.
- Last API Request: when Duve last sent information back to the provider. It appears on two-way integrations only, so a one-way connection does not show it.
- Status: switch the source between Active and Inactive. An inactive source stops syncing but is not deleted.
- Brand and tags: on supported integrations, assign the source to a brand and apply tags, so reservations arrive already sorted.
- Property matching: match the rentals in your source to the properties in Duve when they are not matched automatically.
- Webhooks: the webhook URL to configure on the provider side, on integrations that push to Duve.
- Provider-specific settings: extra switches and fields that only apply to one integration, for example syncing door codes from Guesty locks, or selecting your Protel integration version.
- Disconnect: removes the source from your account.
Note: If you connect Protel On Premise or Protel Air on version 1, some features that need live availability stay blocked until you move to version 2. The source screen shows a banner when this applies.
Syncing manually
Syncing runs automatically. The buttons on the source screen are there for the times you need an update right away.
- Sync Now: pulls recent changes from the source.
- Full Sync: re-pulls everything the integration exposes, including older reservations. It takes much longer and puts load on both systems.
Use these only when you need to. Running a full sync repeatedly, or on several sources at once, slows the sync for your whole account.
The sync buttons do not appear when:
- The source status is not Active.
- The connection is one-way.
- The integration does not support manual syncing. This is the case for the OTA connections (Airbnb, Booking.com, Expedia) and for PMSs connected through SiteMinder, where the provider controls when data is sent.
What we sync
Every source screen has a What we sync section. It is the authoritative list for that integration: it is built from what the provider actually supports, so the exact items differ from one source to the next.
Read-only permissions
These apply to every integration and cannot be turned off.
- Your rentals info: the rentals, rooms, or listings defined in your source, so Duve knows what you manage.
- Future reservations: upcoming reservations and their guest details, so Duve can run the guest journey.
Write permissions
These appear only on two-way integrations, and only the ones your provider supports. Basic two-way connection is the master switch: turn it off and the rest are hidden.
- Basic two-way connection: Duve writes guest and reservation updates back to your source, for example check-in details completed in the Guest app.
- Upload documents connection: Duve uploads guest documents, such as ID scans and signed registration forms, to the reservation in your source.
- Chat connection: guest messages sync both ways between Duve and your source.
- Guest orders connection: upsell and service orders placed by guests are written back to your source.
- Audit messages log: Duve writes a log of its messages to the reservation record.
- Overwrite guest info: Duve updates guest details that already exist in your source. Turn it off to keep your source as the master record.
- OTA two-way communications: messages sync with the OTA for reservations that came from one.
- Inquiry messages: pre-booking inquiry messages sync as well, on Airbnb.
Writing reservation statuses back (such as pre-checked-in or checked-out) needs two things: an integration that supports status updates, and that permission enabled on your account. If either is missing, the option does not appear.
Troubleshooting
- Last Sync is hours old: Check that Status is Active. If it is, open the source, verify the credentials, and run Sync Now. Credentials that were rotated on the provider side are the most common cause.
- A new reservation is missing: Confirm the rental it belongs to is matched to a property in Duve. Unmatched rentals bring nothing in.
- Rentals from the provider do not load on the source screen: This is usually a temporary provider error. Try again, and contact support if it persists.
- Nothing is written back to the PMS: Check that Basic two-way connection is on (if exists), and that the specific permission you expect, such as upload documents, is also on.
Restrictions and limitations
- Connect & Sync lives in the main account settings only. It does not appear in sub-brand settings.
- Only the Manager role can open the page.
- Some integrations are read-only. On those, no write permissions are offered at all.
- Manual syncing is not available for OTA connections or for PMSs connected through SiteMinder.
- Airbnb reservations are handled differently from the rest, because Airbnb restricts contacting guests and collecting reviews off-platform. For those reservations Duve does not send the confirmation email or standard chat messages, and hides the satisfaction, review, rating, and instruction pages.
Tips and tricks
- Give every source an internal nickname when you run more than one. The nickname shows next to the provider name in the list, and it is the quickest way to tell two Guesty accounts apart.
- Turn off Overwrite guest info if your PMS should stay the master record for guest details.
- Reach for Sync Now before Full Sync. A full sync is rarely what you need, and it slows syncing for the whole account while it runs.
FAQs
Q: Can I connect more than one PMS or channel manager?
A: Yes. Add as many sources as you need, and give each one an internal nickname so you can tell them apart.
Q: Can I connect Airbnb, Booking.com, or Expedia?
A: Yes. They connect as OTA sources, and the ones used for guest messaging appear on the OTA Messaging sub-tab. Airbnb can also be connected with iCal links if you only need the reservation dates.
Q: What is the difference between Sync Now and Full Sync?
A: Sync Now pulls recent changes. Full Sync re-pulls everything the integration exposes, takes much longer, and should be used only when support asks for it or data is clearly missing.
Q: Why can I not see the sync buttons?
A: They are hidden when the source is not Active, when the connection is one-way, and on integrations that control their own sync schedule, such as OTAs and SiteMinder.
Q: Why can I not see the page at all?
A: Connect & Sync needs the Manager role, and it exists only in the main account settings, not in sub-brand settings.
Q: I am switching PMS. What should I do?
A: Use Replace Existing Source rather than simply adding the new one, and follow the Changing your Integration Source article before you connect.
Q: Will connecting a source overwrite the guest details already in my PMS?
A: Only if Overwrite guest info is on. Turn it off to keep your PMS as the master record.
Comments
0 comments
Article is closed for comments.