Notification Settings

The notification system automatically delivers scheduled task results via email and webhooks. Once admins pre-configure notification channels, users select a channel when creating scheduled tasks to receive result notifications.

Notification Architecture

Stage	Owner	Description
Channel setup	Admin	Pre-configure SMTP, SendGrid, Azure Email, Slack, etc.
Channel selection	User	Specify notification channel and trigger condition in the schedule
Notification dispatch	System	After scheduled task runs, deliver result to selected channel

Email Channels

Add email channels in Admin > Settings > Notifications or the dedicated notification management screen. Register multiple channels to use different sender configs per team.

Add Channel

Click the + icon button on the right of the Email section. (Tooltip: “Add Email Channel”)

Field	Description
Channel name	Identifier name (e.g., “Default”, “Marketing Team Mail”)
Email Provider	Choose SMTP, SendGrid, Azure Email, or MS Graph

Per-Provider Settings

SMTP
SendGrid
Azure Email
MS Graph

Connect your internal mail server or external SMTP service (Gmail, Outlook, etc.).

Setting	Description	Example
Server	SMTP server address	smtp.gmail.com
Port	SMTP port	587 (TLS) / 465 (SSL)
Username	Auth account	noreply@company.com
Password	Auth password
Use TLS	Enable TLS encryption	Use on port 587
Use SSL	Enable SSL encryption	Use on port 465
Sender address	From email address	noreply@company.com
Sender name	From name	Cloosphere

TLS and SSL can’t be used together. Use TLS on port 587 and SSL on port 465.

Setting	Description
API Key	SendGrid API key
Sender address	SendGrid-verified sender email
Sender name	From name

Email sending via Azure Communication Services.

Setting	Description
Connection String	Azure Communication Services connection string
Sender address	Azure-provisioned sender email (e.g., `DoNotReply@your-domain.azurecomm.net`)
Sender name	From name

Send directly from Microsoft 365 mailboxes — use your corporate domain sender address without SPF/DKIM setup burden.

Setting	Description
Tenant ID	Microsoft Entra ID tenant ID (GUID)
Client ID	Application (Client) ID of the Entra app registration
Client Secret	Entra app’s client secret (auto-masked on save)
Sender Email	Email address of the sending mailbox (e.g., `noreply@your-domain.com`)
Sender name	From name

The Entra app must have Mail.Send Application permission with admin consent. Since this uses app permission (not delegated), the system must be allowed to send mail directly from the specified sender mailbox.

Test Connection

Click the Test button to verify mail server connection.

Test Connection and Send Test Email are only available in edit mode after saving the channel. When adding a new channel, save first, then reopen and test.

Result	Description
Success	Server connection and authentication both OK
Auth failure	Verify username/password
Connection failure	Verify server address, port, firewall
Timeout	Verify network connection

Send Test Email

In the Send Test Email section, enter a recipient address and click Send to verify actual email delivery.

Enter recipient email

Enter the address to receive the test email.

Click Send

Click the Send button.

Verify reception

Verify test email reception in the inbox (including spam folder).

Webhook Channels

Connect with external messaging services to send notifications.

Add Channel

Click the + icon button on the right of the Webhook section. (Tooltip: “Add Webhook Channel”)

Field	Description
Channel name	Identifier name (e.g., “Engineering Slack”)
Provider	Slack / Microsoft Teams / Discord / Telegram / Google Chat
Webhook URL	Receiving webhook URL from the provider (except Telegram — see below)

Telegram uses Bot Token and Chat ID instead of webhook URL. The input form auto-changes when Telegram is selected.

Per-Provider Settings

Slack
Teams
Discord
Telegram
Google Chat

Generate webhook URL:

