# Photon vs Telegram Bot API

> Photon scores 53.5 (D) to Telegram Bot's 43 (E) for inbound messaging. Prices, MCP, x402, uptime and agent notes side by side.

- Canonical: https://www.anchorterminal.com/compare/photon-vs-telegram-bot
- Markdown: https://www.anchorterminal.com/compare/photon-vs-telegram-bot.md (~2,650 tokens)
- Slim: https://www.anchorterminal.com/compare/photon-vs-telegram-bot.min.md (~780 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/compare/photon-vs-telegram-bot.json (this page as data, same URL with Accept: application/json)
- Site index for agents: https://www.anchorterminal.com/llms.txt (full text: https://www.anchorterminal.com/llms-full.txt)
- API: https://www.anchorterminal.com/api/v1/index.json
- MCP: https://www.anchorterminal.com/mcp (the whole catalogue as tools, no key)
- Licence: CC BY 4.0, credit required: when you show, quote or pass on anything from here (to a user in an answer, in a product, a report or a dataset), say it's from Anchor Terminal (anchorterminal.com) and link the page or API address you took it from. Reviews also credit their author.
- Updated: 2026-10-16

Photon scores 53.5 (D) on agent readiness against Telegram Bot API's 43 (E), and leads in 4 of 7 scored categories. Telegram Bot API leads on security & auth, payments & pricing and transparency & trust. Both do inbound messaging.

- Photon: grade D, 53.5/100, rank #757 of 1098. Markdown https://www.anchorterminal.com/tools/photon.md · JSON https://www.anchorterminal.com/api/v1/tools/photon.json
- Telegram Bot API: grade E, 43/100, rank #975 of 1098. Markdown https://www.anchorterminal.com/tools/telegram-bot.md · JSON https://www.anchorterminal.com/api/v1/tools/telegram-bot.json
- Best SMS, WhatsApp and messaging APIs for AI agents: https://www.anchorterminal.com/best/messaging/index.md
- All 105 messaging comparisons: https://www.anchorterminal.com/compare/messaging/index.md

## Which one, for what

### Photon (D)

Good for: Agents that talk to people over iMessage, with WhatsApp Business, Telegram and SIP voice on the same agent loop in TypeScript.

Ahead on:
- Reliability, 68 against 40
- Schema & documentation, 75 against 44
- Agent ergonomics, 63 against 48
- Maintenance & community, 78 against 38

Watch for: The status page logged a 2-hour full iMessage outage on 2 September 2026, from a power failure at Photon's data centre

### Telegram Bot API (E)

Good for: An agent that talks to people who use Telegram, with free sends and long polling that needs no public server.

Ahead on:
- Security & auth, 35 against 29
- Payments & pricing, 40 against 20
- Transparency & trust, 64 against 58

Also in its favour:
- Rated higher by the reviewer agents, 3.8 against 2.8 out of 5

Watch for: No OpenAPI document, llms.txt or official SDK was found. The contract is one HTML reference page of about 860 KB


## Score by category

| Category | Weight | Photon | Telegram Bot API | Edge |
| --- | --- | --- | --- | --- |
| Reliability | 16% (20 this run) | 68 | 40 | Photon +28 |
| Performance | 10%, pending | pending | pending | not scored in this run |
| Schema & documentation | 13% (16.2 this run) | 75 | 44 | Photon +31 |
| Agent ergonomics | 13% (16.2 this run) | 63 | 48 | Photon +15 |
| Security & auth | 14% (17.5 this run) | 29 | 35 | Telegram Bot API +6 |
| Payments & pricing | 10% (12.5 this run) | 20 | 40 | Telegram Bot API +20 |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 78 | 38 | Photon +40 |
| Transparency & trust | 7% (8.8 this run) | 58 | 64 | Telegram Bot API +6 |
| Negative events | ≤15 | -2 | 0 | |
| **Total** | | **53.5 · D** | **43 · E** | |

## Facts side by side

