Outbound message restricted-word masking (SmartBot cloud layer)
When ezConnect sends an outbound SMS or WhatsApp message, Zenoti checks the destination phone number against a country-specific list of restricted words before the message reaches the carrier. Any restricted word found in the message body is masked automatically so the message is delivered rather than dropped. This article explains how the masking behavior works and what alerts you should expect when masking occurs.
Audience: ezConnect agents and administrators who send outbound SMS or WhatsApp messages and need to understand why certain words appear masked in sent messages.
Before you begin
- Your organization must have ezConnect enabled and configured.
- You must have the Enable permission under Module Access to access the ezConnect application.
- Masking applies only to outbound carrier-routed messages — SMS and WhatsApp. Facebook Messenger and Instagram conversations are not subject to this filtering.
- The destination phone number must be in E.164 format for country detection to work. If the number cannot be parsed, the message is sent unmasked.
Permission: You need the Enable permission under Module Access to access ezConnect and send outbound messages.
Steps
Understand how restricted-word masking works
Zenoti applies country-specific restricted-word masking at the point of outbound message delivery. The following explains the end-to-end behavior.
Country detection from the destination phone number
When you send an outbound SMS or WhatsApp message, Zenoti parses the destination phone number in E.164 format and derives the ISO 3166 country code from it. The country code — not your center locale, language preference, or agent settings — determines which restricted-word list applies.
Note: The same word may be permitted in one country and restricted in another. The carrier is determined by the phone number alone.
Word matching and masking
Once the applicable country list is identified, Zenoti scans the outbound message body for each restricted word. When a match is found, the word is replaced using the following pattern:
- The first character of the word is preserved.
- All remaining characters are replaced with asterisks.
- The masked word is delivered in lowercase.
For example, if a restricted word is
Casino, it appears in the delivered message asc*****.The message is still sent — masking prevents the carrier from dropping the message, not from delivering it.
Unresolvable phone numbers
If the destination phone number cannot be parsed to a valid country code, Zenoti treats the message as having no applicable filter list and sends it through unmasked. No error is raised to the agent.
Recognize the masking alert
When one or more restricted words are masked in a sent message, Zenoti surfaces an alert. No alert appears when no restricted words are matched.
Use this alert as a signal to review whether your message content or the words in your generation prompt need adjustment. If you see the alert frequently for a specific term, contact your administrator to evaluate whether the restricted-word list for that country should be updated.
Note: The alert is informational — the message was delivered. No action is required to resend.
Review and tune your message content
- When you see a masking alert after sending a message, note which words appeared masked in the conversation.
- Review the message text for terms that may be consistently flagged.
- If you author messages using a SmartBot-generated prompt, adjust the generation prompt to avoid words that are frequently masked for your guests' regions.
- If you believe a word is incorrectly restricted for your organization's use case, contact your administrator. Administrators can request a review of the country-specific restricted-word configuration through your Zenoti account representative.
Tip: For details on SmartBot AI chatbot configuration and capabilities, see SmartBot overview.
Tips
- Check the destination country before drafting messages. If your guest base spans multiple countries, a term that works in one region may be masked in another. Review the guest's phone number country code when crafting messages for guests in regions with stricter carrier restrictions.
- Use saved responses for tested content. Saved responses that have been sent successfully to guests in specific regions are less likely to trigger masking. Build a library of approved saved responses for high-restriction countries. For guidance, see Saved responses and macros.
- Treat masking alerts as tuning signals. Each alert tells you that a word in your message was carrier-restricted for that guest's country. Over time, tracking which words trigger alerts for which regions helps you refine your messaging style and generation prompts.
- Do not resend unmasked content manually. If a word was masked, the carrier restriction applies regardless of how the message is composed. Rewriting the message to circumvent masking may cause the message to be dropped at the carrier level.
Troubleshooting
The guest received a message with words replaced by asterisks, but I did not see a masking alert.
Confirm that you are viewing the conversation in the same ezConnect session in which the message was sent. Alerts are surfaced at send time. If you sent the message in a previous session, the alert may no longer be visible. The masking itself is recorded in the delivered message body.
A word I expected to be masked was delivered unmasked.
The most likely cause is that the destination phone number could not be resolved to a valid country code. When Zenoti cannot parse the phone number into a country code, it treats the message as having no applicable restricted-word list and sends the content through without masking. Verify that the guest's phone number is saved in E.164 format in their profile.
I see masking alerts for every message I send to guests in a specific country.
Your message content or generation prompt likely contains a word that appears on the restricted list for that country. Review the words that are consistently masked and revise your standard messaging or saved responses to use alternative phrasing. If the flagged word is business-critical for your organization, contact your Zenoti account representative to request a review of the restricted-word configuration for that country.
The masking alert appeared, but the guest says they did not receive the message.
Masking alone does not prevent delivery — the message is sent with the masked word in place. If the guest did not receive the message, the issue is likely unrelated to restricted-word filtering. Check whether the guest's phone number is valid, whether the channel (SMS or WhatsApp) is active for your center, and whether WhatsApp consent is in place if you sent a WhatsApp message.