Skip to content

The plan limits have been exceeded#

The quotaExceeded incoming notification contains data about exceeding the chat limits on the Telegram Developer plan

Notification#

Notification format#

Parameter Type Description
typeWebhook string Incoming notification type. For notifications of this type the field takes the value quotaExceeded
instanceData object Data about the instance
timestamp integer Time the event occurred in UNIX format
quotaData object Data about exceeding the limits

Fields of the instanceData object

Parameter Type Description
idInstance integer Instance identifier. A uint64 value, 10 digits
wid string Account identifier
typeInstance string Messenger type for the instance
- telegram for Telegram
- whatsapp - for WhatsApp
- v3 - for MAX

Fields of the quotaData object

Parameter Type Description
method string Name of the method or limit. By default takes the value correspondents
used string Number of chats used during the month
total string Total number of chats that can be used per month. By default takes the value 3
status string Limit status
description string Description of the limit being exceeded

Notification body example#

{
    "typeWebhook": "quotaExceeded",
    "instanceData": {
        "idInstance": 4100000000,
        "wid": "79876543210@c.us",
        "typeInstance": "telegram"
    },
    "quotaData": {
        "method": "correspondents",
        "used": 3,
        "total": 3,
        "status": "CORRESPONDENTS_QUOTA_EXCEEDED",
        "description": "Monthly quota has been exceeded. You can only send or receive messages from following chats: 10000000, 10000001, 10000002. Please go to your personal account and change the tariff to business https://console.green-api.com"
    }
}