# Managing notifications

## Overview[¶](https://github.com/ToucanToco/doc-v3/blob/main/collaboration/broken-reference/README.md)

With Toucan, you can notify users by email or web push notifications.

Notifications are event-based, meaning a notification will be sent when something specific happens on the app.

Notification emails are set up by default at your platform level.

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-04d295a7734de0e61995edaf726d27fac9b92e80%2FScreenshot%202024-09-16%20at%2017.23.14.png?alt=media" alt=""><figcaption></figcaption></figure>

You can also customize the emails for each application:

* Go into the staging environment of the app
* Click on the cogwheel icon and click on "Themes"

<img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-362e3729f5c55f2d0bd5e07df5e1b280d2ddba57%2FApp-settings-notifications.png?alt=media" alt="" data-size="original">

* Click on the tab "Notifications"
* If a Notification template is customized at the app level, it will overrule the platform template. Meaning your users will receive the customized template.

**Language**

All emails will be sent in the platform's default language. This default language can be set up from the `instance_settings.cson` file.

## Email categories

### Inform and perform[¶](https://github.com/ToucanToco/doc-v3/blob/main/collaboration/broken-reference/README.md)

#### **New Data Available**

When you publish to production, let your users know something new is available!

#### **Scheduled Task Failed**

As an admin, you can set up notifications to know when a scheduled operation fails.

### Users administration[¶](https://github.com/ToucanToco/doc-v3/blob/main/collaboration/broken-reference/README.md)

This category is only available at the platform level and cannot be overruled at the app level.

#### **Generate password**

When an admin invites a user, they receive an email with a temporary password. When they connect for the first time, they have to set up their password. This template is also used when a new user is invited to an application and the **Send password generation email** checkbox is checked.

#### **Reset password**

Did your user forget their password? No worries. They will receive an email to set up a new one once they click the reset password button.

### Onboarding[¶](https://github.com/ToucanToco/doc-v3/blob/main/collaboration/broken-reference/README.md)

#### **Welcome**

When you invite a user to access an app, and if the user has activated their account, they will receive a **Welcome email** to inform them.

The user will receive as many **Welcome emails** as applications they get access to. If the user has not set up their password, the Welcome email will be on hold until the account is activated.

#### Custom[¶](https://github.com/ToucanToco/doc-v3/blob/main/collaboration/broken-reference/README.md)

Use this section to create your very own email templates.

{% hint style="info" %}
**Hint**

You can create custom emails in each category mentioned above
{% endhint %}

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-206882411086e8e2945b2cdd8ae00cc86e279049%2Fcustom-template.png?alt=media" alt=""><figcaption></figcaption></figure>

### Edit an email template[¶](https://github.com/ToucanToco/doc-v3/blob/main/collaboration/broken-reference/README.md)

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-5a83c331847d1a9743e44aa05946984e084cb07f%2Fedit-template.png?alt=media" alt=""><figcaption><p>Templates edition</p></figcaption></figure>

From the edition menu, you can:

* Edit templates in each of the target languages you want it to be accessible.
* Edit the template title
* Edit the email subject
* Edit the email content
* Add variables in the object or content
* Add images (platform assets or application assets)

If you edit a template email, it will be stamped in the notification menu with a blue dot.

👉 The email customized at the application level will overrule the platform template.

### Reset templates

You can also reset templates. You can reset them to the platform’s default at the app level. And from the platform level, you can reset them to Toucan’s default.

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-4b57cde7d31317502ddd36d29bfd69dd9b2e335b%2Freset-template.png?alt=media" alt="Reset notifications templates"><figcaption></figcaption></figure>

## Email automation [¶](https://github.com/ToucanToco/doc-v3/blob/main/collaboration/broken-reference/README.md)

You can define additional custom emails to send reminders to users based on their account status or activity on the platform and app.

> Available events are "User invite date," "User activation date," and "Last connexion date."

It is helpful to:

* Increase **usage rate and user retention** by staying in touch with inactive and inactivated users
* Increase **user adoption** by sending useful and meaningful emails to your active users or by making sure their onboarding is interactive
* and more!

> **Inactive users:** Users who have activated their account and defined their password, but haven't connected to the platform within the last 30 days.
>
> **Inactivated users:** Users who have received an invite but haven't activated their account yet.

{% embed url="<https://drive.google.com/file/d/1qh-8sYNtLNWszSxxAZ2oDeIP3zfGxY-g/view>" %}

Notifications can be sent following a defined **schedule or relatedly to an event**.

In an app in staging mode, go to the "Notifications" tab (CogWeel > Themes > Notifications).\
Hover one template and click on the "schedule icon."

* Select the targeted recipients for this email
  * Me (mainly during testing phase)
  * All Users: select what segment you want to target depending on their activity and activation status.
* Select the date or event trigger that will fire the email.

<table data-header-hidden><thead><tr><th></th><th></th><th data-hidden></th></tr></thead><tbody><tr><td><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-631147980c68eec6bbef56134214aebd98970519%2FNotifications-Schedule-Recipients.png?alt=media" alt="Notifications recipients"></td><td><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-efb77fa057ca73509f761dfad0a44827c945e75f%2FNotificationsDeliveryTrigger.png?alt=media" alt="Notification trigger"></td><td></td></tr></tbody></table>

*👉 You can also set up this email automation from the Actions section: Automations > Actions panel: Add an action*

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-6c6658177dfa19891082802994709c09891f953f%2FScheduledTemplateCornerIcon.png?alt=media" alt=""><figcaption><p>A "calendar icon" in the corner of the template card will identify the scheduled emails.</p></figcaption></figure>

{% hint style="warning" %}
**Warning**

Sending email notifications can be quite intrusive sometimes. Be very careful when you set up such operations. To prevent massive spamming, we have implemented a few rules to ensure a great experience for your users:

* the Welcome email can be sent max 1/week
* the New data available can be sent max 1/every 4 hours
* any custom email can be sent max 1/day
  {% endhint %}

👉 *Note: Users can opt out of any notification at any time.*

## Create notifications based on data changes[¶](https://github.com/ToucanToco/doc-v3/blob/main/collaboration/broken-reference/README.md)

Want to create a notification based on data changes? Use the [Alert](https://docs-v3.toucantoco.com/collaboration/creating-alerts) feature.
