Send GA4 reports to Telegram every day.

Why send GA4 reports to Telegram?

GA4 is useful for deep analysis, but daily monitoring should be lighter. A Telegram report makes the important numbers visible where the team already communicates.

Web Analytics Reporter is designed for a simple routine: fetch yesterday's metrics, format them clearly, and send them to one Telegram chat on a schedule.

Setup overview

1. Create a GA4 property for your website.
2. Enable the Google Analytics Data API in Google Cloud.
3. Create a service account and add it to GA4 with Viewer access.
4. Create a Telegram bot with BotFather and get the chat ID.
5. Run runDailySummary() from Vercel Cron, GitHub Actions, Netlify, Railway, Express, or another Node.js scheduler.

Minimal Node.js example

const {
  ga4Source,
  runDailySummary,
  telegramDestination
} = require("web-analytics-reporter");

runDailySummary({
  source: ga4Source({
    clientEmail: process.env.GOOGLE_CLIENT_EMAIL,
    privateKey: process.env.GOOGLE_PRIVATE_KEY
  }),
  destination: telegramDestination({
    botToken: process.env.TELEGRAM_BOT_TOKEN
  }),
  sites: [
    {
      id: "marketing",
      name: "Marketing Site",
      ga4PropertyId: process.env.GA4_PROPERTY_ID,
      telegramChatId: process.env.TELEGRAM_CHAT_ID
    }
  ],
  timeZone: "UTC"
});

What the report includes

• Users, sessions, and page views with previous-period comparison.
• Top countries so you can see where traffic is coming from.
• Top sources so you can spot search, social, referral, or direct traffic shifts.
• Top pages so you can see which URLs are getting attention.
• Custom events such as downloads, signups, guide clicks, or support clicks.

Start with dryRun before sending a real Telegram message. It lets you verify GA4 access and preview the final report text.

Related guides