Overview

The Trigger feature can be use in a variety of different ways and will help automate actions that would otherwise need to be preformed manually. One of the most common use cases for the trigger tool and to create activities, such as sending an email, scheduling a meeting, or calling a donor. For example, a major gift officer may want to call a new donor when they give make a large donation. Instead of that major gift officer searching for large transactions, a trigger can be created to create an activity to call that donor.

The Trigger feature can be a critical benefit to your organization helping to reduce manual work effort and allow you and your teams to focus on important fundraising activities.  

Prerequisites

1. To leverage the Trigger feature, each type of will require you to first create a source for your job. This is the isolated group of contacts, transactions, etc. that will be targeted for your trigger. This can be achieved by creating a Report Builder Report or a Query. 
   1. Examples: Assign a "Northwest" region attribution to all new contacts with a mailing address of Washington, create an activity for an email outreach for all volunteers who sign up with a Volunteer Sign Up form, or create an opportunity for any contact who gives more than $1,000 for donor cultivation with your development team.

Triggers: A General Overview

The Trigger feature can be located by navigating to the Automation & Workflow App > Workflow > Triggers > Create New

By selecting the Type drop down, expose a variety of jobs available for automation. 

If you require a recurring trigger job, simply access the Trigger Job listing screen (Automation & Workflow App > Workflow > Trigger) and navigate to ACTIONS to expose Schedule and create a schedule for your job.

Note: If you need to modify a previously created Trigger Job, navigate to the Automation & Workflow App > General > Job Scheduler > locate your job > ACTIONS > Manage

1. 1. Name: (required) 
   2. Dates: leaving blank will default to initiate today; user also has the ability to set a future start and end date
   3. Data job: do not modify - this will default to the trigger job created above
   4. Click SAVE to secure

Use Case: Creating and Automating Activities for Volunteer Follow ups

In this article you will learn how to create a series of queries and triggers that will automatically create actives and send reports to solicitors and members of your organization to encourage volunteer outreach after volunteers have signed up through one of your web forms. 

1. Creating a query to identify the volunteers who completed an online web form
2. Creating a query to identify the assigned solicitor who will contact the volunteer
3. Creating the trigger using the second query as a source
4. Creating a recurring schedule to initiate a daily activity
5. Creating a scheduled report to be delivered to the solicitor as an extra notification 

The first step in creating this workflow is to create 2 queries, one to identify the form submissions, which will display as transactions with 0 dollar amounts in your system and one to identify the contacts and their solicitors.

Step 1: Form Submission Query to Identify Population - To create the form submission query that will be used as a subquery, navigate to the Automation & Workflow App > General > Queries > Create New > Filter: Donations > Select: Transactions

Step 2: In the SELECT section, add the (Web) Form Id, Contact Id, and Date fields under the Transaction field group to the selected fields section.

Step 3: In the FILTER section below, add the (Web) Form Id field. Then, in the open text field, input your Volunteer Form's Id.

Tip: Form Id's are 5-digit numbers located below the name of your form on the web form listing screen. 

Step 4: Once you have your criteria set, save and name your query.

Step 5: Contacts Query to Identify Contact and Solicitor - The next query you will create will be used to create the activity trigger and will contain the form submission query you just created. Navigate back to the Automation & Workflow App > General >  Queries > Create New > Filter: Contacts > Select: Contacts.

Step 6: In the SELECT section, add Contact Id and Solicitor Contact Id.

Note: Solicitor must already be assigned to the contact for the activity to be assigned correctly. If you are the only solicitor for this volunteer activity, follow the steps below to set a solicitor contact id default in this query.

1. To assign a solicitor contact id default, select the drop-down arrow next to the Solicitor Contact Id field, then select Set Value if Blank.
2. Click into the Set Value if Blank field and input your own Contact record Id. Then, select the drop-down arrow to collapse section.

Step 7: In the FILTER section, add Contact Id and click on the icon to add an external query.

Step 8: Search for the form submission query you created above and select that query. You will also need to select Transaction Contact. Id from the dropdown as shown below.

Step 9: Click SAVE and name your query.

