Skip to content

o-danalyst/Saas-Analytics-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SaaS Intelligence Bot

Upload your data. Get a full analyst report. In 90 seconds.


The Problem It Solves

Most SaaS founders are sitting on months of subscription data they never fully analyse. Hiring an analyst is expensive. Doing it manually is slow. And by the time insights are ready, the window to act has already closed.

The SaaS Intelligence Bot eliminates that gap entirely.


How It Works

3 steps. No technical skill required.

  1. Send a ZIP file containing 3 months of subscription CSVs to the Telegram bot
  2. The bot automatically cleans, analyses and generates AI-powered insights in the background
  3. You receive a complete 4-page PDF intelligence report in under 90 seconds

No analyst. No spreadsheet. No waiting.


What You Get In The Report

Dataset Intelligence Summary Files processed, rows analysed, unique customers, duplicates automatically removed before analysis begins.

Business Health Score (1–100) A programmatic score built from 4 weighted components — churn control, growth rate, ARPU stability and customer acquisition. Colour coded: 🟢 Healthy | 🟠 Moderate | 🔴 At Risk.

AI Score Narrative A plain-language explanation of exactly why your business scored the way it did and what is driving the result.

Executive KPI Dashboard MRR, active customers, churn rate, growth rate, ARPU and new customers — all calculated automatically from your raw data.

Monthly Trend Breakdown A side by side table showing how every key metric moved across all 3 months.

Performance Charts

  • MRR trend line chart
  • Active customer growth bar chart
  • Monthly churn rate chart with 5% risk threshold line

AI Executive Analysis

  • Executive summary of business performance
  • KPI interpretation in plain language
  • Churn risk assessment with risk level and contributing factors
  • Growth opportunities specific to your data
  • Strategic and actionable recommendations

What Makes It Different

It handles real-world dirty data. Most analytics tools break on inconsistent data. This bot handles 4 date formats, mixed MRR formatting, status synonyms, plan casing inconsistencies and duplicate rows — automatically, before a single calculation runs.

It thinks like an analyst, not a spreadsheet. The health score is not a vanity metric. It is built from a weighted formula that mirrors how an experienced operator would evaluate subscription business health — prioritising churn control and growth rate above everything else.

It scales to 100 concurrent users. Every report is isolated by chat ID — multiple founders can run simultaneously with zero interference.


Sample Output

See exactly what a founder receives 👇

📄 552793721_saas_report.pdf — Full sample intelligence report

🗂️ Test it yourself with the included datasets:

  • SaaS-Intelligence.zip — Clean dataset
  • SaaS-Intelligence-DIRTY.zip — Dirty dataset to test data cleaning capabilities

Tech Stack

Layer Tool Purpose
Automation Platform n8n (self-hosted) 32-node workflow orchestration
Messaging Interface Telegram Bot API User input and report delivery
AI Provider Groq API (llama-3.1-8b-instant) Strategic analysis and health score narrative
Data Processing JavaScript KPI engine and data cleaning
Chart Generation Python + Matplotlib MRR, customer growth and churn charts
PDF Generation Python + wkhtmltopdf Professional A4 report output

Setup Instructions

Prerequisites

  • n8n self-hosted (v1.x)
  • Python 3.8+ with matplotlib (pip install matplotlib)
  • wkhtmltopdf installed and on PATH
  • Telegram Bot Token (from @BotFather)
  • Groq API Key (free tier) → https://console.groq.com
  • Folder C:\n8n-workspace\ created on host machine

Steps

  1. Import saas_bot_final.json into n8n
  2. Open Set Bot Config node → replace YOUR_TELEGRAM_BOT_TOKEN_HERE and gsk_YOUR_GROQ_KEY_HERE
  3. Select your saved Telegram credential in every Telegram node
  4. Activate the workflow
  5. Send SaaS-Intelligence.zip to your bot on Telegram

Expected CSV Format

ZIP must contain month1.csv, month2.csv, month3.csv at root level. Each CSV requires: date, customer_id, mrr, plan, status


👤 Author

Clinton Onaga
Macro Analyst | AI Automation Engineer

I build AI-powered automation systems that turn raw business data into decision-ready intelligence — delivered automatically, without manual intervention.

This bot is one example of that. The analytical framework behind the health score and AI insights reflects the same macro-to-micro thinking I apply across all my work.

GitHub Profile | LinkedIn


SaaS Intelligence Bot | Built with n8n + Groq AI + Python

About

n8n workflow automation bot — processes raw SaaS CSV data and returns a full AI-generated PDF intelligence report via Telegram. Powered by Groq AI + Python + wkhtmltopdf.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors