Limits and errors

How much an agent may do, and what every error means.

LimitValue
API calls1,000 a minute per agent
Messages30 a minute in one chat
Members syncs12 an hour per group, up to 2,000 numbers each
Removals50 a day per group (a confirmed list may go past it)
Groups1,024 members; 5 agents
Agents10 per developer
Uploadsphotos 10 MB and 40 megapixels, voice notes 16 MB, videos and files 28 MB, stickers 64 KB after fitting
Events64 KB each, 10 seconds to answer, retried for 24 hours

Errors

StatusCodeMeaning
401unauthorizedMissing or wrong API key.
403agent_pausedThe agent is paused.
403needs_approvalAnother company's agent HUMAIN has not approved yet: it works only with its developers.
403outside_windowMore than 24 hours since the person's last message.
403blocked, admins_onlyBlocked; announcement mode.
404not_found, no_messageNot in that chat; no such message.
409confirm_needed, busy, agent_not_admin, too_lateSee the message.
409recipient_needs_updateThe person's app can't read an agent's message yet.
413too_largeThe upload is too large.
429rate_limitedSlow down.
503unavailableTry again in a moment.