workflows

Erro 429 na automação: quando esperar, reduzir chamadas ou reprocessar

Um roteiro para identificar quem limitou as chamadas, conter novas tentativas e verificar efeitos antes de repetir uma escrita.

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

  1. 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”.
  2. 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.
  3. 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.
  4. Reconciliar: para cada ID de negócio no período afetado, compare origem e destino. Classifique como não criado, criado uma vez, duplicado ou incerto.
  5. 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.

Fontes