14 May 2026

Corrigir erros de limite de taxa (Rate Limit)

Artigo histórico da Make (a fonte indica 14 de maio de 2026). Este texto reproduz uma página de documentação da Make. As descrições de recursos, limites e capturas de tela são da Make nessa data; não são uma afirmação deste site nem garantia de que essa documentação continue igual hoje. Para o estado atual da plataforma, consulte as fontes oficiais da Make.

Na Make, você verá o RateLimitError quando as requisições a um app excederem seu limite de taxa de API — o número máximo de requisições permitidas dentro de um determinado período (por exemplo, 100 requisições por minuto). Quando o limite de taxa é excedido, o app bloqueia novas requisições até que o período especificado passe. Para um exemplo, veja os limites de taxa de API do Google Sheets. O erro de limite de taxa é comum em cenários com instant triggers (por exemplo, webhooks), apps que processam muitos registros em pouco tempo (por exemplo, Google Sheets ou Airtable) e apps que você usa várias vezes em diferentes cenários. Este artigo apresenta estratégias para prevenir erros de limite de taxa em cenários instantâneos, em cenários agendados e nos dois tipos. O erro de limite de taxa na Make corresponde ao código de erro HTTP 429 Too Many Requests. Embora a Make siga os códigos de erro padrão e suas definições, apps de terceiros nem sempre obedecem a esse padrão.

Estratégias por tipo de agendamento

Quando um módulo retorna o erro de limite de taxa e não há nenhum error handler presente, a Make responde com base nos seguintes fatores:

O tipo de agendamento do cenário
Se as incomplete executions estão habilitadas O quadro abaixo resume todas as respostas possíveis ao encontrar um erro de limite de taxa: | Tipo de agendamento | Incomplete executions desabilitadas | Incomplete executions habilitadas | | --- | --- | --- | | Agendado |
A Make pausa a próxima execução do cenário por 20 minutos.
A Make não executa o cenário novamente. |
A Make pausa a próxima execução do cenário por 20 minutos.
A Make reexecuta a execução incompleta com exponential backoff. | | Instantâneo | A Make reexecuta a execução incompleta desde o início com exponential backoff. | A Make reexecuta a execução incompleta com exponential backoff. | As estratégias para evitar erros de limite de taxa dependem de o cenário receber dados instantaneamente, com instant triggers, ou de forma agendada.

Cenários instantâneos

Em cenários acionados instantaneamente, defina um limite de taxa do cenário para controlar quantas vezes um cenário roda por minuto. Essa estratégia distribui picos repentinos de requisições ao longo de períodos maiores, permitindo que as requisições enfileiradas sejam processadas em um ritmo gerenciável. Você pode configurar um limite de taxa do cenário no campo Maximum runs to start per minute. Encontre essa configuração clicando no ícone de raio no módulo do instant trigger ou em Schedule setting na barra de ferramentas do cenário. Document image Você também pode habilitar o processamento sequencial ou usar módulos sleep. No entanto, essas estratégias têm limitações e são úteis em casos selecionados. Veja Estratégias avançadas para saber mais.

Cenários agendados

Em cenários agendados (por exemplo, com polling triggers), você pode tentar estas estratégias, dependendo do seu caso de uso: Definir intervalos de agendamento mais longos Quando você espera muitos registros de dados em uma única execução, aumente o tempo entre as execuções do cenário para distribuir os registros recebidos ao longo de um período maior. Por exemplo, agende seu cenário para rodar a cada 5 minutos e processar 100 linhas por execução. Você pode configurar os intervalos de agendamento em Schedule settings na barra de ferramentas do cenário. Definir um número baixo de registros a processar por execução Se você precisa de execuções frequentes do cenário, como uma execução por minuto, diminua o número de registros processados por execução. Recomenda-se um limite de até 20 registros por execução para evitar exceder os limites de taxa. Por exemplo, agende seu cenário para rodar a cada minuto e processar 20 linhas por execução. Você pode configurar um limite de registros por execução nas configurações de um módulo, no campo Limit.

Os dois tipos

Independentemente do tipo de agendamento do cenário, você pode fazer o seguinte para reduzir requisições e prevenir erros de limite de taxa:

Use módulos de ação em massa, como Google Sheets > Bulk Add Rows e Bulk Update Rows, para processar vários bundles em uma única requisição. Por exemplo, fazer uma requisição ao Google Sheets para adicionar 20 linhas a uma planilha, em vez de 20 requisições — uma por linha.
Use módulosaggregator para mesclar vários bundles em um único bundle.
Adicione um pequeno atraso inserindo um módulo Sleep antes de um módulo que causa erros, se os erros de limite de taxa continuarem. Para mais estratégias, continue na próxima seção.

Estratégias avançadas

Esta seção inclui mais estratégias para erros de limite de taxa, para quando as mencionadas forem menos eficazes ou menos relevantes ao seu caso de uso.

Processamento sequencial

Quando você habilita o processamento sequencial, o módulo trigger processa os dados recebidos um a um, na ordem em que chegam, em vez de em paralelo. A Make espera a execução de um cenário terminar antes de iniciar a próxima. Você pode habilitar o processamento sequencial em Scenario settings no Scenario Builder. Document image Limitações O processamento sequencial interrompe o cenário em caso de erros, mesmo com as incomplete executions desabilitadas. Se um cenário tem execuções incompletas e processamento sequencial habilitado, o cenário fica em pausa até que as execuções incompletas sejam processadas, para manter a ordem dos dados recebidos.

Módulo Sleep

O módulo Sleep atrasa as requisições a um app em até 300 segundos, ou 5 minutos. Defina o atraso de acordo com o número de requisições permitidas no limite de taxa. Por exemplo, se o app é limitado a 10 requisições por minuto, defina o atraso para 6 segundos. Você pode adicionar um módulo Sleep antes do módulo que recebe as requisições atrasadas. Document image Use módulos sleep para tratar erros de limite de taxa nestes casos:

Em cenários instantâneos com vários módulos do mesmo app
Em cenários com módulos que rodam várias vezes para processar muitos bundles (por exemplo, 10) Limitações Além de tornar a execução mais lenta, os módulos Sleep muitas vezes adiam os problemas que causam erros de limite de taxa em vez de resolvê-los. Por exemplo, quando requisições que ocorrem em rápida sucessão chegam ao módulo Sleep, o módulo apenas adia essas requisições problemáticas por alguns segundos.

Incomplete executions

Quando você habilita as incomplete executions, pode tratar erros depois e manter os cenários rodando. Se um erro de limite de taxa ocorrer com as execuções incompletas habilitadas, a Make reexecuta automaticamente a execução incompleta em intervalos gradualmente maiores. Na maioria dos casos, essa reexecução automática resolve o problema e a execução do cenário continua normalmente. Você só precisará resolver erros manualmente em caso de erros lógicos (por exemplo, mapeamento incorreto, condições de filtro etc.). Para habilitar as execuções incompletas, selecione Yes no campo Store incomplete executions em Scenario settings. Um app conta o número de requisições no seu limite de taxa somando todos os cenários que usam o app. Se o seu cenário inclui um módulo que consome muitas operações, ou se você usa o mesmo módulo com frequência nos seus cenários, considere verificar o limite de taxa de API do app ou usar as estratégias de tratamento de erros deste artigo para evitar preventivamente execuções frequentes do cenário.