Replacing Double Opt-In System Workflow

System workflows and events make usage of the platform more convenient. For example, Reteno widgets have a subscription confirmation workflow attached by default. When creating a form, it is enough to activate the switcher so that all new contacts who fill out the form on the site receive an email with a link to confirm the subscription.

Widget settings with the Double Opt-In toggle highlighted by a red arrow, and an email confirmation preview showing a Confirm subscription button

The built-in system workflow sends one confirmation email, specified in the widget settings, no more than once every 72 hours.

Built-in double opt-in workflow diagram with a single Send obligatory (transactional) email task, highlighted in a red box

In some cases, you may need to change the system workflow: for example, send one or more messages asking to confirm the subscription to those who did not do this in the first email.

System workflow replacement algorithm:

  1. Setting up the subscription confirmation link in the email.
  2. Creating a workflow.
  3. Configuring trigger.
šŸ“˜

Note

If you replace the system workflow, the new mailing scheme will be applied to all widgets in the account, while the emails can still be unique for each form.

Setting Up a Confirmation Link in an Email

The button with the confirmation link in the email for widgets should have the following settings:

Link:

  • Type: Subscription confirmation,
  • Link: $data.get('redirectUrl')
Confirmation email editor with the Confirm subscription button's Link settings set to Subscription confirmation type, highlighted in a red box

Event type: SysContactConfirmed

Confirmation email editor with the Confirm subscription button's Event type set to SysContactConfirmed, highlighted in a red box

Creating Workflow

Create a new workflow. It will be triggered by the SysContactConfirmationRequest system event, which is sent to Reteno when a user submits data from a widget on the site.

For example, if you want to remind about subscription confirmation three times with an interval of an hour, the workflow will be as follows:

Workflow diagram reminding subscribers to confirm up to three times, using repeated Send obligatory email and 1 hour Timer blocks in a branching structure

Workflow blocks:

  1. Start.

  2. The Send obligatory (transactional) email task with the following settings:

  • Message: specify the message.
  • Contact’s email: specify the ${emailAddress} variable — the system will substitute from the event the email of the user who filled out the form.
Workflow editor with the Send obligatory (transactional) email block settings showing the Confirmation email message and Email field set to ${emailAddress}, highlighted in red boxes
  1. Timer: specify the time to elapse between subscription checks.
Workflow editor with the Timer block settings showing Wait time set to 1 hour, highlighted in a red box
  1. The Contact confirmed condition checks if the user has confirmed their email: if yes, the workflow ends; if not, sends the message again.
Workflow editor with the Contact confirmed condition block settings, highlighted in red boxes
  1. End.

After making the settings in the workflow blocks, save it and go to the launch settings.

Configuring Trigger

  1. Click Trigger configuration in the list of workflows.

  2. Activate the Start configuration switcher.

  3. In the Start configuration, select:

  • Event-based;
  • SysContactConfirmationRequest event;
  • arbitrary conditions for processing unique events.
Start/Stop configuration window with Event-based start configuration, the SysContactConfirmationRequest event, and Once in every 72 hours option highlighted in red boxes
  1. Click Apply.

Learn more about events >

Once you activate the workflow, the system will apply it to all widgets in your account.


Did this page help you?