Skip to main content
Connect Shoal to Telegram for daily intelligence digests delivered to your team’s channel or group. The bot fetches top signal events and formats them as a clean, numbered digest.

What You Get

  • Daily digest — Top signal events ranked by signal score, delivered on schedule
  • Clean formatting — Numbered list with bold titles, signal scores, and concise summaries
  • Channel or group delivery — Works with Telegram channels, groups, and supergroups

Digest Format

The daily digest is formatted as a single message:
Events are ranked by signal score (higher = more significant relative to baseline social impressions). Each entry includes:
  • Rank and title (bold)
  • Signal score — ratio of actual impressions to platform baseline
  • Summary — concise 1-2 sentence description
The examples below use the canonical event aliases (summary, owners, significance) rather than the older compatibility fields.

Setup

1. Create a Telegram Bot

Message @BotFather on Telegram:
Follow the prompts to name your bot. BotFather gives you a token like 8345440207:AAFOdtxvg8FlzxIwrPbe6siNMoRg9gMYF4I.

2. Get Your Channel ID

Add the bot to your channel/group as an admin, then send a message. Fetch the chat ID:
Look for "chat": {"id": -100XXXXXXXXXX} — that negative number is your channel ID.

3. Configure Environment

4. Example Script

Run this on a cron schedule (e.g., daily at 9 AM) to deliver a morning digest.

Architecture

Unlike the Slack integration (which runs continuously), the Telegram integration is typically run as a scheduled task — a cron job, GitHub Action, or serverless function that fires once or twice per day.

Comparison