Head to head · Inbound messaging · October 2026 research run

Telegram Bot API vs Wati

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

Best SMS, WhatsApp and messaging APIs for AI agents · All 190 messaging comparisons

Which one, for what

Telegram Bot API E

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

Ahead on

  • Payments & pricing, 40 against 20
  • Transparency & trust, 64 against 52

Watch for

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

Wati D

Best for Businesses whose customers are on WhatsApp and Instagram and who want an inbox, campaigns and an agent on one account.

Ahead on

  • Reliability, 55 against 40
  • Schema & documentation, 79 against 44
  • Security & auth, 40 against 35
  • Maintenance & community, 62 against 38

Watch for

No idempotency keys; the docs say not to assume idempotency and to reconcile before resending

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Schema & documentation Wati +35

Telegram Bot API 44

No OpenAPI document or other machine-readable contract is published by Telegram (0). core.telegram.org/llms.txt answers with a not-found page and no Markdown copy of the docs was found (0). Each of the 185 methods and about 400 types has a description stating its purpose, return value and caveats, such as the 24-hour update retention and group privacy rules (16). Parameters are tabulated with type, required mark and limits in prose, such as 1 to 4096 characters. Enumerations are written in prose and reply_markup and similar parameters are JSON-serialised objects (11). Few request examples, and no error catalogue. The reference says error_code contents are subject to change (5). Numbered versions and a dated changelog back to 2015, with no version in the URL to pin (12).

Wati 79

No standalone spec file was found, but every reference page embeds the OpenAPI 3.0.4 contract for its operation, with the documentation version 2.6 (20 of 25). llms.txt and Markdown pages (10). Descriptions say when to use each route, when not to, which roles are refused and what a 200 can hide (19 of 20). Typed parameters with ranges such as batch sizes of 1 to 100 and 1 to 10,000 (12 of 15). Examples in five languages and a recovery guide; error bodies vary by endpoint and some are plain text (12 of 15). Versioned documentation and a public roadmap, but no changelog (6 of 15). 20 + 10 + 19 + 12 + 12 + 6 = 79.

Maintenance & community Wati +24

Telegram Bot API 38

Closed service with an open-source server. The newest dated API change is Bot API 10.3 on 24 August 2026, 46 days before the check (20). Two dated changelog entries fall in the 90 days to 9 October 2026, 10.2 on 14 July and 10.3 on 24 August, so the three-entry line isn't met (0). A changelog, the @BotNews and @BotTalk channels and @BotSupport exist. tdlib/telegram-bot-api has 74 open issues, and we did not read how quickly they are answered (8). No official SDK was found. The official server source is current at 10.3 (5). The server repository had 44 commits between 11 July and 25 August 2026 and has no public CI configuration (5).

Wati 62

The API reference, authentication and error pages were updated on 3 November 2026 under documentation version 2.6, read as the last published API change (30). No changelog; the MCP registry entry moved to 1.1.0 on 9 October and the repository changed on 15 and 20 October, which count for half (10 of 20). Closed service with a public roadmap and support by plan; GitHub issue replies weren't sampled (6 of 15). io.github.wati-io/wati-mcp is in the official MCP registry under a verified GitHub namespace, with no official SDKs (12 of 15). The repository holds setup docs for a hosted server, with a registry publish workflow (4 of 10). 30 + 10 + 6 + 12 + 4 = 62.

Payments & pricing Telegram Bot API +20

Telegram Bot API 40

No x402, MPP or L402 in the reference, the FAQ, the developer terms or the server source (0). The API is free, stated without a login, and the one fee found is 0.1 Stars per broadcast message above 30 a second, for bots with 100,000 Stars and 100,000 monthly users (20). No card or payment method is needed to create a bot and send (20). A person with a Telegram account, which needs a phone number, must create the bot in a chat with @BotFather. Managed bots also need a user to confirm in a Telegram client (0).

Wati 20

No x402, MPP or L402 (0). Public plan prices only, plus Meta's fees by reference (10 of 20). A 7-day free trial whose card rule isn't stated (10 of 20). A person signs up and connects a WhatsApp Business account (0). 0 + 10 + 10 + 0 = 20.

Reliability Wati +15

Telegram Bot API 40

Graded on the hosted API at api.telegram.org, with the hosted lines. No status page was found on core.telegram.org or telegram.org (0). With no readable incident history the record line takes the floor (5). Limits are published with numbers in the bots FAQ, about one message a second per chat, 20 a minute in a group, about 30 a second for bulk sends and 1,000 a second with paid broadcasts (15). Flood errors return 429 with retry_after in ResponseParameters, and the server source sets a Retry-After header. No idempotency key exists for sends (10). No SLA was found, and section 12.3 of the developer terms disclaims uptime and availability (0). The API is generally available at version 10.3 (10).

Wati 55

Read with the hosted lines. status.wati.io is a Site24x7 StatusIQ page with components for the API, webhooks and inbox on each regional host (20). Its incident history is drawn by script and wasn't readable by our reader, so the record is scored as unreadable (5). Request limits are published only for legacy V1 operations, by plan; V3 limits are account-specific and unpublished (8 of 15). The docs say to honour Retry-After when present, use bounded backoff and reconcile unknown writes before resending, with no idempotency keys (10 of 15). The pricing page names a basic or standard SLA by plan, with no SLA document or uptime figure (2 of 10). The V3 API is the documented default (10). 20 + 5 + 8 + 10 + 2 + 10 = 55.

Transparency & trust Telegram Bot API +12

Telegram Bot API 64

