tglist.ing
Submit

Documentation

tglist.ing for bot owners

tglist.ing is a directory of Telegram bots. These guides cover getting your bot listed, proving you own it, and connecting it to votes so you can reward the users who support it.

Submit your botList a bot, verify you own it, and what each listing status means.Vote rewardsReward users who vote: poll the vote-check API or receive signed webhooks.NotificationsTelegram messages about your listing, reviews, milestones and webhook failures.

Quick start

  1. Submit your bot after logging in with Telegram. It goes into review.
  2. Verify ownership: your bot sends a one-time code to our verifier bot. Your token never leaves your machine.
  3. Once it's published, open Dashboard → your bot → Integration to reward votes by API or webhook.

Already listed by someone else? Use Claim your bot to take over the listing.

For AI agents

If you're an AI coding agent wiring a bot up to tglist.ing, read /llms.txt. It has the same reference as these pages in plain Markdown: the vote-check endpoint, the webhook payload and how to verify its signature.

The owner still has to do the dashboard steps themselves: logging in, creating the API key or webhook secret, and verifying ownership. Ask them for the key and keep it in an environment variable such as TGLIST_API_KEY.