Spec / Integrations

Telegram bots are verified by placing a one-time token in your bot's BotFather description. After that, AI Identity proxies the Passport into your bot's responses automatically — nothing per-message to install.

telegram.org

1Issue an AI Identity

If you haven't already, create an identity for this agent in the dashboard. Free for the first identity per account.

Issue identity

2Register your surface

On the identity's edit page, add the agent's endpoint to Surfaces using the telegram scheme:

Surface format

telegram:@{username}

Example

telegram:@my_support_bot

3Carry the Passport in Telegram

Click Issue Passport on the identity detail page to generate a signed token. Then drop it into your Telegram agent using one of the snippets below. Replace <PASSPORT_TOKEN> and <IDENTITY_ID> with the values shown in the dashboard.

One-time install (no code)

text

1. /dashboard/identities/<your-id>/website  → "Verify Telegram"
2. We give you a token like  AII-VERIFY-x4q7m
3. In Telegram, message @BotFather:  /setdescription
   Paste the token in your bot's description.
4. Click "I've added it" — verification is instant.

How verifiers consume this

Verifiers query Telegram Bot API getChat to read the bot's bio at verification time. The Passport itself is published into the AI Identity registry under your bot's `surfaces[]`, so anyone can /api/v1/whois the bot's username.

← All integrations

Read the core spec Issue identity