Proactive messaging conditions and events reference

<body>
<p id="docs-hc-snippet" style="display: none;">Conditional statements define the actions that trigger a proactive message for a user, and when those actions should be evaluated.</p>
<div class="article-banners">
<div id="docs-wmp-link">
<a href="https://support.zendesk.com/hc/en-us/articles/5411234991258-plan" rel="noopener" target="_blank">What's my plan?</a>
</div>

<div class="article-banner" id="suite_all">
<table>
<tbody>
<tr>
<td>
<strong>All Suites</strong>
</td>
<td>Team, Growth, Professional, Enterprise, or Enterprise Plus</td>
</tr>
</tbody>
</table>
</div>

</div>

<div class="body">

<p class="p">Conditional statements define the actions that trigger a proactive message for a user,
and when those actions should be evaluated.</p>
<p class="p">Conditional statements for proactive messaging follow this basic configuration:</p>
<div class="p">
<ul class="ul" id="topic_fnx_rbs_wwb__ul_dpj_rs5_wwb">
<li class="li">An <strong class="ph b">object</strong> is selected for evaluation.</li>
<li class="li">A <strong class="ph b">condition</strong> is created for that object. The condition consists of a
condition field, an operator, and a value.</li>
<li class="li">An <strong class="ph b">event</strong> is created that defines when the conditonal statement is
checked.</li>
</ul>
</div>
<p class="p">This article includes the following sections:</p>
<div class="p">
<ul class="ul" id="topic_fnx_rbs_wwb__ul_pdh_rzt_wwb">
<li class="li"><a class="xref" href="#topic_ad3_n15_wwb">Objects</a></li>
<li class="li"><a class="xref" href="#topic_vvc_hk5_wwb">Conditions</a></li>
<li class="li"><a class="xref" href="#topic_sws_bp5_wwb">Events</a></li>
<li class="li"><a class="xref" href="#topic_avf_rgy_wwb">Key points</a></li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_ad3_n15_wwb">
<h2 class="title topictitle2" id="ariaid-title2">Objects</h2>
<div class="body">
<p class="p">Choose from the objects in the table below to begin building a condition. The type of
object you select determines what <a class="xref" href="#topic_vvc_hk5_wwb">condition fields</a> you can choose.</p>
<div class="p">
<table border="1" cellpadding="4" cellspacing="0" class="simpletable" id="topic_ad3_n15_wwb__simpletable_gzg_vp5_wwb" summary="">
<col style="width:15.503875968992247%">
<col style="width:84.49612403100775%">
<thead>
<tr class="sthead">
<th class="stentry" id="d51e103" style="vertical-align:bottom;text-align:left;">Object</th>
<th class="stentry" id="d51e106" style="vertical-align:bottom;text-align:left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="strow">
<td class="stentry" headers="d51e103" style="vertical-align:top;">Visitor</td>
<td class="stentry" headers="d51e106" style="vertical-align:top;">A customer, or end user, visiting your channel. Selecting this
object allows you to look at the customer's location or
visit history.</td>
</tr>
<tr class="strow">
<td class="stentry" headers="d51e103" style="vertical-align:top;">Device</td>
<td class="stentry" headers="d51e106" style="vertical-align:top;">The computer or mobile device used to access your channel.
Selecting this object allows you to evaluate the device's language
settings in the condition. </td>
</tr>
<tr class="strow">
<td class="stentry" headers="d51e103" style="vertical-align:top;">Metadata</td>
<td class="stentry" headers="d51e106" style="vertical-align:top;">Information about the customer's business. Business metadata is
currently only available for the Web Widget channel.</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_vvc_hk5_wwb">
<h2 class="title topictitle2" id="ariaid-title3">Conditions</h2>
<div class="body">
<p class="p">Choose from the condition fields in the table below to complete your condition.</p>
<div class="p">
<table border="1" cellpadding="4" cellspacing="0" class="simpletable" id="topic_vvc_hk5_wwb__simpletable_m1z_kr5_wwb" summary="">
<col style="width:14.897260273972604%">
<col style="width:8.561643835616438%">
<col style="width:30.222602739726028%">
<col style="width:20.63356164383562%">
<col style="width:25.684931506849317%">
<thead>
<tr class="sthead">
<th class="stentry" id="d51e157" style="vertical-align:bottom;text-align:left;">Condition field</th>
<th class="stentry" id="d51e160" style="vertical-align:bottom;text-align:left;">Object</th>
<th class="stentry" id="d51e163" style="vertical-align:bottom;text-align:left;">Description</th>
<th class="stentry" id="d51e166" style="vertical-align:bottom;text-align:left;">Operators</th>
<th class="stentry" id="d51e169" style="vertical-align:bottom;text-align:left;">Value</th>
</tr>
</thead>
<tbody>
<tr class="strow">
<td class="stentry" headers="d51e157" style="vertical-align:top;">Page URL</td>
<td class="stentry" headers="d51e160" style="vertical-align:top;">Visitor</td>
<td class="stentry" headers="d51e163" style="vertical-align:top;">The URL of a web page, or screen name on a mobile device, the
customer is currently on.<p class="p">The Page URL string is case
insensitive.</p>
</td>
<td class="stentry" headers="d51e166" style="vertical-align:top;">Contains at least one of <p class="p">Doesn't contain</p>
<p class="p">Is</p>
<p class="p">Is
not</p>
</td>
<td class="stentry" headers="d51e169" style="vertical-align:top;">
<code class="ph codeph">String</code><p class="p">Enter all or part of the page or screen
URL to be matched.</p>
</td>
</tr>
<tr class="strow">
<td class="stentry" headers="d51e157" style="vertical-align:top;">Page title</td>
<td class="stentry" headers="d51e160" style="vertical-align:top;">Visitor</td>
<td class="stentry" headers="d51e163" style="vertical-align:top;">The title of the web page or mobile device screen the customer is
currently on.<p class="p">The Page title string is case insensitive.</p>
</td>
<td class="stentry" headers="d51e166" style="vertical-align:top;">Contains at least one of <p class="p">Doesn't contain</p>
<p class="p">Is</p>
<p class="p">Is
not</p>
</td>
<td class="stentry" headers="d51e169" style="vertical-align:top;">
<code class="ph codeph">String</code><p class="p">Enter all or part of the page or screen
title to be matched.</p>
</td>
</tr>
<tr class="strow">
<td class="stentry" headers="d51e157" style="vertical-align:top;">Visit history</td>
<td class="stentry" headers="d51e160" style="vertical-align:top;">Visitor</td>
<td class="stentry" headers="d51e163" style="vertical-align:top;">Customer visit history – are they coming to the website or app for
the first time, or have they visited before? </td>
<td class="stentry" headers="d51e166" style="vertical-align:top;">Is</td>
<td class="stentry" headers="d51e169" style="vertical-align:top;">
<code class="ph codeph">Drop-down</code><p class="p">Select <strong class="ph b">New user</strong> or <strong class="ph b">Returning
user</strong>.</p>
</td>
</tr>
<tr class="strow">
<td class="stentry" headers="d51e157" style="vertical-align:top;">Language</td>
<td class="stentry" headers="d51e160" style="vertical-align:top;">Device</td>
<td class="stentry" headers="d51e163" style="vertical-align:top;">Language or locale of the customer, as determined by the device's
language settings.</td>
<td class="stentry" headers="d51e166" style="vertical-align:top;">Is<p class="p">Is not</p>
</td>
<td class="stentry" headers="d51e169" style="vertical-align:top;">
<code class="ph codeph">Drop-down</code><p class="p">Select the language being matched or
skipped.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title4" class="topic nested1" id="topic_sws_bp5_wwb">
<h2 class="title topictitle2" id="ariaid-title4">Events</h2>
<div class="body">
<p class="p">Choose from the events in the table below to define when the conditions should be
checked.</p>
<div class="p">
<table border="1" cellpadding="4" cellspacing="0" class="simpletable" id="topic_sws_bp5_wwb__simpletable_s55_bv5_wwb" summary="">
<col style="width:21.978021978021978%">
<col style="width:78.02197802197803%">
<thead>
<tr class="sthead">
<th class="stentry" id="d51e301" style="vertical-align:bottom;text-align:left;">Event</th>
<th class="stentry" id="d51e304" style="vertical-align:bottom;text-align:left;">Description</th>
</tr>
</thead>
<tbody>
<tr class="strow">
<td class="stentry" headers="d51e301" style="vertical-align:top;">Visitor loads the page</td>
<td class="stentry" headers="d51e304" style="vertical-align:top;">Checks for the conditions on page load.</td>
</tr>
<tr class="strow">
<td class="stentry" headers="d51e301" style="vertical-align:top;">Visitor is on the page</td>
<td class="stentry" headers="d51e304" style="vertical-align:top;">Checks for the conditions when a customer spends a set amount of
time on the page.</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title5" class="topic nested1" id="topic_avf_rgy_wwb">
<h2 class="title topictitle2" id="ariaid-title5">Key points</h2>
<div class="body">
<div class="p">
<ul class="ul" id="topic_avf_rgy_wwb__ul_t4q_sgy_wwb">
<li class="li" dir="ltr">Admins can create proactive messages with multiple conditions
using AND or OR operators, and can create nested conditions. </li>
<li class="li" dir="ltr">As an admin, if you plan to use two or fewer conditions, you cannot use nested conditions.</li>
</ul>
</div>
</div>
</div>
<script id="docs-schema-markup" type="application/ld+json">{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/5511218058650",
"url": "https://support.zendesk.com/hc/en-us/articles/5511218058650",
"headline": "Proactive messaging conditions and events reference",
"description": "You can define conditions and events to trigger proactive messages based on visitor, device, or metadata attributes and specify when these conditions are evaluated during user interactions.",
"articleSection": "Zendesk messaging",
"datePublished": "2023-03-20T19:32:47+00:00",
"dateModified": "2026-08-27T22:00:25.803801+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/5511218058650"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"@id": "https://support.zendesk.com/hc/"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
}
}</script>
</body>