Enable Incoming Webhooks in your Slack app management page
Click Add New Webhook to Workspace
Pick a channel and click Allow
Copy the generated URL (https://hooks.slack.com/services/...)

Notification format: Header block + Fields (prompt, completion time) + Section (result) + chart image

Generate webhook URL:

Configure Connectors or Workflows on the Teams channel
Add Incoming Webhook
Set name and click Create
Copy the generated URL (https://...webhook.office.com/...)

Notification format: Adaptive Card 1.5 — TextBlock, FactSet, Table + chart image

Generate webhook URL:

Discord channel settings > Integrations > Webhooks
Click New Webhook
Set name and Copy Webhook URL (https://discord.com/api/webhooks/...)

Notification format: Embed — Title + Fields + Description + chart image (first only)

Telegram uses Bot Token + Chat ID instead of webhook URL.Bot setup:

Create bot via @BotFather and obtain Bot Token
Add the bot to channel/group
Get Chat ID (group/channel ID, e.g., -1001234567890)

Setting	Description
Bot Token	Token issued by BotFather
Chat ID	Chat room ID to send notifications to

When Telegram is selected, the form shows Bot Token and Chat ID fields instead of webhook URL.

Generate webhook URL:

In Google Chat space, pick Apps & integrations > Webhooks
Set name and Save
Copy the generated URL (https://chat.googleapis.com/v1/spaces/.../messages?key=...)

Notification format: Simple text message (same text payload as Slack)

Test Webhook

Click Test Webhook to send a test message in the selected provider’s format.

Test Webhook is only available in edit mode after saving the channel.

Schedule Notification Integration

After admins configure channels, users configure notifications in scheduled tasks.

Trigger Conditions

Condition	Description	Use Case
Always	Notify on success and failure	Critical schedule monitoring
Success only	Notify only on successful completion	Regular report delivery
Failure only	Notify only on errors	Failure detection alerts

Multiple Notifications

A single scheduled task can have multiple notification channels.

Notification	Channel	Target	Condition
Notif 1	Email	Team Lead	Always
Notif 2	Slack webhook	Engineering channel	Failure only
Notif 3	Teams webhook	Executive channel	Success only

Chart Image Delivery

Plotly charts generated by DbSphere agents are server-side rendered to PNG images and included in notifications.

Channel	Method	Description
Email	Inline Base64	Image directly embedded in body
Slack	Image URL	Displayed as image block
Teams	Adaptive Card	Image element in card
Discord	Embed image	Only first chart included
Google Chat	Text	Same text payload as Slack

Chart images are auto-extracted before notification dispatch. Chart markers are removed from the notification body so clean text is delivered.

Troubleshooting

Email issues

Symptom	Check
Connection failure	Verify server address, port. Check firewall SMTP port allowance
Auth failure	Verify username/password. Google requires app passwords
Email not received	Check recipient spam folder. Verify sender domain SPF/DKIM
TLS error	Verify TLS/SSL setting and port combination (587-TLS, 465-SSL)
SendGrid error	Check API key permission. Verify sender address verified
Azure Email error	Check Connection String validity. Verify sender provisioned in Azure

Webhook issues

Symptom	Check
Send failure	Check webhook URL validity. Check if URL has expired
Message not shown	Check target channel/app permissions. Check if bot can access channel
Timeout	Check network connection. Check firewall outbound HTTPS allowance
Format broken	Check provider setting (Slack/Teams/Discord/Telegram/Google Chat selection correct)

General issues

Symptom	Check
No notifications	Check schedule’s notification settings. Verify trigger condition correctness
No chart image	Verify the agent is connected to DbSphere

Admin

System Settings

Others

Notification Architecture

Email Channels

Add Channel

Per-Provider Settings

Test Connection

Send Test Email

Webhook Channels

Add Channel

Per-Provider Settings

Test Webhook

Schedule Notification Integration

Trigger Conditions

Multiple Notifications

Chart Image Delivery

Troubleshooting

Admin

System Settings

Others

​Notification Architecture

​Email Channels

​Add Channel

​Per-Provider Settings

​Test Connection

​Send Test Email

​Webhook Channels

​Add Channel

​Per-Provider Settings

​Test Webhook

​Schedule Notification Integration

​Trigger Conditions

​Multiple Notifications

​Chart Image Delivery

​Troubleshooting

Notification Architecture

Email Channels

Add Channel

Per-Provider Settings

Test Connection

Send Test Email

Webhook Channels

Add Channel

Per-Provider Settings

Test Webhook

Schedule Notification Integration

Trigger Conditions

Multiple Notifications

Chart Image Delivery

Troubleshooting