Telegram messenger API cost#
GREEN-API provides different plans for working with the features of the service:
✔ Designed for full-scale work with a large number of individual clients and group chats.
✔ Unlimited number of chats for exchanging messages
✔ Unlimited number of messages
✔ Receives notifications from all chats on the account
! The only limitation is 30,000 checks using the CheckAccount method
In the console you can create any number of instances on the Telegram Business plan, payment is made for each instance separately.
✔ Allows you to send and receive messages
✔ Allows you to check whether a client's number is registered in the Telegram messenger
✔ Allows you to receive notifications about account events via HTTP API or Webhook
... and many other features!
! Message exchange is possible only with 3 chats (contacts or groups)
! Receiving notifications is possible only from 3 chats (contacts or groups)
! If the limit is exceeded, error 466 will be received
In the console you can create only 1 instance on the
Telegram Developerplan.
Attention!
Plans apply not to the entire console, but to each instance separately.
Thus, to create 3 instances on the Telegram Business plan, you need to pay for 3 separate Telegram Business plans, one for each instance.
How the recipient identifier format is counted in the chat quota
On the Telegram Developer plan there is a limit on the number of chats (correspondents). The remaining quota check does not synchronize different identification formats of the same recipient — each format is counted as a separate chat:
- a phone number in the
phoneNumber@c.usformat (for example,79770996235@c.us); - a chat identifier
chatId(for example,10000000).
Therefore, sending to the same contact sometimes by phone number and sometimes by chatId consumes two quota units, and when the limit is exhausted, error 466 will be received — even though it is in fact the same chat.
To use the plan quota optimally, stick to a single format of sending for each recipient. It is recommended to use chatId, having obtained it beforehand using the CheckAccount method.
More about the plans, their capabilities and limitations:
Methods and limits#
Updating the limits
The limits are updated every month on the 1st.
These tables describe the methods and notifications that have limits. If a method is not in the table, it has no limit.
| Method | "Developer" plan Number of requests per month | "Business" plan Number of requests per month |
|---|---|---|
| Account | ||
| QR | Unlimited | Unlimited |
| SendAuthorizationPassword | Unlimited | Unlimited |
| StartAuthorization | Unlimited | Unlimited |
| SendAuthorizationCode | Unlimited | Unlimited |
| GetStateInstance | Unlimited | Unlimited |
| Reboot | Unlimited | Unlimited |
| Logout | Unlimited | Unlimited |
| GetSettings | Unlimited | Unlimited |
| SetSettings | Unlimited | Unlimited |
| GetAccountSettings | Unlimited | Unlimited |
| SetProfilePicture | 1000 | Unlimited |
| Sending | ||
| SendMessage | Unlimited | Unlimited |
| SendFileByUpload | Unlimited | Unlimited |
| SendFileByUrl | Unlimited | Unlimited |
| SendLocation | Unlimited | Unlimited |
| SendContact | Unlimited | Unlimited |
| SendPoll | Unlimited | Unlimited |
| Receiving | ||
| DownloadFile | 500 | Unlimited |
| ReceiveNotification | Unlimited | Unlimited |
| DeleteNotification | Unlimited | Unlimited |
| Journals | ||
| GetChatHistory | Unlimited | Unlimited |
| GetMessage | Unlimited | Unlimited |
| LastIncomingMessages | Unlimited | Unlimited |
| LastOutgoingMessages | Unlimited | Unlimited |
| Queues | ||
| GetMessagesCount | Unlimited | Unlimited |
| ShowMessagesQueue | Unlimited | Unlimited |
| ClearMessagesQueue | Unlimited | Unlimited |
| GetWebhooksCount | Unlimited | Unlimited |
| ClearWebhooksQueue | Unlimited | Unlimited |
| Groups | ||
| CreateGroup | 1000 | Unlimited |
| UpdateGroupName | 1000 | Unlimited |
| UpdateGroupSettings | 1000 | Unlimited |
| GetGroupData | 1000 | Unlimited |
| AddGroupParticipant | 1000 | Unlimited |
| RemoveGroupParticipant | 1000 | Unlimited |
| SetGroupAdmin | 1000 | Unlimited |
| RemoveAdmin | 1000 | Unlimited |
| LeaveGroup | 500 | Unlimited |
| SetGroupPicture | 100 | Unlimited |
| Read mark | ||
| ReadChat | 100 | 30 000 |
| Service methods | ||
| CheckAccount | 100 | 30 000 |
| GetAvatar | 100 | Unlimited |
| GetChats | Unlimited | Unlimited |
| GetContacts | Unlimited | Unlimited |
| EditMessage | 100 | Unlimited |
| DeleteMessage | 100 | Unlimited |
| SendTyping | Unlimited | Unlimited |
| GetContactInfo | 100 | Unlimited |
| ArchiveChat | 100 | Unlimited |
| UnarchiveChat | 100 | Unlimited |
Notifications and limits#
Updating the limits
The limits are updated every month on the 1st.
These tables describe the methods and notifications that have limits. If a method is not in the table, it has no limit.
| Notifications | "Telegram Developer" plan. Number of requests per month | "Telegram Business". Number of requests per month |
|---|---|---|
| incomingMessageReceived | Unlimited | Unlimited |
| outgoingMessageReceived | Unlimited | Unlimited |
| outgoingAPIMessageReceived | Unlimited | Unlimited |
| stateInstanceChanged | Unlimited | Unlimited |
| quotaExceeded | Unlimited | Unlimited |
| outgoingMessageStatus | Unlimited | Unlimited |
| statusInstanceChanged | Unlimited | Unlimited |