Skip to main content

Notification Flows

A notification flow allows to send a notification whenever a new record is created or updated in Cenit IO, for example sending an email anytime a Zoho Contact Record is created in the corresponding Data Type.

You can manage the notification flows by accesing the menu Workflow/Notification Flows .

image

Add New​

For creating a new email notification flow, click the New button (+) in the Generic Menu.

image

Then you need to select Email Notification

image

After selecting the type of notification you need to start entering a value for every field.

image

At first you need to set

  • Namespace and Name:

    Use namespace and name as the way to referering to the notification flow.

  • Active:

    Set active true in order to enable the notification to be executed when the data event occurrs. When active is set to false, the flow is not executed even if the data event is triggered.

  • Data Type:

    The Data Type associated to the notification flow. It can be selected from the list or created directly by using the Action Form.

After selecting the data type new fields are shown to complete the creation of the flow.

image

  • Triggers:

    You must select one or more Data Events to trigger the flow execution. They can be selected from the list or created directly by using the Action Form.

  • Transformation:

    You must select a transformation of type Converter Translator to convert the record to email message. It can be selected from the list or created directly by using the Action Form.

  • Email Channel:

    You must create an Email Channel for specifying the email setting you are going to use. Since there is no menu entry for creating the Email Channel separately, It probably can't be selected from the list unless you had created one before in another notification flow; so must of the times you need to create it directly by using the Action Form.

  • Email Type:

    The Data Type of the email message. You can use the Data Type Message in the namespace Cenit::MIME: Cenit::MIME | Message . It is set as a default value in this field. I contains a property attachments, an array of type Cenit::MIME | Attachment in case of using atachments in your email. We recommend to use this predefined data type Cenit::MIME | Message.

We can select from the list a trigger created in advance, like Zoho Contact Created, the example shown in Data Events

image

Then we need to define a Converter Transformation for mapping the Zoho Contact to Cenit::MIME | Message. In this case, the Mapping Converter facilitates the transformation, so we recommend to use a Mapping Converter. The pictures below show how to create the Mapping Converter separately, from the Transformation/Converters menu.

image

At first we need to specify its namespace, name and both the source data type and the target data type.

image

Then you need to edit the mapping section. You should notice every field in the email is mapped from a Zoho Contact property and the double curly brackets operator allows to access to the Zoho Contact Property in an easy way.

image

After saving the Mapping Converter it can be selected in the Notification Flow view:

image

Since the Email Type is set to its default value Cenit::MIME | Message there is only one resource to be defined: the Email Channel. For creating the Email Channel press the + Button like shown below.

image

At first we need to select the type of email channel. You can define an Email flow for sending emails via API. However the simplest way is by using a SMTP account (Please read the notification about gmail account and apps less secure at the bottom of this page).

image

After selecting SMTP account a view like the one below is shown

image

After entering the email and password and pressing the Save button, the UI alerts that you need to create a provider for that email channel. So you need to press the + button

image

For creating the provider for the SMTP account, you need to set the parameters for the SMTP settings and press the Save button.

image

Then you can see the provider is already created and select in the Email Channel, so you can press the button Save.

image

After saving the mail Channel you can check in the notification view that the Email Channel is created and selected. Besides you can check the flow is active, then press the Save button.

image

After pressing the Save button you can see the notification flow in the list.

image

At this point you can create a new Zoho Contact record, which triggers the data event Zoho Contact Created and the notification flow execution is activated so the email is sent.

Important notice: about using a gmail smtp account in the notification flow​

To help keep your account secure, from May 30, 2022, ​​Google no longer
supports the use of third-party apps or devices which ask you to sign in
to your Google Account using only your username and password. So you may
use a google SMTP account only if it was previously configured to accept
less secure app access since this feature is no longer available.
Google Workspace and Google Cloud Identity users won’t be affected right
away, but support for Less Secure Apps will still be phased out for those
users at a later date.
If this feature is disabled in your google account, you need to use
another SMTP account or use an Email Channel of type Email Flow instead.
The Email Channel of type Email Flow requires the configuration of an
Export Flow for sending emails via API, so you will need not only to get
the credentials for accesing that API from Cenit IO but also to configure
all the resources involved in the export flow.