Step 10: Creating the Trigger Job -Once you have created both queries, you will be able to create the trigger to auto assign the activity. Navigate to the Automation & Workflow App > Workflow > Triggers > Create New > Type: Create Activity > NEXT.

Step 11: From Data Source locate your contacts query as the data source. Select the Contacts.Id as the Participating Contact (the volunteer), and the Solicitor.Contact.Id as the Assigned Contact (the person within the organization who will be assigned the activity). Then, select NEXT.

Step 12: Name the trigger job and under ACTIVITY SETTINGS, Title: Name of the activity, Type: determine activity type, Status: initial status of activity. Click NEXT to proceed. 
For example, if your activity is to send an email to the volunteer, you could title the activity “Send Email to New Volunteer”, then select Send Email as type, and status as pending.

Step 13: Click FINISH once you have received and are ready to initiate the Trigger Job. 

Step 14: Scheduling the Activity Trigger - Now that the trigger has been created, you can now schedule the trigger to run (1x or recurring). To schedule the trigger to run daily, navigate to the Automation & Workflow App > Workflows > Triggers to view the listing screen. Locate the trigger you just created and under ACTIONS > Schedule.

Step 15: On the General tab, enter in the Name of the schedule, add a start/end date (optional) then click SAVE.

Step 16: Once you click SAVE, the Notifications and Triggers tabs will appear. On the Notification tab, enter the email(s) of the recipients that will receive an email when the job has been run.

Note: The recipients will only receive notification that the job has been run. This will not include information on who was assigned what activities.

Step 17: On the Triggers tab you will be able to set the frequency that the trigger will run. If you want the trigger to run daily, select day from the first dropdown and select the time of day that it will run. Click ADD and then SAVE to secure your changes. 

Step 18: Creating and Sending Reports for Solicitors - Now that you have automated your trigger to automatically create an activity for your solicitors, solicitors will be able to see any activities assigned to them on the home dashboard under the Activities widget when they log into CharityEngine.

However, you can also create a report that can be sent out to all solicitors that will inform them of the activities that have been assigned to them. This could be helpful if your solicitors do not log into CharityEngine on a daily basis.

To create this report, navigate to the Contacts App > Activities > Activities and use the filters to segment the activities. For example, you can use the date filter to only show activities assigned today for all solicitors.

Or you can use the advanced filter to segment by solicitor by entering in the solicitor in the assigned text box.

Step 19: Using the Report Builder, you can then create a report that contains any fields necessary and schedule the report to be sent to the solicitors. For help in using the Report Builder and scheduling reports, read our article Reports & Analytics: How to Use the Report Builder Tool.

Use Case: Creating a trigger to automatically create an activity to call a donor for your Development Team

One of the most common use cases for the trigger tool is to automatically create activities, such as sending an email, scheduling a meeting, or calling a donor. These are critical activities for donor cultivation and the use of automation ensures that you don't miss a donor. Instead of that Major Gift Officer searching for large transactions, a trigger can be created to create an activity to call that donor.

For this use case, our flow will include:

1. Creating a query to identify the donor population
2. Creating the trigger using the query as a source
3. Creating a recurring schedule to initiate weekly 

Step 1: The first step in creating this trigger is to create our source. Navigate to the Automation & Workflow App > General > Queries > Create New.

Step 2: To find donors who donated a large amount to the organization, select Filter: Donations and Select: Transactions.

Step 3: Next, in the SELECT section, add the transaction Id, Date (of transaction), Payment Amount, contact Id, contact Full Name, and Solicitor Id.

Step 4: Next, in the FILTER section add Payment Amount Greater than 1000 AND add Date - in this example we will look for transactions weekly.

Step 5: Click SAVE and name your query. 

Note: not all contacts have an assigned solicitor so it is important to populate a value if the field is blank in order to correctly assign the activity when creating the trigger. To do this click on the arrow next on the solicitor Id field and enter the Id of the solicitor you want to assign if the field is blank.

Step 6: Once your query is created, we will create the trigger job. Navigate to the Automation & Workflow App > Workflow > Triggers > Create New > Type: Create Activity.

