Alerts, Reports & Webhooks
The Notifications hub groups three ways to stay informed without watching the dashboard: Alerts, Reports, and Webhooks. Telegram bot setup lives in Settings and is covered at the bottom.
→ Open it: app.synaptyx.pro/dashboard/notifications
Alerts
Threshold rules on your metrics that fire when something changes — a CR drop, a CPA spike, an ROI threshold — and can even take action automatically.
| Aspect | Options |
|---|---|
| Metrics | clicks, conversions, revenue, spend, cr, epc, cpa, roi, roas |
| Operators | >, >=, <, <=, = (conditions combine with AND) |
| Noise control | A minimum-clicks floor, a cooldown, snooze, quiet hours, and a minimum severity |
| Severity | info < warning < critical (critical can override quiet hours) |
Actions when an alert fires:
| Action | Effect |
|---|---|
notify | Send to Discord / Telegram / Slack / email / push / webhook |
pause_campaign | Automatically pause a losing campaign |
resume_campaign | Resume it |
scale_budget | Push a budget change to Facebook |
Rules are evaluated every ~60 seconds; each firing is recorded as an Alert Event you can review (and acknowledge) in the Alert Feed.
📷 Replace with /screenshots/alert-rule.png — the alert rule editor.
Reports
Scheduled, white-labeled performance reports delivered on a cadence.
| Setting | Options |
|---|---|
| Frequency | daily, weekly (pick a day), monthly (pick a date) |
| Time | An hour in UTC |
| Branding | Company name, brand color, logo — your report, your brand |
| Delivery | Email, Telegram, push |
| Contents | Grouping, date range, specific campaigns, timezone |
Great for sending clients or partners a clean recap without giving them dashboard access. (Affiliate payout statements are generated similarly.)
Alerts, Scheduled Reports, Affiliates, and Integrations are Pro/Scale features — see Plans & Billing.
Webhooks
Outbound HTTP POSTs to your own endpoint when events happen — so you can wire
Synaptyx into your own systems. Payloads are HMAC-signed (X-Synaptyx-Signature)
so you can verify authenticity.
Canonical events:
| Event | Fires when… |
|---|---|
conversion.created | A conversion is recorded |
conversion.approved / conversion.rejected / conversion.refunded / conversion.restored | Its status changes |
alert.triggered | An alert fires |
affiliate.payout.weekly | A weekly affiliate payout is computed |
campaign.budget_exceeded | A campaign passes its budget |
Deliveries are queued and retried with exponential backoff (up to 5 attempts), with a
per-delivery audit trail (pending → delivered / retrying / failed).
Telegram bots
Set up once in Settings → Telegram, then reuse across alerts, reports, and builder notifications. Two modes:
| Mode | What it is |
|---|---|
| BYOB (bring your own bot) | Paste your own @BotFather token (stored encrypted). |
| Platform | Use the shared Synaptyx bot — no token needed. |
Saved chats (private chats, groups, supergroups, channels, and forum topics) are
discovered automatically and claimed with a /sync <code> command, then selectable in
any Telegram notification.