Duve's Marketing Consent Management lets your guests opt out of marketing emails, SMS, and WhatsApp messages with a single link, while you keep their preferences in sync across Duve, your PMS, and any external CRM. It works for simple setups that rely only on Duve, as well as for advanced setups that sync consent in real time through DuveConnect webhooks. The result is cleaner guest communication and stronger compliance with global marketing regulations.
Quick navigation:
- Use cases
- Before you start
- How it works
- How to set it up
- Unsubscribe keywords
- Host experience
- Guest experience
- Supported PMSs
- Working with an external CRM and DuveConnect
- Notifications
- Restrictions & Limitations
- Tips & Tricks
- FAQs
- Related articles
Use cases
- Give guests an easy, compliant way to opt out of marketing messages on any channel.
- Send scheduled marketing messages only to guests who are subscribed.
- Keep marketing consent aligned between Duve and your PMS.
- Push unsubscribe updates to an external CRM or marketing platform in real time.
- Get notified whenever a guest unsubscribes, or when a sync to your external system fails.
Before you start
- Decide whether Duve or an external system will be the main record of guest consent.
- If you plan to use an external CRM, make sure DuveConnect is set up for your account.
- If you want consent to sync with your PMS, check that your PMS appears in the "Supported PMSs" section below.
How it works
Duve supports two levels of marketing consent:
- Basic Marketing Consent: The default consent field in Duve. It updates the existing opt-in marketing field, can sync with supported PMSs, and is used for opt-in during online check-in and for unsubscribe actions.
- External Marketing Consent: A separate consent field designed to sync with external marketing systems (such as a CRM) through webhooks.
Consent is tracked per contact method (email or phone) and per communication channel. Guests unsubscribe through a dedicated page that opens when they click the {{unsubscribeLink}} dynamic link in your message.
How to set it up
Step 1: Choose your Primary Source
-
Go to Settings > Communication > Marketing Consent.
- Under "Where should guest opt-in/out actions be recorded?", select your Primary Source:
- Basic: Duve determines the guest's unsubscribe status.
- External: An external source connected through DuveConnect determines the guest's unsubscribe status.
All guest opt-in and opt-out requests are recorded in the Primary Source only. You can still use both Basic and External consent in other places (for example, as filters in Scheduled Messages), but only one can be the Primary Source.
Step 2: Import or export existing consent data (optional)
You can import or export consent data for either source at any time.
- On the Marketing Consent settings page, click the ellipsis (...).
-
Select Import or Export.
- To replace all existing data, follow the on-screen prompt.
Step 3: Set your Unsubscribe Impact
Choose how far an unsubscribe reaches:
- Channel-specific (default): The unsubscribe applies only to the exact contact method the guest used.
-
Global: If a guest unsubscribes through one contact method, all methods are blocked for marketing.
Step 4: Add the unsubscribe link to your marketing messages
The unsubscribe link is not added automatically. Insert the dynamic variable {{unsubscribeLink}} into every marketing email, SMS, and WhatsApp template.
For emails built in the Email Editor (Scheduled Messages), add {{unsubscribeLink}} in a new text box in the template so the link appears to guests.
Step 5: Filter Scheduled Messages by consent
To send marketing messages only to opted-in guests, add a condition such as Marketing Consent is Subscribed to your Scheduled Messages.
Make sure the condition matches your Primary Source:
- If your Primary Source is Basic, add the Basic Marketing Consent condition.
-
If your Primary Source is External, add the External Marketing Consent condition.
You can also use the same filter in the Communication Hub.
Unsubscribe keywords
Guests can opt out of SMS and WhatsApp marketing by replying with a predefined keyword. Duve checks every incoming SMS and WhatsApp message for an exact keyword match (not case-sensitive, extra spaces ignored). Keywords are recognized in all supported languages, regardless of the guest's default language.
Set up unsubscribe keywords
- Go to Settings > Communication > Marketing Consent.
-
Switch Enable keyword unsubscribe detection from Disabled to Enabled.
- Edit the auto-response message that guests receive after they reply with a keyword. Include
{{unsubscribeLink}}so guests can confirm and manage their preferences, and use the built-in translation tool to translate it. -
In your marketing messages, add
{{unsubscribeKeyword}}to tell guests which keyword to reply with. For example: "To unsubscribe, reply with: {{unsubscribeKeyword}}". You can add it in the Communication Hub, Reservation Chat, WhatsApp templates, and Scheduled Messages.
Supported keywords
Guests must reply with the keyword only. A reply such as "please unsubscribe me" is not detected.
- Arabic: إلغاءالاشتراك
- Chinese: 退订
- Czech: odhlásit
- Dutch: uitschrijven
- English: unsubscribe
- Finnish: perutilaus
- French: sedésinscrire
- German: abbestellen
- Greek: διαγραφή
- Hebrew: הסר
- Indonesian: berhentilangganan
- Italian: disiscriversi
- Japanese: 購読解除
- Korean: 수신거부
- Norwegian: avsluttabonnement
- Polish: wypisz
- Portuguese: cancelarassinatura
- Romanian: dezabonare
- Russian: отписаться
- Slovenian: odjava
- Spanish: baja
- Thai: ยกเลิกการสมัคร
- Vietnamese: hủyđăngký
Host experience
Viewing a guest's consent on the Reservation page
- Open the reservation.
- Click the ellipsis (...) in the top-right corner.
-
Select Marketing Preferences.
A pop-up shows the guest's current consent status, and lets staff update it. The reservation logs show unsubscribe events, including keyword replies and updates that came from the PMS or from an external CRM through DuveConnect.
Guest experience
- The guest clicks the unsubscribe link in your message.
- A dedicated unsubscribe page opens.
-
The guest clicks Unsubscribe. They are unsubscribed according to your Unsubscribe Impact setting (channel-specific or global).
-
A confirmation page appears.
Unsubscribing with a keyword:
-
The guest replies to any SMS or WhatsApp message with an unsubscribe keyword.
- The guest receives your auto-response message and clicks the link in it.
-
The guest confirms the unsubscribe. Their status is updated in the Basic or External consent field, based on your Primary Source.
Supported PMSs
Sync in (Duve reads the opt-in marketing status from the PMS):
- Cloudbeds
- Guestline
- Infor
- Mister Booking
- OHIP
- Opera 5.6 (On-Prem and Cloud)
- Protel (On-Prem and Air)
- Silverbyte (Optima 1)
- StayNTouch
- Thais
Sync out (Duve pushes the opt-in marketing status to the PMS when the guest completes online check-in):
- Cloudbeds
- Infor
- Mister Booking
- OHIP
- Opera 5.6 (On-Prem and Cloud)
- Protel
- Silverbyte (Optima 1)
- Thais
Working with an external CRM and DuveConnect
With DuveConnect, you can keep marketing consent in sync between Duve and your CRM in both directions. For more details, see the DuveConnect article.
Outgoing webhooks (Duve to your CRM)
Create an outgoing webhook using one of these triggers, and include the matching data point so the consent status is sent to your endpoint URL:
-
Trigger: Basic marketing status updated. Include the data point Basic marketing consent.
-
Trigger: External marketing status updated (fires when Duve receives an external marketing status from an external provider). Include the data point External marketing consent.
Incoming webhooks (your CRM to Duve)
To let your CRM update the marketing consent status in Duve:
- Create an incoming connection in DuveConnect.
-
Set the connection type to Marketing Consent.
- Copy the code snippet and use it in your CRM to send webhooks to Duve.
Notifications
Duve can email your team in two cases:
-
Unsubscribe notifications: When a guest unsubscribes from marketing through Duve.
-
Webhook error notifications: When pushing a webhook to your external source fails.
To set up recipients, go to Settings > General > Notification Emails and add the relevant addresses under Unsubscribe Notification Mails.
Restrictions & Limitations
- No guest resubscribe option: Once a guest is unsubscribed, their status changes only if the guest opts in again (for example, during their next online check-in), a staff member updates it in Marketing Preferences, or a verified external system sends a webhook.
-
No automatic link insertion: You must add
{{unsubscribeLink}}to each marketing message yourself. - No short links for SMS or WhatsApp: Unsubscribe links are not shortened automatically. Use an external link shortener if needed.
- Account-level settings only: Consent settings apply to the whole account. Brand-level and property-level settings are not available yet.
- Keywords: predefined only. Custom keywords are not supported.
- Keywords: SMS and WhatsApp only. Keyword detection does not work for incoming emails or other channels.
- Keywords: no short codes. SMS short codes can't receive guest replies, so keyword unsubscribes won't work from them.
- Keywords: replies blocked by SMS settings. If enabled in an SMS Scheduled Message, guests can't reply to that message by SMS to unsubscribe.
Tips & Tricks
- Always include
{{unsubscribeLink}}in SMS messages and in the keyword auto-response. Without it, guests can't reach their marketing preferences. - Pair
{{unsubscribeKeyword}}with a short instruction line so guests know exactly what to reply.
FAQs
Q: Can I use Basic and External consent at the same time?
A: Yes. You can use both (for example, as filters in Scheduled Messages), but only one can be the Primary Source where guest opt-in and opt-out actions are recorded.
Q: What is the difference between channel-specific and global unsubscribe?
A: Channel-specific blocks marketing only on the contact method the guest used to unsubscribe. Global blocks marketing on all of the guest's contact methods.
Q: A guest unsubscribed by mistake. How do they resubscribe?
A: A staff member can resubscribe them manually from the Marketing Preferences pop-up on the Reservation page, or the guest can opt in again during their next online check-in.
Q: Why is a guest who unsubscribed still receiving marketing messages?
A: Check that your Scheduled Messages include a Marketing Consent condition, and that the condition matches your Primary Source (Basic or External).
Q: A guest replied "unsubscribe" but nothing happened. Why?
A: Check that keyword detection is enabled, that the guest replied with the keyword only, and that the message was sent by SMS or WhatsApp from a regular number (not a short code).
Q: Does the guest have to use the keyword in their own language?
A: No. Keywords in all supported languages are recognized for every guest, regardless of their default language.
Q: How do I know if my CRM sync failed?
A: Duve sends a notification email when a webhook to your external source fails. Make sure recipients are set under Settings > General > Notification Emails.
Comments
0 comments
Article is closed for comments.