Background
Configuration
When Does FastComments Send Notifications?
At FastComments, we know you get enough notifications already. Because of this, we take some measures to limit the notifications users receive while still keeping them in touch with their communities. We also want to keep administrators and moderators up to date and let them know when action needs to be taken.
We'll send notifications for the following events for administrators and moderators:
- Community Digest Summary (frequency configurable).
- Community help requests and reminders.
- New Comments This Hour.
For Commenters:
- When someone replies to your comment (via email).
- When you are mentioned (in-app and email notification).
- When someone replies in the same thread (in-app and email notification).
- When someone replies to a child comment in the same thread (in-app and email notification).
- When someone replies to a page you have subscribed to (in-app and email notification).
- When a user comments for the first time (But not with SSO).
- When a user leaves a comment in a session that is not verified (But not with SSO).
- We do not send multiple verification emails in this case. Only the first one, which will verify all activity in the same session.
...and finally for administrators only:
- When integrations are complete.
- When migrations are complete.
- When imports or exports finish.
- When there are billing issues.
- Trial-end reminders.
Some notifications are batched up to prevent mass-sending of notifications to users. Learn about this in the next section Notification Types
.
Notification Types
There are a few types of notifications and mediums in which FastComments sends notifications:
- Immediate via email.
- Immediate via app.
- These are shown under the notification bell icon.
- Batched via email.
- These are batched up on a per-hour basis. If there is nothing to send for the user in that timeframe, we do not send an email.
- Timed via email.
- Examples include the Community Digest Summary which can be sent daily, weekly, or monthly (or disabled).
Opting Out
Notifications can be opted out in several ways. If your account is managed by FastComments.com and not via SSO, you can configure your notifications via the Notifications Settings page.
Here you can configure comment reply and mention notifications, hourly new comment notifications, and any notification in general. If you are a site admin or moderator you will have the option of configuring the Digest Email frequency here as well.
Additionally, each email contains an opt-out link. For comment reply notifications, the email contains a link to opt out of notifications for that comment.
Notifications will also have an unsubscribe link for turning them off, as well as the appropriate email headers.
Unsubscribe links in emails can be removed at request for a given tenant. Additionally, the link can be customized for SSO or whitelabel integrations.
Configuring Notifications for SSO
For SSO there is the following configuration to consider for notifications:
- Whether the user has opted into notifications.
- This is done by setting the
optedInNotifications
flag totrue
orfalse
in theSSOUser
object. - This can be set via the API.
- Also, if you pass a value for this flag in the payload, it will automatically be updated when the user loads a comment thread.
- This is done by setting the
- Whether the user has opted into subscription notifications.
- This is done by setting the
optedInSubscriptionNotifications
flag totrue
orfalse
in theSSOUser
object. - This can be set via the API.
- Also, if you pass a value for this flag in the payload, it will automatically be updated when the user loads a comment thread.
- This is done by setting the
- Defining their email.
- If not present, we can't send email based notifications.
- Whether to disable unsubscribe links in emails.
- This is done via the
disableUnsubscribeLinks
flag in theTenant
object. - This can be set via the API.
- This is done via the
- Whether to use a custom unsubscribe link.
- This is done via the
footerUnsubscribeURL
property on theDomainConfig
object. - This can be set via the API.
- You may also want to consider setting the relevant unsubscribe headers via
emailHeaders
in the same object.
- This is done via the