This guide explains how chat emails, notification rules, scheduled sending, and in-app alerts work in Task Session.
1. Types of Notifications
There are four different systems:
- Inbox Mail
Connected email (Gmail, Outlook, SMTP) used inside the system. - System Emails
Automated emails such as invites, password reset, and summaries. - Chat Email Notifications
Emails triggered by chat activity based on settings. - Bell Notifications
In-app alerts only. These do not send emails.
2. Global Settings (Admin)
Go to:
Admin ? Chat Settings
Page path: admin/chat-settings.php (example URL: https://yourdomain.com/admin/chat-settings.php)
Configure:
- Admin email notifications
- Staff email notifications
- Client email notifications
- @Mention email behavior
These settings apply across the system.
3. Project / Task Settings
Each project, group, or task can override global settings. Open Email notifications from the place you are working (for example a project discussion, group chat, or task screen).
Example page paths:
- Project discussion:
discussion.php?project_id=… - Internal / group chat:
chatting.php(e.g.chatting.php?group=…orchatting.php?user=…) - Task chat: open the task (e.g. from project board or task URL) and use the email notifications entry there.
Options:
- Use default settings
- Apply custom notification settings
4. Email Logic
The system processes notifications in this order:
- Global settings (Chat Settings)
- Project / group / task settings
- User preferences
@Mentions can send emails even if general notifications are disabled.
5. Scheduled Sending (Cron)
Chat emails are not sent instantly.
Admin cron screen: admin/cron.php — use this to see or enable scheduled jobs when your build lists them there. The server must also run the project root cron.php (or individual scripts under cron/) on a schedule, as your host documentation describes.
They are:
- Collected
- Sent in batches
- Triggered by scheduled jobs (cron)
Cron must be active for:
- Direct chats
- Group chats
- Task chats
- Project discussions
6. Email Templates
Go to:
Admin > Email Setting
Page path: admin/email-setting.php (example URL: https://yourdomain.com/admin/email-setting.php)
Configure:
- Email subject
- Email content
Templates may include dynamic placeholders such as user name, project name, and links.
7. Bell vs Email
- Bell notifications are in-app only (shown in the top header on every main page).
- Email notifications require:
- Templates —
admin/email-setting.php - Cron —
admin/cron.php/ server schedule +cron.phpat site root - Mail configuration — general site & SMTP:
admin/system-settings.php; connected inbox (Gmail/Outlook/SMTP):admin/email-setup.php(names may match your menu: Email Settings / Setup)
- Templates —
8. After Update
After upgrading:
- Run system updates or migrations
- Verify settings are saving correctly
9. Troubleshooting
No emails:
- Check cron job
- Check templates are filled
- Confirm unread activity exists
Incorrect behavior:
- Review project-level settings
- Reset to default if required
Bell working but no email:
- Check email system configuration
Summary
For email notifications to work:
- Configure Chat Settings
- Set Email Templates
- Ensure cron jobs are running
Bell notifications operate separately from email notifications.