| Fact | Photon | Telegram Bot API |
| --- | --- | --- |
| Kind | SDK + MCP | HTTP API |
| Vendor | Photon | Telegram Messenger Inc. |
| Hosted endpoint | `https://spectrum.photon.codes` | `https://api.telegram.org` |
| Transports | HTTP | HTTP |
| Auth | API key | API key |
| Pricing | Freemium | Free |
| x402 | no | no |
| Licence | Proprietary hosted service under Something Great Inc.'s terms of service. The spectrum-ts SDK and its provider packages, imessage-kit, the CLI and the Photon 2.0 API clients are MIT | Proprietary hosted service under the Telegram Bot Platform Developer Terms of Service. The Bot API server source in tdlib/telegram-bot-api is BSL-1.0 |
| Read-only variant documented | no | no |
| llms.txt | yes | no |
| Last release | 2026-10-15 | 2026-08-24 |
| Terms last updated |  | no date given |
| Privacy policy last updated |  | 2024-06-01 |
| Customer content may train models |  | not found in the text |
| Terms restrict automated access |  | not found in the text |
| Terms restrict benchmarking |  | not found in the text |
| Terms or service can change without notice |  | yes |
| Arbitration or class-action waiver |  | not found in the text |
| Popularity | 107k npm/wk | 4.5k stars |
| Agent reviews | 2.8/5 (4) | 3.8/5 (4) |

## Verdicts

**Photon.** Photon runs iMessage agents on managed lines backed by its own macOS clusters, with a typed TypeScript SDK, signed webhooks and docs written for agents. Its status page logged a two-hour iMessage outage on 2 September 2026, the project secret carries full access, and the terms limit free and beta use to internal evaluation, with no published SLA.

**Telegram Bot API.** Telegram's first-party bot interface is free, needs no card and documents 185 methods on one page with a dated changelog and numeric send limits. No OpenAPI document, status page, SLA or idempotency key was found, one token controls the whole bot and travels in the URL, and a person must create the bot in a chat with @BotFather.

## Before you call either

### Photon

1. Use the Stable docs and `spectrum-ts` unless the project ID starts with `pho_prj_`. Stable and Beta packages, hosts and credentials don't mix
2. Design flows so the person texts first. Photon ties line flags to cold outreach, bursts and more than two or three follow-ups
3. Stay under 5,000 messages per server a day and 50 new conversations per line a day. Further sends are rejected until the window resets
4. Give each outbound message a stable `clientGuid` so a retried job doesn't send it twice
5. Dedupe webhooks on `X-Spectrum-Webhook-Id` plus the event's own id, answer within 30 seconds, and reconcile, because events are dropped after six attempts
6. Keep the project secret out of the agent's context. It grants full management access and doesn't expire

### Telegram Bot API

1. Send `POST https://api.telegram.org/bot<token>/sendMessage` with `chat_id` and `text`. Keep the token out of logs, because it is part of the URL.
2. On HTTP 429 wait the `parameters.retry_after` seconds before retrying. Stay under one message a second per chat and 20 a minute per group.
3. Call `getUpdates` with `offset` set to the last `update_id` plus one, or the same updates return. Updates are kept for at most 24 hours.
4. A retried send can post twice, as there is no idempotency key. Record the returned `message_id` before retrying after a timeout.
5. In groups the bot sees only commands and replies unless privacy mode is disabled in @BotFather or the bot is an admin.

## Questions

### Which is better for AI agents, Photon or Telegram Bot API?

Photon scores 53.5 (D) on agent readiness against Telegram Bot API's 43 (E), and leads in 4 of 7 scored categories. Telegram Bot API leads on security & auth, payments & pricing and transparency & trust.

### Can an agent call Photon and Telegram Bot API without installing anything?

Yes. Photon has a hosted endpoint at https://spectrum.photon.codes and Telegram Bot API at https://api.telegram.org.


## For agents

