Pular para o conteúdo

Limites

Os limites são os mesmos para todo mundo e não têm cobrança.

O quê Limite
Webhooks por comunidade (não apagados) 10
Envios por webhook 5 a cada 2 segundos e 30 por minuto
Envios por canal (todos os webhooks somados) 60 por minuto
Corpo do pedido 16 KB

Passou da taxa? A resposta é 429 com rate_limited. O corpo traz retry_after, em segundos e com decimais, e o cabeçalho Retry-After traz o mesmo valor arredondado para cima. Espere esse tempo e mande de novo.

PATCH e DELETE de mensagens também gastam da taxa.

O quê Limite Se passar
text 2.000 caracteres Recusa (payload_invalid)
Corpo do pedido 16 KB Recusa (payload_too_large)
key 128 caracteres ASCII visíveis, sem espaço Recusa (payload_invalid)
card.title 256 caracteres Corta com “…”
card.body 1.000 caracteres Corta com “…”
card.fields 6 campos Ignora os que passam
Nome do campo 64 caracteres Corta com “…”
Valor do campo 256 caracteres Corta com “…”
card.url 512 caracteres, http:// ou https:// Descarta o link
username 32 caracteres Corta com “…”

Em qualquer formato, o texto do cartão que passa do limite é cortado. Só o text da mensagem é recusado quando passa de 2.000 caracteres, porque cortar mudaria o que você escreveu.

O texto achatado que o app antigo e a busca leem (título, corpo, campos e link do cartão) cabe em 2.000 caracteres e é cortado com “…”.

O app guarda as 20 últimas entregas de cada webhook, por até 7 dias, com os primeiros 4 KB do corpo que chegou. Você as vê no detalhe do webhook, em Últimas entregas.