Sending e-mail notifications

Overview

In Kuroco, you can create periodic notifications (such as newsletters) using the Notification module. Each entry or issue is called a "message", which can be managed through the Messages sub-module.

This tutorial explains the full delivery workflow of a simple e-newsletter issue.

What you'll learn

After completing this tutorial, you will know how to:

Before you start

For this tutorial, we will be adding recipients to our mailing list from a custom member filter.
We will create a custom member filter called "Premium members" before add Notification. A detailed guide on how to do this can be found in Tutorial: Using custom member filters.

Make custom member filter

Filter conditions can be specified on the custom member filter screen. In the sidebar menu, select [Member] -> [Custom member filter] in the sidebar menu.

Image from Gyazo

The Custom member filter list will open in a new browser tab. From there, click [Add] in the upper right corner.

Image from Gyazo

Set up a new filter called "Premium members". A detailed guide on how to do this can be found in Tutorial: Using custom member filters.

Image from Gyazo

Creating a notification

In the sidebar menu, select [Campaign] -> [Notification].

Image from Gyazo

On the Notification list screen, click [Add] in the upper right corner.

Image from Gyazo

For demo purposes, we will create a periodic notification called "Kuroco newsletter".
Fill in the following information in the editor:

FieldSub-fieldValue
NameKuroco newsletter
InformationEnter a short description of your notification (optional).
SenderE-mail addressEnter your "From" e-mail here (default = noreply@kuroco-mail.app).

Image from Gyazo

Click [Add] at the bottom of the screen.

Image from Gyazo

Specifying the default recipients

Next, set the recipients of this notification series.

With the subscriber list

Click the [Subscribers] tab.

Image from Gyazo

On the Subscribers screen, enter the member ID or e-mail (if member ID is not available) of the recipient and click [Add].

Image from Gyazo

Verify the new entry in the notification subscriber list at the bottom.

Image from Gyazo

Now, go back to the [Basic settings] tab.

Image from Gyazo

In "Default recipients", select "Send to subscribers".

Image from Gyazo

With a custom member filter

In "Default recipients" of the Basic settings tab, select "Premium members" from the dropdown list on the right.

Image from Gyazo

Click [Set recipient(s)]. The filter name will appear under <> on the left.

Image from Gyazo

Verifying the mailing list

Click [Verify recipients] to view the recipients' e-mail addresses.

Image from Gyazo

If there are no errors, click [Update] to save the settings.

Image from Gyazo

If a selected recipient does not appear in the list, verify if "Don't subscribe to notifications" is unchecked on their Member editor page. For more information, see User guide: Member editor.

Composing a new message

Next, add a new entry to your newsletter.
In the notification editor, click the [Messages] tab.

Image from Gyazo

On the Messages screen, click [Add] in the upper right corner.

Image from Gyazo

Fill in the required fields in the Message editor. (For a detailed explanation of each field, see User guide: Notification messages.)

Image from Gyazo Image from Gyazo

Under "Send test", you can enter your own e-mail address and click [Send test] to see a sample of the newsletter issue that will be delivered.

Image from Gyazo Image from Gyazo

When you are done, click [Save as pending].

Image from Gyazo

You will receive a confirmation prompt. Click [Yes]. The notification will be sent out to your mailing list.

Image from Gyazo

Scheduled delivery

In the above example, we selected "Send now" in "Send date and time" to dispatch the notification message immediately after saving it. Alternatively, you can schedule the delivery by manually setting the date and time.

Image from Gyazo

Then, edit your message as usual and click [Save as pending].

Verifying the delivery status

You can verify the statuses of all the messages in a notification on the Messages screen.

Image from Gyazo

More information

If you have any other questions, please use our contact form or Slack workspace.