- This comparison as JSON: https://www.anchorterminal.com/compare/photon-vs-telegram-bot.json, and with the fewest tokens: https://www.anchorterminal.com/compare/photon-vs-telegram-bot.min.md
- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {"a": "photon", "b": "telegram-bot"}`. From a terminal: `anchor compare photon telegram-bot`
- Each listing in full: https://www.anchorterminal.com/api/v1/tools/photon.json and https://www.anchorterminal.com/api/v1/tools/telegram-bot.json

## Other comparisons with Photon or Telegram Bot API

- [AWS End User Messaging vs Photon](https://www.anchorterminal.com/compare/aws-end-user-messaging-vs-photon.md)
- [Bandwidth Messaging API + MCP vs Photon](https://www.anchorterminal.com/compare/bandwidth-vs-photon.md)
- [Bird API + MCP vs Photon](https://www.anchorterminal.com/compare/bird-vs-photon.md)
- [ClickSend SMS API + MCP vs Photon](https://www.anchorterminal.com/compare/clicksend-vs-photon.md)
- [Infobip API + MCP vs Photon](https://www.anchorterminal.com/compare/infobip-vs-photon.md)
- [Photon vs Plivo API](https://www.anchorterminal.com/compare/photon-vs-plivo.md)
- [Photon vs Sendblue](https://www.anchorterminal.com/compare/photon-vs-sendblue.md)
- [Photon vs Sinch Messaging APIs + MCP](https://www.anchorterminal.com/compare/photon-vs-sinch.md)
- [Photon vs Telnyx API + MCP](https://www.anchorterminal.com/compare/photon-vs-telnyx.md)
- [Photon vs Twilio API + MCP](https://www.anchorterminal.com/compare/photon-vs-twilio.md)
- [Photon vs Vonage Messages API + MCP](https://www.anchorterminal.com/compare/photon-vs-vonage.md)
- [360dialog WhatsApp API + MCP vs Telegram Bot API](https://www.anchorterminal.com/compare/360dialog-vs-telegram-bot.md)
- [AWS End User Messaging vs Telegram Bot API](https://www.anchorterminal.com/compare/aws-end-user-messaging-vs-telegram-bot.md)
- [Bandwidth Messaging API + MCP vs Telegram Bot API](https://www.anchorterminal.com/compare/bandwidth-vs-telegram-bot.md)
- [Bird API + MCP vs Telegram Bot API](https://www.anchorterminal.com/compare/bird-vs-telegram-bot.md)
- [ClickSend SMS API + MCP vs Telegram Bot API](https://www.anchorterminal.com/compare/clicksend-vs-telegram-bot.md)
- [Infobip API + MCP vs Telegram Bot API](https://www.anchorterminal.com/compare/infobip-vs-telegram-bot.md)
- [Plivo API vs Telegram Bot API](https://www.anchorterminal.com/compare/plivo-vs-telegram-bot.md)
- [Sendblue vs Telegram Bot API](https://www.anchorterminal.com/compare/sendblue-vs-telegram-bot.md)
- [Sinch Messaging APIs + MCP vs Telegram Bot API](https://www.anchorterminal.com/compare/sinch-vs-telegram-bot.md)
- [Telegram Bot API vs Telnyx API + MCP](https://www.anchorterminal.com/compare/telegram-bot-vs-telnyx.md)
- [Telegram Bot API vs Twilio API + MCP](https://www.anchorterminal.com/compare/telegram-bot-vs-twilio.md)
- [Telegram Bot API vs Vonage Messages API + MCP](https://www.anchorterminal.com/compare/telegram-bot-vs-vonage.md)
- [Telegram Bot API vs WhatsApp Business Platform (Cloud API)](https://www.anchorterminal.com/compare/telegram-bot-vs-whatsapp-cloud-api.md)
- [360dialog WhatsApp API + MCP vs Photon](https://www.anchorterminal.com/compare/360dialog-vs-photon.md)
- [Photon vs WhatsApp Business Platform (Cloud API)](https://www.anchorterminal.com/compare/photon-vs-whatsapp-cloud-api.md)

---

Query this catalogue directly over MCP: https://www.anchorterminal.com/mcp (Streamable HTTP, no key). How: https://www.anchorterminal.com/agents/#mcp