Segment on Email Behavior

Build segments from what contacts did with your email: who opened, who clicked, who got email and stayed quiet, and who is most engaged. Needs the Email Behavior Segments feature (part of the Email Growth add-on). If a site does not have it, tell the admin to see their plan under Billing and offer a segment on contact fields or order history instead.

Conditions

In Contact Center, Segments, pick the Email behavior group:

• Opened an email within (days). Value 30, or 30@b123 for broadcast 123 or 30@d123 for automated sequence 123 (they are numbered separately, so always use the letter; a bare 30@123 is the older form and matches either kind).
• Clicked a link within (days). Same value format.
• Received email but did not open within (days). Only contacts who were delivered email.
• Received email but did not click within (days). Only contacts who were delivered email.
• Engagement events is at least. Value 3, or 3@60 to set the window in days (90 if left off). Counts opens, clicks, form submissions and site visits.

A contact with no engagement history never matches. A value in the wrong format is rejected with an explanation and the segment is not saved.

Examples

• Engaged this month: Opened an email within 30 days
• Win-back: Received email but did not open within 90 days
• Hot audience: Engagement events is at least 5 with a 30 day window

Best send hour

Each contact's most common open hour can be read from the CLI (velaro contact-segment send-time <email>), the MCP (contact_segment_send_time_get) or the API. It is information only; nothing is scheduled from it yet.

Ask Moshky or the bot to build it

The Build Contact Segment skill accepts these same fields and value formats. Re-running it with the same segment name updates that segment.

Automate it

REST: ContactSegments (conditions with the field values opened_campaign_since, clicked_campaign_since, not_opened_since, not_clicked_since, engagement_count_gte), and ContactSegments/engagement/ for per-contact events and send hour. CLI: velaro contact-segment. MCP: the contact_segment_ tools.