Triggers

Triggers are a powerful component in Donorfy which allows you to define custom behavior when specific events happen, such as a new constituent being added.

Triggers are available to both Essential and Professional Plans as follows:

Essentials - a maximum of 3 Triggers

Professional - unlimited number of Triggers

Triggers may require a Stored Procedure to be written - please contact Donorfy Support about what Trigger you require. A quote for the Stored Procedure to be written will then be provided.

 

Watch the overview and tutorial on Triggers here.

 

Creating a trigger

Triggers can be created by going to Data Management > Triggers.

Click on the + button to start creating your trigger.

You must supply a name and select the type of system event which will initiate the trigger.

mceclip0.png

 

Trigger types

Trigger type - Manual

ID: 1

This trigger type requires a user to press a button to initiate the trigger via Data Management > Triggers.

Trigger type - Scheduled

ID: 5

This trigger type is run on a user defined Schedule.

mceclip6.png

Trigger type - Constituent Added

ID: 6

This trigger is run when a constituent is added.

Trigger type - Constituent Updated

ID: 2

This trigger is run when a constituent is updated.

Trigger type - Constituent Deleted

ID: 7

This trigger is run when a constituent is deleted.

Trigger type - Activity Added

ID: 13

This trigger is run when an activity is added.

Trigger type - Activity Updated

ID: 14

This trigger is run when an activity is updated.

Trigger type - Activity Deleted

ID: 15

This trigger is run when an activity is deleted.

Trigger type - RPI Added

ID: 4

This trigger is run when an RPI is added.

Trigger type - RPI Updated

ID: 11

This trigger is run when an RPI is updated.

Trigger type - RPI Deleted

ID: 12

This trigger is run when an RPI is deleted.

Trigger type - Transaction Added

ID: 8

This trigger is run when a Transaction is added.

Trigger type - Transaction Updated

ID: 9

This trigger is run when a Transaction is updated.

Trigger type - Transaction Deleted

ID: 10

This trigger is run when a Transaction is deleted.

PLEASE NOTE

Triggers are not fired as a result of data being added/updated/deleted via the

  • File Uploader
  • API

They are only fired as a result of Donorfy data being added/updated/deleted by manual input or the standard integrations (see donorfy.com/integrations).

Conditions

Conditions allow you to specify when a Trigger should run, for example you may wish to initiate a Mailchimp automation when you receive a new donation, but only if that donation is over X amount.

Conditions are optional, and all of the conditions must be met for the Actions to run.

mceclip0.png

Condition type - Constituent in list

mceclip4.png

The constituent related to the event must exist in a list.

For example, if an Activity is created on a Constituent profile, the Constituent must exist in a list for the actions to run.

 

Condition type - RPI in list

The RPI in the event must exist in a list.

Condition type - Transaction in list 

The Transaction in the event must exist in a list.

Actions

Actions can be re-ordered by dragging the panel up and down.

Actions must be given a name.

If enabled, the Only run if previous actions are successful option will result in the action being skipped if any of the steps above it in the trigger are unsuccessful or error.

mceclip3.png

Action type - Execute Stored Procedure

Requires Own Azure

The Execute stored procedure action will run a stored procedure on SQL server.

For example, a valid value would be [dbo].[sp_whoisactive]

Action type - HTTP POST

The HTTP POST action will send an HTTP POST request.

You can optionally define custom headers to be sent with the HTTP payload. Please note these are not stored encrypted.

mceclip5.png

The payload can be different depending on the Trigger type. Currently there is only one payload type.

Example of a standard payload

This HTTP body is sent from a Constituent added event.

{
"TriggerType": 6,
"EntityType": "Constituent",
"EntityId": "632c9e6f-bded-ea11-b5d9-501ac580925b",
"EntityNumber": 583,
"Timestamp": "2020-09-03T08:15:31.5659533+00:00"
}


Action type - Initiate Mailchimp Automation

The Initiate Mailchimp Automation action will initiate a selected Mailchimp automation for the constituent related to the Trigger event.

Optionally, selecting a purpose will check whether the constituent has allowed communication through that purpose before running the Action.

mceclip7.png

 

 

Have more questions? Submit a request

Comments

Powered by Zendesk