Step 7: Use the dropdown to select the data source, which is the query you just created above. Select a Start Date. Select Transaction Contact.Id for the Participating Contact (this is the donor id). Use Solicitor ID as the Assigned Contact (the organizational solicitor who will engage with the donor). Click NEXT to proceed. 

Step 8: Name your job, create a starting date, add a description (optional), and add emails for those who should receive notification of the job completion. And update the email subject as needed.

Step 9: Expand ACTIVITY SETTINGS to create the details of the activity to be created. 

• Title: The name of the activity that will be created from this job
• Type: to assign the type (i.e. phone call, send email, in person meeting)
• Status: of the activity (i.e. Pending, Open, Closed)

Step 10: Click NEXT. Review the summary and click FINISH to initiate the job.

Step 11: Once you save the trigger, you will then need to schedule the trigger to run on a cadence, once a week for this example. To do this, navigate to the Automation & Workflow App > Workflow > Triggers > ACTIONS > Schedule.

Step 12: Name the job and select a Start and/or End date. Click SAVE.

Step 13: Once you save the schedule, a new tab will appear where you can select the frequency. Use the dropdown to select when the trigger will run. For example, if you wanted the trigger to be run once a week on Mondays at 8:00 am, it would look like the below.

Click ADD to add the trigger schedule and click SAVE to secure your trigger schedule. 

Your trigger will now automatically assign the activity "Call Major Donors" to the assigned solicitors every Monday at 8 am for any donor who made a donation > $1,000 the week prior.

Use Case: Creating a trigger to automatically create an activity for donor follow ups

An important part of donor management is following up with donors after they have made a gift. This could be a personal email, a phone call, or even a gift to say thank you for their donation. This extra step encourages donors to continue giving and ensure them that their gift is appreciated.

The first step in creating this workflow is to create 2 queries, one to identify the transactions and one to identify the contacts and their solicitors.

Note: You may need to create several transaction queries if you have different giving levels that require different type of activities to be created. For example, a first time giver may receive an email, but someone who gave a major gift of $5,000 may receive a phone call or a gift.

Step 1: Transaction Query to Identify Population - To create the transaction query that will be used as a subquery, navigate to the Automation & Workflow App > General > Queries > Create New > Filter: Donations > Select: Transaction.

Step 2: In the SELECT section, add the Transaction Id, Payment Amount, Contact Id, and Date.

Step 3: In the FILTER section, add the criteria you want to filter by. For example if you are targeting major gifts of $1,000 or more that gave today, add Payment Amount to the filter box, select Greater than or Equal to from the dropdown, and enter $1,000 into the text box. Then add the transaction date filter and set to last 24 hours, as shown below.

Step 3: Alternative - If you are targeting first time givers, use the Contact Frist Transaction Date field and set to today:

Step 5: Contacts Query to Identify Contact and Solicitor - The next query you will create will be used to create the activity trigger and will contain the transaction query you just created. Navigate back to the Automation & Workflow App > General >  Queries > Create New > Filter: Contacts > Select: Contacts.

Step 6: In the SELECT section, add Contact Id and Solicitor Id

Note: Solicitor must already be assigned to the contact for the activity to be assigned correctly.

Step 7: In the FILTER section, add Contact Id and click on the icon to add an external query

Step 8: Search for the transaction query you created above and select that query. You will also need to select Transaction Contact. Id from the dropdown as shown below.

Step 9: Click SAVE and name your query.

Step 10: Creating the Trigger - Once you have created both queries, you will be able to create the trigger to auto assign the activity. Navigate to the Automation & Workflow App > Workflow > Triggers > Create New > Type: Create Activity > NEXT.

Step 11: Select your Contacts query as the data source, select the Contact Id (the donor) as the Participating Contact, and the Solicitor Id (the organizational employee to engage with the donor) as the Assigned Contact. Click NEXT.  

Step 12: You will then need to name the trigger job and under Activity settings you will name the activity and set the type and status. For example, if your activity is to call the donor, you could title the activity “Call Donor for $1000+ Gift”, then select Phone call as type, and status as pending.

Step 13: Continue creating the trigger and click NEXT.

Step 14: Review the summary screen and click FINISH.

