SpeckyDocs

Telegram Integration

What it does

Import feedback from a Telegram group or channel, and let people message your bot directly.

How your data reaches Specky

Telegram has no history endpoint Specky can query, so data arrives only by webhook — Telegram tells Specky the moment something happens. That has one consequence worth reading twice:

Nothing that happened before you set the webhook up is recoverable. There is no backfill and no Sync button, because there would be nothing for it to fetch. Set the webhook up first, then generate the activity you care about.

What you'll need

  • Bot Token (Required) — Token for a bot created via @BotFather.
  • Chat ID (Required) — The group/channel chat ID to post updates to. DM @userinfobot in the group to find it.

    • Setup

    Go to Settings → Integrations, find Telegram, and click Connect.

    How to create a Bot

  • Open Telegram, message @BotFather
  • Send /newbot and follow the prompts to name your bot
  • Copy the token BotFather gives you (looks like 123456789:AA...)
  • Add the bot to your community group or channel (as an admin if you want it to read all messages, not just mentions)

    • Finding your Chat ID

  • Add @userinfobot to the same group briefly, or forward a message from the group to it
  • It will reply with the numeric Chat ID (negative for groups/channels)

    • What Specky does with your bot

  • Registers a webhook so messages sent in the group are ingested as feedback signals in real time (no manual sync needed)
  • Anyone who messages the bot directly gets a reply — /book sends your booking link, anything else is logged as feedback with a thank-you
  • Can post stakeholder updates and digests back into the connected chat

    • Data synced

    DataUsed for

    Messages sent in the connected chatCommunity feedback, bug reports, feature requests Direct messages to the botAd-hoc customer feedback and booking requests

    After connecting

    Everything Specky pulls in from Telegram shows up in Discovery alongside your other sources, and feeds synthesis, clustering, and the AI chat's answers about your product. You don't have to do anything with it directly — it's there so the rest of Specky has something to reason over.

    Disconnecting Telegram removes both the connection and the signals it brought in.

    Troubleshooting

  • Connected, but nothing appears. Check the webhook on the Telegram side: that it points at the URL in the setup steps above, and that it's subscribed to the right events. Nothing reaches Specky without it.
  • "Upgrade to connect". Your plan caps how many integrations you can connect at once, and a few providers are Scale-only. Settings → Usage shows where you stand.
  • Credentials stopped working. Tokens expire and get revoked. Reconnect with a fresh one — your existing signals are kept.

    • See the Telegram integration page for what it's for and the questions people usually ask first, or the Integrations Overview for how integrations work in general.