Updating Conditional Alerts

Users should be careful when updating conditional alerts as it is easy to accidentally re-trigger messages to all cases that meet the conditional alert criteria. 

Currently, conditional alerts will re-trigger to all cases that meet the conditional alert criteria any time a conditional alert is updated (ex. modifying  the name of the conditional alert or schedule of an alert, etc.) The only time this re-triggering doesn't occur is when users update only the content of the alert: the subject line or body of email, or the body of SMS messages.

To avoid re-triggering messages, users should complete the following steps:

1. Create a new mobile worker in your project space (ex. 'Dummy Mobile Worker')

2. Open the conditional alert that you wish to edit and navigate to the ‘Schedule& Recipients’ tab. Change the ‘Recipient(s)’ to ‘Users’ and select the mobile worker you just created. This will cause all of the messages that are re-triggered to be sent to this user.

3. Make your desired update to the conditional alert and click ’Save.'

4. Navigate to the messaging dashboard and review the ‘Messaging Events (Success/Error)’ logs. You should see a large number of errors - these errors are the messages firing to the dummy mobile worker you just created. Please note that these messages will not impact Dimagi’s email bounce rate, however, if you are performing updates on many domains or are re-triggering many messages, you should contact support@dimagi.com or reach out to your contact on the support team to notify them that these errors are expected. After all messages have been re-triggered, which usually takes less than five minutes, you will stop seeing new errors in the message logs.

5. Once all messages have been sent, navigate back to the conditional alert you were editing and update the ‘Recipient(s)’ to ’The Case’ (or whatever your desired recipient is) and click 'Save.'