Step 15: Scheduling the Activity Trigger - To schedule the trigger to run daily, navigate back to the trigger listing screen by selecting the Automation & Workflow App > Workflow > Triggers > ACTIONS > Schedule.

Step 16: On the General tab, enter in the Name of schedule, then click SAVE.

Step 17: Once you click Save, the notifications and triggers tabs will appear. On the notification tab, enter the emails of the recipients that will receive an email when the job has been run.

Note: The recipients will only receive notification that the job has been run. This will not include information on who was assigned what activities.

Step 18: On the Triggers tab you will be able to set the frequency that the trigger will run. If you want the trigger to run daily, select day from the first dropdown and select the time of day that it will run. Click ADD to include your trigger time. 

Step 19: Click SAVE to secure your job.  

Step 20: Creating and Sending Reports for Solicitors (optional)

Solicitors will be able to see any activities assigned to them on the home dashboard under the Activities widget when they log into CharityEngine.

However, you can also create a report that can be sent out to all solicitors that will inform them of the activities that have been assigned to them. This is helpful if your solicitors do not log into CharityEngine on a daily basis.

To create this report, navigate to the Contacts App > Activities > Activities and use the filters to segment the activities. For example, you can use the date filter to only show activities assigned today for all solicitors

Or you can use the advanced filter to segment by solicitor by entering in the solicitor in the assigned text box.

Step 21: Using the Report Builder, you can then create a report that contains any fields necessary and schedule the report to be sent to the solicitors. For help in using the Report Builder and scheduling reports, read our article Reports & Analytics: How to Use the Report Builder Tool.

FAQs

Q. I need to change the schedule and frequency of a previous trigger. Can I modify the schedule?
A. Yes. If you need to modify a previously created Trigger Job, navigate to the Automation & Workflow App > General > Job Scheduler > locate your job > ACTIONS > Manage

