Erro 131056 do WhatsApp: mensagens demais para um destinatário
O erro 131056 significa que muitas mensagens foram enviadas entre seu número de negócio e um único destinatário numa janela curta. É um limite de taxa por par, separado do throughput geral da conta, e quase sempre significa que uma automação está se repetindo.
Código da Meta para mensagens demais entre um par em pouco tempo.
O código relacionado para o limite de taxa geral da conta.
O código para um serviço temporariamente indisponível.
Por que o limite é por par
Porque a falha da qual ele protege não é volume em geral, é uma pessoa sendo inundada. Uma conta pode estar folgada no throughput geral enviando trinta mensagens para um destinatário em um minuto, e quem está do outro lado vive isso como spam independente do total da conta.
O limite se aplica então ao par e não à conta, e é por isso que ele aparece num número de baixo volume que nunca chegou perto do limite geral.
O que costuma causar
Quase sempre algo automático, não alguém digitando.
- Um laço de repetição que trata falha de entrega como falha de envio e manda de novo.
- Um handler de webhook que responde e é invocado mais de uma vez para o mesmo evento.
- Um chatbot quebrando uma resposta em várias mensagens curtas em sequência.
- Um script de teste enviando para o mesmo número repetidamente durante o desenvolvimento.
Como evitar
Limitando no nível da conversa, não só no da conta. Um teto de mensagens por destinatário por minuto, aplicado antes do envio, custa quase nada e evita tanto este erro quanto a experiência de cliente por trás dele.
Deduplicar mensagem importa igual. Eventos de webhook podem ser entregues mais de uma vez, e um handler que responde sem checar se já tratou aquele message id vai produzir exatamente esse padrão sob carga.
Erros comuns
- Repetir, o que manda mais uma mensagem para o destinatário que já está sendo inundado.
- Limitar só no nível da conta. Este limite é por destinatário.
- Tratar eventos de webhook sem deduplicar por message id.
A EasyCoexistence entrega cada evento de mensagem no seu endpoint com o message id intacto, então a deduplicação acontece sobre o dado que a Meta enviou, e não sobre uma cópia que a gente remodelou.
Perguntas frequentes
Isso é o limite de taxa da minha conta?
Não. Aquele é o 130429. Este é por destinatário.
Por que num número de baixo volume?
Porque o limite vale para o par, não para o total da conta.
Como faço parar?
Limite por conversa e deduplique eventos de webhook por message id.
Devo repetir?
Não. Repetir manda mais uma mensagem para o mesmo destinatário.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em