Skip to content

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 Developer plan.

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.us format (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