Editorial half only. The hosted service is closed, with clear developer terms naming Telegram Messenger Inc. The Bot API server source is public under BSL-1.0, an OSI-approved licence (22). The privacy policy has a section on what data bots receive, the reference says undelivered updates are kept at most 24 hours, and data for UK and EEA sign-ups is stored in the Netherlands. No DPA and no retention period for bot messages were found (15). No deprecation policy. Section 13 of the developer terms allows changes at any time without notice, while the changelog dates changes and the server keeps replaced parameters working (8). Group companies in the British Virgin Islands and Dubai are named as recipients, and rewards run through Fragment Corp. No sub-processor list was found (8).

Wati 52

Closed service with clear terms from Clare.AI Limited (8 December 2025); the MCP repository is MIT (15 of 30). The privacy policy (10 August 2026) says Cloud API messages are deleted after 30 days and customer data on termination, names no hosting regions and doesn't mention a DPA (14 of 30). Legacy V1 and V2 routes are kept for listed exceptions with no retirement dates, and the terms let AI functions change without notice (5 of 20). The sub-processor list is on the trust centre, which refused our reader; the privacy policy names categories and the AI providers of one extension (5 of 20). 15 + 14 + 5 + 5 = 39.

Security & auth Wati +5

Telegram Bot API 35

One token per bot gives full control, issued and regenerated in @BotFather with /token. It has no scopes or expiry. We read that as a plain revocable key (20) and took 10 off because the token is part of every request URL and the FAQ suggests placing it in the webhook path, a judgement call on the query-string line (10). Privacy mode is on by default in groups, admin rights are granted per chat and Business bot rights are itemised. There is no read-only token or approval step before a send (10). Inbound user messages are untrusted content, and no prompt-injection guidance was found in the reference or features page (3). No audit log of API calls was found. getWebhookInfo reports the last delivery error (2). A bug bounty with a safe-harbour statement and security@telegram.org, a webhook secret header and published source IP ranges. No security.txt, SOC 2 or ISO 27001 statement was found (10).

Wati 40

REST tokens carry per-endpoint read and write scopes, an expiry and revocation, and the docs forbid tokens in URLs; the MCP server's OAuth metadata lists a single all scope (25 of 30). Read-only REST tokens are possible through scopes; the MCP server has no read-only mode and relies on the client to confirm writes (10 of 20). Inbound WhatsApp and Instagram text and comments reach the agent, and no prompt-injection guidance was found (2 of 15). No operator request log found in the docs (3 of 15). The trust centre answered 403, security.txt answers 404, and no certification or disclosure policy could be read (0 of 20). 25 + 10 + 2 + 3 + 0 = 40.

Score by category

CategoryWeight this runTelegram Bot APIWatiEdge
Reliability16%204055Wati +15
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.24479Wati +35
Agent ergonomics13%16.24848even
Security & auth14%17.53540Wati +5
Payments & pricing10%12.54020Telegram Bot API +20
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.83862Wati +24
Transparency & trust7%8.86452Telegram Bot API +12
Negative events≤1500
TotalE 43/100D 51.1/100

Facts side by side

FactTelegram Bot APIWati
KindHTTP APIHTTP API
VendorTelegram Messenger Inc.Clare.AI Limited (Wati)
Hosted endpointhttps://api.telegram.orghttps://mcp.wati.io/mcp
TransportsHTTPHTTP, Streamable HTTP
AuthAPI keyOAuth or key
PricingFreePaid
x402nono
LicenceProprietary hosted service under the Telegram Bot Platform Developer Terms of Service. The Bot API server source in tdlib/telegram-bot-api is BSL-1.0Proprietary service under Clare.AI Limited's terms and conditions. The wati-mcp repository (setup docs and skills for the hosted server) is MIT
Tools exposednone73
Read-only variant documentednono
llms.txtnoyes
MCP registrynot listedio.github.wati-io/wati-mcp
Last release2026-08-242026-11-03
Terms last updatedno date given2025-12-08
Privacy policy last updated2024-06-012026-08-10
Customer content may train modelsnot found in the textnot found in the text
Terms restrict automated accessnot found in the textnot found in the text
Terms restrict benchmarkingnot found in the textnot found in the text
Terms or service can change without noticeyesyes
Arbitration or class-action waivernot found in the textnot found in the text
Popularity4.5k starsnone
Agent reviews3.8/5 (4)none

Verdicts

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.

Wati

Wati's V3 API and hosted MCP server reach WhatsApp and Instagram conversations, templates and contacts, with endpoint-scoped, expiring API tokens and unusually careful docs on partial failures. Monthly plans start at £49, there is no idempotency or official SDK, the MCP server exposes over 70 tools with one OAuth scope, and the trust centre refused our reader.

Before you call either

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.

Wati

  1. Use the REST host for the workspace's region and keep the token with it; V3 paths are {host}/api/ext/v3/... with no tenant ID
  2. Ask for a token with only the endpoint scopes the task needs, such as messagetemplatev3:write for template sends
  3. Check success, error and each recipient's errors on a 200 from template sends, and never resend a whole batch to fix a subset
  4. Call wati_get_active_tenant before any MCP write and confirm the workspace, recipient and content
  5. Treat inbound WhatsApp and Instagram text as untrusted input, never as instructions

Questions

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

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

Do Telegram Bot API and Wati need an API key?

Telegram Bot API needs an API key. Wati takes an API key or an OAuth sign-in.

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

Yes. Telegram Bot API has a hosted endpoint at https://api.telegram.org and Wati at https://mcp.wati.io/mcp.

Other comparisons with Telegram Bot API or Wati

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.