Um 429 indica que houve solicitações demais em determinado intervalo, mas não identifica sozinho quem impôs o limite nem se alguma etapa anterior já gravou dados. Repetir todas as execuções pode criar pedidos, mensagens ou contatos duplicados. A primeira decisão é conter a taxa; a segunda é verificar o efeito de cada tentativa antes de reprocessar.
Resposta curta
Abra uma execução autorizada e registre serviço, etapa, horário, código e mensagem de erro, sem copiar dados pessoais ou credenciais. Determine se o limite veio da plataforma de automação ou da API do aplicativo de destino. Se a resposta trouxer Retry-After, use-o como orientação do servidor; o cabeçalho é opcional, portanto sua ausência não autoriza tentar imediatamente. Reduza a frequência ou distribua chamadas conforme a documentação do serviço. Para operações de escrita, confira pelo ID de negócio se o efeito já ocorreu antes de qualquer replay.
Matriz de decisão do 429
| Evidência | Leitura prudente | Ação antes da próxima tentativa |
|---|---|---|
| Mensagem identifica a plataforma | O bloqueio pode estar na camada de automação | Examine histórico e limites da plataforma; reduza rajadas |
| Mensagem identifica o aplicativo ou a API | O destino pode impor limite compartilhado com outros fluxos | Confira documentação e consumo agregado da conta |
Retry-After presente |
O servidor indicou um período de espera | Respeite a indicação e limite novas tentativas |
Retry-After ausente |
O protocolo não exige o cabeçalho | Consulte política do serviço; use espera controlada, não loop rápido |
| A etapa é leitura | Não houve escrita por essa solicitação, mas etapas anteriores ainda importam | Repetir somente após revisar dependências e limites |
| A etapa é escrita ou tem efeito externo | O estado final pode ser incerto | Verifique registro, mensagem ou cobrança pelo ID antes de repetir |
Essa matriz é uma síntese da Pulse. A Zapier distingue limites próprios e dos aplicativos; a Make explica que o tratamento do limite depende do tipo de agendamento e da configuração de execuções incompletas. Não aplique o comportamento padrão de uma ferramenta a outra. O RFC 6585 define o significado do 429 e permite, mas não exige, Retry-After.
Sequência de recuperação sem replay cego
- Conter: pause a etapa de escrita se há risco de efeito duplicado; se possível, mantenha a coleta de novos itens em fila controlada. Não aumente a frequência para “destravar”.
- Localizar: compare a mensagem do erro, a etapa afetada e os limites publicados pelo fornecedor correto. Outros fluxos podem usar a mesma conta ou API.
- Espaçar: ajuste disparos, lote ou fila para respeitar o limite confirmado. Escolha a espera segundo o serviço; não invente um número universal de segundos nem contrate plano maior como primeira resposta.
- Reconciliar: para cada ID de negócio no período afetado, compare origem e destino. Classifique como
não criado,criado uma vez,duplicadoouincerto. - Reprocessar seletivamente: só repita itens comprovadamente não aplicados, com mecanismo de deduplicação adequado à operação. Se o estado for incerto, encaminhe à revisão humana antes de escrever novamente.
Exemplo fictício: uma rotina envia propostas ao CRM e recebe 429 em parte das gravações. Não se pode inferir que todas falharam. Se uma proposta já tem registro no CRM, reexecutar a escrita pode criar outro. O responsável confere IDs, separa itens confirmados dos ausentes e só então decide uma fila de reprocesso. Este é um modelo de decisão, não teste realizado pela Pulse.
Quando parar
Pare a automação afetada e peça revisão técnica se o serviço não informa o estado final de uma cobrança, envio ou alteração irreversível; se o erro persiste mesmo após reduzir a taxa; ou se os limites publicados não explicam o bloqueio. Não exponha cargas completas, tokens ou dados de clientes em tickets públicos. Um 429 recorrente também pode sinalizar desenho excessivamente fragmentado do processo, mas isso é hipótese a investigar, não diagnóstico automático.
Para proteger um fluxo que já afetou a operação, use o plano de contingência. Para o risco específico de repetir uma ação após falha, veja como evitar ações duplicadas por webhook. Este guia se concentra na escolha entre esperar, reduzir chamadas e reprocessar diante de 429.
Fontes e limites
As regras de cada produto podem mudar. Consulte os limites da Zapier, o tratamento de rate limit da Make e o status 429 no RFC 6585. Não há garantia universal de entrega, replay seguro ou cabeçalho de espera. A matriz e o exemplo são editoriais.