Configuring the BPM to send emails

Home > How To > Service Manager > Configuring the BPM to send emails

Introduction This How To guide will help you configure your BPM to send emails when certain conditions have been met. It also contains a brief explanation of some of the key things to check should you experience an issue where you expect a BPM to send out emails but it does not. This guide should be used in connection with the Email Notifications section of the Service Manager Business Process guide on https://wiki.hornbill.com/index.php/Service_Manager_Business_Process_Workflow

Related Articles Configuring the BPM to send emails BPM sending emails after x number of days

Configuring the BPM to send emails

Generally, the BPM will send out emails based on the email template and these emails will be triggered if certain conditions are met in the BPM. The BPM can be used to send email notifications to:

• Email Contact

• Email Co-worker

• Email Customer

• Email Customer's Manager

• Email External Address

• Email Request Owner

as mention on the https://wiki.hornbill.com/index.php/Service_Manager_Business_Process_Workflow page. The screenshots below show a node in a BPM that has been set up to send emails to a customer when a call is logged.

In the screenshots above, the node 'Email New Incident Confirmation' is an Automated Task which has options to send an email confirmation of a new incident using the Servicedesk mailbox and the EmailConfirmationNewIncident template. In this case the mandatory values are the:

• Mailbox name
• Template name

The RequestId is also mandatory but that will be automatically picked up. In the request, this appears as shown below:

When emailing Co-workers, Customers and Customer Managers, in the PROCESS part of the BPM node, change the Task accordingly:

• To send an email notification to a Co-Worker, change the Task to 'Email Co-worker'

• To send an email notification to a Customer, change the Task to 'Email Customer'

• To send an email notification to a Customer Manager, change the Task to 'Email Customer's Manager'

In other scenarios you may need the email to go to a specific team whose email address is not held in Hornbill so it may be worth introducing the External address option as shown:

Sometimes it may be necessary to create a new BPM based on requirements and in such as a case, rather than creating a new BPM, you can make a copy of an existing one. However, remember to associate this new BPM to the Shared Mailbox and rectify the Email template being used.

BPM Error notifyEmailExternalAddress

In the unlikely event that after setting up the BPM with the correct mailbox and template you get an error message referring to the notifyEmailExternalAddress, this could be caused by not populating some values in the BPM. Ensure the following are populated correctly:

• Mailbox name
• Template name
• External email address