• Sustainers: How to Create and Manage Recurring Donors (Legacy)
• Overview: Acknowledgements
• Queries: What Can I Do with Queries - Locating Contacts Within X Miles
• Donations: How to Manually Create Soft Credits (Legacy)
• Queries: What Can I Do with a Query: Donations Within X Days
• Queries: What Can I Do with Queries - Event Registration
• Donations: Assigning a Transaction to A Sustainer, Membership, or Pledge Account
• Data Entry: How to Input Individual Payments
• Donations: How to Manage a Transaction
• Assigning Groups, Tags, and Opt- In Lists Through Importer (Legacy)
• Donations
• Opportunity - Moves Management: How to Automatically Create an Opportunity Using the Trigger Tool
• Trigger Tool – Creating an Opt-In List (Legacy)
• Queries: What Can I Do With Queries - Resend Initiatives to Contacts Who Have Not Opened Them
• Events, Auctions & Volunteers
• Opportunities - Moves Management: How to Create a Simple Track for Opportunities
• Reports & Analytics: How to Use the Report Builder Tool (Legacy)
• Contacts: Managing Contact Status Types and Priority
• Opportunity - Moves Management: How to Link a Transaction to an Opportunity
• Workflow & Automation: Data Governance – Contact Management (Merge, Delete, Inactive)
• Pledge: How to Create and Manage Pledges - A Comprehensive Guide
• Sustainer Records: How to Deactivate Sustainers in Mass
• Automation & Workflow
• Campaign - Surveys: How to Create a Poll & Survey Form and How to View the Results
• API Configuration: How to Configure your WealthEngine API Key
• Data Governance: Updating Contact Records Through the Transaction or Contact Screen
• Mapping Data to Imports- How to Confirm Opportunity Dates are Imported Correctly and Update Them
• Communication: How to Send Messages from Listing Screens
• Data Governance: Best Practices for Backing Up Data (Legacy)
• Data Importing: How to Import Transactions
• Accounting & Finance: Leveraging General Ledger Codes vs. Funds
• Credit Card Automatic Updater: How to Configure the Card Updater and Overrides (Legacy)
• Workflows: How to Bulk Delete Transactions Using Transformation Tool
• Data Importing: How to Import Relationships
• Tributes: How to Clean Up Tributes without Acknowledgees
• Contacts: How to Create and Manage Activities (Legacy)
• Workflow & Automation: Data Governance - Transaction Management (Duplicate Transactions)
• Trigger Tool- How to Create an Activity
• Automation & Workflow: A Basic Understanding of Triggers
• Volunteers App: How to Set up and Leverage Volunteers App in CharityEngine
• Data Import: How to Import Soft Credits
• Email Activity Tracking within CharityEngine
• Donations-Batch Entry: How to Set-up & Enter Donations Via Batch Processing
• API Integration: Configuring API User Account (Legacy)
• Accounting: Accounting and Financial Reconciliation
• Automation & Workflow: Manually Sending Year End Statements to Households
• Automation & Workflow: Using the Import Functionality to Append Data
• Data Enrichment Job: How to Update Address with the Zip +4 and USPS Address Correction feature
• Trigger Tool: How to Auto Assign Contacts to a Household
• Contacts: Quick Actions
• Contacts: Comprehensive Guide for Usage and Management of Tributes
• Opportunities & Moves Management: Comprehensive Guide for Set Up, Configuration & Reporting(Legacy)
• Reporting and Dashboards
• Reports & Analytics: Overview and Usage of the Reports & Analytics Application
• Automation & Workflow: Modifying a Data Job
• Data Importing: How to Import Contact - Organization Data
• Data Importing: How to Import Contact - Household Data
• Automation & Workflow: Data Transformation
• Data Importing: How to Import Pledge Accounts & Historical Pledge Transactions
• Queries: What Can I Do with Queries - Creating A Comm List including People, Households, Orgs
• Queries: What Can I Do with Queries - Creating A Transaction List - People, Households, Organization
• Auctions App: Creating, Managing, and Closing an Online Auction
• In-Kind Gifts: How to Create and Manage In-Kind Gifts - A Comprehensive Guide
• Data Governance: Change Logs
• Transactions: Matching Gifts for Employee Giving
• Data Importing: External Bulk Verification Services
• Events: A Comprehensive Walk Through for Events Set-Up (Legacy)
• Transactions: Preparing & Sending Year End Statements
• Sustainers: How to Create and Manage Recurring Donors
• Events, Auctions & Volunteers
• Automation & Workflow: An Introduction to Queries
• Transactions: Fraudulent Transactions, Proactive Fraud Management, & Managing Fraud Events
• Developer: API - Installing the CharityEngine Public Web API
• Events: A Comprehensive Walk Through for Events Set-Up
• Data Importing: How to Import Contact - People Data
• Assigning Groups, Tags, and Opt- In Lists Through Importer
• Data Importing: Contacts & Use of Contact Matching
• Exporting Data: How to Schedule an Export Data Job
• Workflow & Automation: Data Governance – Contact Management (Merge, Delete, Inactive)
• Email Campaigns: How to Build Opt In List - Using Query Builder to Segment Existing Lists
• How to Clear Contacts from Groups, Tags, and Lists Using Trigger Tool
• Transactions: Sending Individual/Multiple Acknowledgements or Receipts
• Reports & Analytics: An Introduction to Frequent Reporting Options within CharityEngine
• Trigger Tool – Creating an Opt-In List
• Donations: How to Manually Create Soft Credits
• Data Governance: Best Practices for Backing Up Data
• API Integration: Configuring API User Account
• Donations: Issuing Credit, Reversals, and Outgoing Payments (Legacy)
• Reports & Analytics: How to Use the Report Builder Tool
• Acknowledgments
• Events & Volunteers : Registrations
• Donations: Issuing Credit, Reversals, and Outgoing Payments
• Events & Volunteers : Events - Create, Search & Manage
• Data Importing: How to Import Transactions
• Donations-Batch Entry: How to Set-up & Enter Donations Via Batch Processing
• Automation & Workflow: An Overview of Triggers & Use Case - Examples
• Automation & Workflow: Merge History
• Acknowledgments (Legacy)
• Leveraging Opportunities for Existing Major Donor Management - Cultivating
• Opportunities - Moves Management: Locating and Managing Existing Opportunities