Notification

Added a Notification node, which allowed notifying specified users of the task scheduling result via the WeCom chatbot.

Allowed notifying specified users of the task scheduling results via emails.

Added notification channels including SMS, WeCom App Notification, DingTalk App Notification, and DingTalk Chatbot to the Notification node.

• Supported Lark notification.

• Allowed configuring notification objects based on the platform system for SMS and Email notification, with optional objects including platform users, departments, and roles. Ultimate objects would be the union of the selected.

• Masked SMS templates unrelated to FineDataLink.

• Allowed using multiple notification channels for a task.

4.1.5.5

Disabled the notification frequency limit by default

Platform User Group

You can select platform users, departments, and roles as the notification objects. The ultimate objects are a union of the selected.

You can choose from the list of senders configured on the platform. The value defaults to the default sender.

If no senders are configured on the platform, the dropdown list will be empty. For details about configuring the sender, see Email.

Notification Object

1. Platform User Group:

• This option can only be selected when User/Dept./Role has been set in Platform User Group. Otherwise, it is grayed out and unselectable.

• If User/Dept./Role has been set in Platform User Group, select this option. 

• Users bound to no email address cannot receive notification emails.

2. Custom Recipient:

You can customize recipients by entering email addresses. Separate multiple addresses by commas (,). Referencing parameters is supported. 

Carbon Copy/Blind Carbon Copy

You can select platform users with the email address configured or enter custom email addresses. 

• Separate multiple addresses by commas (,), for example, a@fanruan.com,b@fanruan.com.

• Referencing parameter values using ${Parameter} is supported. 

Subject 

Enter the email subject.

Referencing parameter values using ${Parameter} is supported.

Body

Enter the email body.

Referencing parameter values using ${Parameter} is supported.

You can select platform users, departments, and roles as the notification objects. The ultimate objects are a union of the selected.

1. Platform User Group:

• This option can only be selected when User/Dept./Role has been set in Platform User Group. Otherwise, it is grayed out and unselectable.

• If User/Dept./Role has been set in Platform User Group, select this option. 

• Users bound to no mobile number cannot receive short messages for notification.

2. Custom Recipient:

You can customize recipients by entering mobile numbers. Separate multiple mobile numbers by commas (,). Referencing parameters is supported. 

You can select the SMS signature.

• Available options include the SMS signature of the account bound with the FanRuan passport (with activated SMS) on the platform.

• It must be set

You can select the SMS template, which cannot be edited here.

In FineDataLink 4.0.28, SMS templates unrelated to FineDataLink are masked.

SMS Parameter

You can set the parameter value to be passed to the SMS template. All parameters in the selected SMS template are displayed in the Parameter Name column with their values being empty.

• Parameter Name: It displays the parameter in the selected SMS template. The parameter name cannot be edited here.

• Value: You can fill in the parameter value. Referencing parameters is supported. (The content is processed as strings.)

Ignore this item, which is valid for SMS/Email notification only.

See the WeCom document to obtain the enterprise ID.

Enter the app secret, which can be viewed on the application management page. See the WeCom document to obtain the app secret.

Enter the AgentID of the message-issuing account, which can be viewed on the App Management page.

• Specify the message-receiving members by entering the member ID. Separate multiple member IDs with vertical bars (|). You can enter up to 1000 member IDs. You can notify all members by entering @all. 

• Referencing parameters is supported.

• Specify the message-receiving department by entering the department ID. Separate multiple department IDs with vertical bars (|). You can enter up to 1000 department IDs.

• Ignore this item if you set Receiving Member to @all.

• Referencing parameters is supported.
  

Receiving Label

• Specify the message-receiving labels by entering the label ID. Separate multiple label IDs with vertical bars (|). You can enter up to 1000 label IDs.

• Ignore this item if you set Receiving Member to @all. 

• Referencing parameters is supported.

Message Type

Specify the message type, including Text Message and Markdown Message.

For details about the currently supported Markdown syntax, see the official document.

Message Content

Fill in the message content, where referencing parameters is supported.  

• It cannot be empty.

• The content of a text message cannot exceed 2048 bytes. The exceeding content will be truncated.

• The content of a Markdown message cannot exceed 2048 bytes and must be UTF-8 encoded. The exceeding content will be truncated.

Non-confidential messages can be shared.

Confidential messages are not shareable and the content is watermarked.

Specify the interval of detecting duplicate messages in seconds. The default value is 1800. You can enter a value between 1800 and 14400.

The Webhook URL of the WeCom chatbot cannot be empty.

Add a chatbot as shown in the following figure. The Webhook URL is displayed on the prompt page after the chatbot is successfully added.

Message Type

Specify the message type, including Text Message and Markdown Message.

1. The setting page after you select Text Message is shown in the following figure.

Reminding Method: Select the way of setting the message-receiving group members. Options include User ID and Mobile Number.

Note:

The user ID is the account ID of the enterprise member. Log in to the WeCom console as the admin and view the account ID under Contacts > Member Details, or log in to the WeCom App as the admin and view the account ID under Workspace > Manage Company > Member and Dept. Management > Edit Member.

Group Member List: Enter the member ID or the mobile number for targeted notification.

You can notify multiple group members at the same time by entering member IDs or mobile numbers separated by commas (,), and notify all members by entering @all. Referencing parameters is supported.

2. The setting page after you select Markdown Message is shown in the following figure.

Message Content

Fill in the message content, where referencing parameters is supported. The requirements are as follows:   

• It cannot be empty.

