Learn how to configure and implement notification functionality in your business processes using the FlowX.AI Notifications Plugin.
The FlowX.AI Notifications Plugin enables you to send various types of notifications such as emails and SMS messages. This document explains how to integrate notification functionality into your business processes.
To configure a business process that sends notifications, follow these steps:
The notification process uses Send message task/receive message task nodes to manage communication between components.
The diagram below shows how the notification system integrates with your business processes:
DEVELOPER NOTE: Ensure that Kafka topics are properly configured in your environment by setting these variables:
KAFKA_TOPIC_NOTIFICATION_INTERNAL_IN
(default: ai.flowx.plugin.notification.trigger.send.notification.v1
) - Topic for notification requestsKAFKA_TOPIC_NOTIFICATION_INTERNAL_OUT
(default: ai.flowx.engine.receive.plugin.notification.confirm.send.notification.v1
) - Topic for notification responsesYour notification request must include these parameters:
Key | Definition | |
---|---|---|
templateName | The name of the notification template to use | Mandatory |
channel | Notification channel: SMS/MAIL | Mandatory |
receivers | Notification recipients: email addresses or phone numbers | Mandatory |
language | The language code of the template to use (e.g., “en”, “fr”) | Mandatory |
contentParams | Parameters for filling the template with dynamic content | Optional |
senderEmail | Email address of the notification sender | Optional |
senderName | Name of the notification sender | Optional |
attachments | Files to attach to the notification (only for MAIL notifications) | Optional |
Notifications support dynamic keys (placeholders) that allow for personalized content:
${...}
to insert data from the process context${application.client.firstName}
retrieves and displays the client’s first nameLet’s implement a welcome email notification for new customer onboarding.
Create a notification template
First, create and configure your welcome email template. See Managing notification templates for detailed instructions.
With notification templates, you can:
Design the BPMN process
Inside your project, create a process definition with:
This pattern enables asynchronous notification handling through Kafka messaging.
Configure the send message task
On the send message task, add a Kafka send action with the following settings:
KAFKA_TOPIC_NOTIFICATION_INTERNAL_IN
environment variableflowx-notifications-devmain
To find defined topics in your environment:
contentParams
(object) for dynamic content, attachments
(array) for emailsConfigure the receive message task
KAFKA_TOPIC_NOTIFICATION_INTERNAL_OUT
environment variableai.flowx.updates.devmain.notification.request.v1
To add a data stream topic, follow the steps below:
KAFKA_TOPIC_NOTIFICATION_INTERNAL_OUT
environment variable.To find the corresponding data stream topic in your environment follow the same steps as in the previous step
Run and verify the process
Execute the process and verify the results by:
KAFKA_TOPIC_NOTIFICATION_INTERNAL_OUT
topicWhen successful, you’ll receive a response on the KAFKA_TOPIC_NOTIFICATION_INTERNAL_OUT
topic similar to this:
You can enhance your notifications by attaching dynamically generated documents. To accomplish this:
Set up document templates using the Document Plugin Generate documents in your process before sending the notification Reference the generated documents in the notification request using dynamic keys:
This integration creates a complete communication flow where personalized documents are automatically generated and sent to recipients.
Missing Kafka topics
Ensure that all required Kafka topics are properly configured in your environment variables. Check the Platform Status screen for confirmation that topics are available and accessible.
Notification not received
Verify that the receiver information is correct and that your template is properly configured. Check the audit log for any error messages in the notification response.
Template rendering issues
If your notification is sent but doesn’t display properly, check that all template variables are correctly defined and that the contentParams in your request match the expected template variables.
Dynamic key not resolving
If a dynamic key isn’t displaying the expected value, verify the path is correct and that the data exists in the process context. Dynamic keys are case-sensitive and must match the exact path to the data.
Attachment problems
For issues with attachments, ensure the document was successfully generated and stored before attempting to attach it. Check that the path and filename are correctly specified in the attachment configuration.
Learn how to configure and implement notification functionality in your business processes using the FlowX.AI Notifications Plugin.
The FlowX.AI Notifications Plugin enables you to send various types of notifications such as emails and SMS messages. This document explains how to integrate notification functionality into your business processes.
To configure a business process that sends notifications, follow these steps:
The notification process uses Send message task/receive message task nodes to manage communication between components.
The diagram below shows how the notification system integrates with your business processes:
DEVELOPER NOTE: Ensure that Kafka topics are properly configured in your environment by setting these variables:
KAFKA_TOPIC_NOTIFICATION_INTERNAL_IN
(default: ai.flowx.plugin.notification.trigger.send.notification.v1
) - Topic for notification requestsKAFKA_TOPIC_NOTIFICATION_INTERNAL_OUT
(default: ai.flowx.engine.receive.plugin.notification.confirm.send.notification.v1
) - Topic for notification responsesYour notification request must include these parameters:
Key | Definition | |
---|---|---|
templateName | The name of the notification template to use | Mandatory |
channel | Notification channel: SMS/MAIL | Mandatory |
receivers | Notification recipients: email addresses or phone numbers | Mandatory |
language | The language code of the template to use (e.g., “en”, “fr”) | Mandatory |
contentParams | Parameters for filling the template with dynamic content | Optional |
senderEmail | Email address of the notification sender | Optional |
senderName | Name of the notification sender | Optional |
attachments | Files to attach to the notification (only for MAIL notifications) | Optional |
Notifications support dynamic keys (placeholders) that allow for personalized content:
${...}
to insert data from the process context${application.client.firstName}
retrieves and displays the client’s first nameLet’s implement a welcome email notification for new customer onboarding.
Create a notification template
First, create and configure your welcome email template. See Managing notification templates for detailed instructions.
With notification templates, you can:
Design the BPMN process
Inside your project, create a process definition with:
This pattern enables asynchronous notification handling through Kafka messaging.
Configure the send message task
On the send message task, add a Kafka send action with the following settings:
KAFKA_TOPIC_NOTIFICATION_INTERNAL_IN
environment variableflowx-notifications-devmain
To find defined topics in your environment:
contentParams
(object) for dynamic content, attachments
(array) for emailsConfigure the receive message task
KAFKA_TOPIC_NOTIFICATION_INTERNAL_OUT
environment variableai.flowx.updates.devmain.notification.request.v1
To add a data stream topic, follow the steps below:
KAFKA_TOPIC_NOTIFICATION_INTERNAL_OUT
environment variable.To find the corresponding data stream topic in your environment follow the same steps as in the previous step
Run and verify the process
Execute the process and verify the results by:
KAFKA_TOPIC_NOTIFICATION_INTERNAL_OUT
topicWhen successful, you’ll receive a response on the KAFKA_TOPIC_NOTIFICATION_INTERNAL_OUT
topic similar to this:
You can enhance your notifications by attaching dynamically generated documents. To accomplish this:
Set up document templates using the Document Plugin Generate documents in your process before sending the notification Reference the generated documents in the notification request using dynamic keys:
This integration creates a complete communication flow where personalized documents are automatically generated and sent to recipients.
Missing Kafka topics
Ensure that all required Kafka topics are properly configured in your environment variables. Check the Platform Status screen for confirmation that topics are available and accessible.
Notification not received
Verify that the receiver information is correct and that your template is properly configured. Check the audit log for any error messages in the notification response.
Template rendering issues
If your notification is sent but doesn’t display properly, check that all template variables are correctly defined and that the contentParams in your request match the expected template variables.
Dynamic key not resolving
If a dynamic key isn’t displaying the expected value, verify the path is correct and that the data exists in the process context. Dynamic keys are case-sensitive and must match the exact path to the data.
Attachment problems
For issues with attachments, ensure the document was successfully generated and stored before attempting to attach it. Check that the path and filename are correctly specified in the attachment configuration.