Articles on: Settings & Configuration

Crisp Events and Automated Campaigns

Crisp Events and Automated Campaigns


The application pushes user events to Crisp via the REST API. These events appear in the user's profile in Crisp and can trigger automated campaigns (emails or chat messages).


Events We Push


Event

When

Color

Use Case

user:signup

New user registration

Green

Welcome email, onboarding tips

user:subscription:started

New subscription or plan change

Green

Thank-you email, setup tips

user:subscription:canceled

User cancels (access until period end)

Orange

Retention/挽留 campaign, offer to stay

user:subscription:churned

Subscription period ended (churned)

Red

Win-back campaign

user:onboarding:completed

User finished guided onboarding

Green

Next-steps, feature highlights

user:import:completed

CSV import finished

Green

Tips, follow-up


Event Data


Each event includes optional data (plan, tenant_name, module, stats, etc.) visible in Crisp. Use this for personalization in campaigns.


Setting Up Automated Campaigns in Crisp


  1. Go to Crisp Dashboard campaignsNew CampaignAutomated Campaign
  2. Enter the event name (e.g. user:subscription:canceled) as the trigger
  3. Write your email or chat message
  4. Activate the campaign


Requirements:


  • Custom Email Domain or Custom SMTP verified in Crisp
  • Event names must match exactly (case-sensitive)


Example Campaigns


  • user:subscription:canceled → "We're sorry to see you go" email with挽留 offer or link to talk to support
  • user:subscription:churned → Win-back email 7–14 days after churn
  • user:signup → Welcome email with getting-started link
  • user:onboarding:completed → Tips and feature highlights
  • user:import:completed → Tips on using imports, next steps


Support Team Context


When a user opens a chat or emails support, Crisp shows:


  • User data (synced on each page load): plan, subscription status, trial days, tenant info, etc.
  • Session tags: plan-, status-, trial, onboarded, etc.
  • Event timeline: All pushed events with timestamps and data


Use this to provide contextual support (e.g. "I see you just completed an import of 50 contacts..." or "I notice your trial is expiring in 3 days").


Updated on: 13/03/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!