• The content of a text message cannot exceed 2048 bytes and must be UTF-8 encoded. The exceeding content will be truncated.

• The content of a Markdown message cannot exceed 4096 bytes and must be UTF-8 encoded. The exceeding content will be truncated.

Ignore this item, which is valid for SMS/Email notification only.

It is the app key, which can be obtained on the application detail page of the DingTalk developer console.

It is the ID of the microapplication used to send the message.

• The AgentID of an enterprise application can be obtained on the application detail page of the DingTalk developer console.

• The AgentID of a third-party application can be obtained by calling the /service/get_auth_info interface. For details, see the corresponding official document.

• Mobile numbers are not supported. Enter the member ID, and separate multiple member IDs with commas (,). You can enter up to 100 member IDs.

• You can notify all members by entering @all.

• Referencing parameters is supported.

• You can obtain member IDs using mobile numbers through an API. For details, see the corresponding official document.

• You can view the DingTalk IDs of current employees.

Receiving Department  

• You can enter up to 20 department IDs.
  

• If you enter a department ID, all members of the department will be notified. Referencing parameters is supported.

Message Type

Specify the message type, including Text Message and Markdown Message.

Message Title

The Message Title input box is displayed only when Markdown Message is selected. 

Enter the message title, where referencing parameters is supported. The message title cannot exceed 100 characters, otherwise, an error will occur.

Fill in the message content, where referencing parameters is supported. It cannot be empty.

• The content of a text message cannot exceed 500 characters. The exceeding content will be truncated.

• The content of a Markdown message can not exceed 5000 characters and must be UTF-8 encoded. The exceeding content will be truncated.

Select the way of setting the message-receiving group members.

• Enter the member ID or the mobile number for targeted notification.

•  This configuration item is displayed only when Message Type is set to Text Message. 

• You can notify multiple group members at the same time by entering member IDs or mobile numbers separated by commas (,). No spaces are needed behind commas.   

• You can notify all members by entering @all.   

• Referencing parameters is supported.

The Message Title input box is displayed only when Markdown Message is selected.

Enter the message title, where referencing parameters is supported. The message title cannot exceed 100 characters, otherwise, an error will occur.

Fill in the message content, where referencing parameters is supported.  

• It cannot be empty.

• The content of a text message cannot exceed 500 characters. The exceeding content will be truncated.

• The content of a Markdown message cannot exceed 5000 characters and must be UTF-8 encoded. The exceeding content will be truncated.

Obtain App ID and App Secret under Credentials & Basic Infor > Credentials on the Lark Developer Console page.

Enter the member ID and separate multiple member IDs with commas (,). Referencing parameters is supported. You can notify all members by entering @all. You can enter up to 200 member IDs. 

Note:

1. Member ID is Open ID. For details on how to obtain Open ID, see How to Obtain OpenID. 

2. The notification will fail if you enter @all and not all members who can view the app have joined the enterprise.

Receiving Department

Enter the department ID and separate multiple department IDs with commas (,). Referencing parameters is supported. 

You can enter up to 200 department IDs. 

Specify the message type, including Text Message and Markdown Message.

For the syntax of markdown messages, see Markdown. To send card messages using Lark, you are advised to set the Message Type to Markdown Message.

This configuration item is displayed only when Markdown Message is selected. The filled content will be emptied if you switch Markdown Message to Text Message. Enter the message title, where referencing parameters is supported. 

The message title cannot exceed 100 characters, otherwise, an error will occur.

Fill in the message content, where referencing parameters is supported.   

• It cannot be empty.

• The content of a text message cannot exceed 500 characters. The exceeding content will be truncated.

• The content of a Markdown message cannot exceed 5000 characters and must be UTF-8 encoded. The exceeding content will be truncated.

As mentioned in the official document of Lark, the maximum size of the request body of a text message cannot exceed 150 KB and that of a card message or rich text message cannot exceed 30 KB.

Ignore this item, which is valid for SMS/Email notification only.

Chatbot

Enter the Webhook URL of the chatbot, where referencing parameters is supported. It cannot be empty.

For details about the custom chatbot, see Custom Bot Usage Guide.

Specify the message type, including Text Message and Markdown Message.

Message Type This configuration item is displayed when Text Message is selected. Enter the member ID or the mobile number for targeted notification.  

Note:

1. Member ID is Open ID. For details on how to obtain Open ID, see How to Obtain OpenID. 2. To use mobile numbers as the reminding method, you need to create an app first. 

These configuration items are displayed when you set Reminding Method to Mobile Number.

This configuration item is displayed when Text Message is selected.

• You can notify multiple group members at the same time by entering member IDs or mobile numbers separated by commas (,). No spaces are needed behind commas.

• You can notify all members by entering @all. Ensure that tagging everyone using the At symbol (@) is enabled for the group.

• Referencing parameters is supported.

Enter the message content, which is empty by default.   

• Referencing parameters is supported.

• It cannot be empty.

• The content of a text message cannot exceed 500 characters. The exceeding content will be truncated.

• The content of a Markdown message cannot exceed 5000 characters and must be UTF-8 encoded. The exceeding content will be truncated.

You have set a platform user as the notification object and also entered the user's mobile number or email address.

If the mobile number/email address of the selected recipient is the same as the content entered manually, no repeated notification will be given.

You have set a platform user as the notification object, but the selected user has no mobile number or email address configured.

Notify the specified responsible person by email.

Notify one person per message.

Tasks in the notification message to a certain person are displayed in different colors by urgency. The notification content contains links, and the recipient can click it to jump to the corresponding page.

Tasks in the message are displayed on different lines.