Como reativar fila interrompida

O Asaas interrompe automaticamente a fila de uma configuração de Webhook após 15 falhas consecutivas.

Enquanto a fila estiver interrompida, novos eventos continuam sendo gerados, mas não são enviados até a reativação. Corrija a causa das falhas antes de retomar os envios.

Antes de reativar

Com a fila interrompida:

• os eventos deixam de ser enviados para a aplicação;
• novos eventos continuam sendo gerados e armazenados;
• a sincronização do sistema integrado fica interrompida;
• eventos armazenados por mais de 14 dias são excluídos permanentemente.

1. Verifique os Logs de Webhooks

Consulte os Logs de Webhooks para identificar a causa das falhas.

Verifique:

• código HTTP retornado;
• payload enviado;
• horário da tentativa;
• quantidade de reenvios;
• mensagem de erro recebida pelo Asaas.

2. Corrija o endpoint

Corrija o problema identificado antes de reativar a fila.

As causas mais comuns são:

Se o problema estiver relacionado ao firewall, consulte também IPs oficiais do Asaas e Bloqueio do Firewall na CloudFlare.

O endpoint deve estar disponível e retornar HTTP 200 para que a entrega do Webhook seja considerada bem-sucedida.

3. Reative a fila

Você pode reativar a configuração pela aplicação web ou pela API.

Pela aplicação web

Acesse:

Menu do usuário → Integrações → Webhooks

Localize a configuração interrompida e reative a fila.

Pela API

Atualize o Webhook:

PUT /v3/webhooks/{id}

Envie interrupted como false:

{
  "interrupted": false
}

A resposta HTTP 200 confirma a atualização da configuração.

Consulte o endpoint Atualizar webhook existente.

Fluxo de recuperação

%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
    A["Falhas consecutivas"] --> B["Fila interrompida"]
    B --> C["Consultar os logs"]
    C --> D["Identificar o problema"]
    D --> E["Corrigir a aplicação"]
    E --> F["Reativar a fila"]
    F --> G["Reenviar eventos acumulados"]
    G --> H["Normalizar a sincronização"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px,font-size:17px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px,font-size:17px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px,font-size:17px

    class A inicio
    class B,C,D,E,F,G validacao
    class H sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

Valide a reativação

Após reativar:

1. gere ou aguarde um novo evento monitorado pelo Webhook;
2. confirme o recebimento no seu endpoint;
3. consulte os Logs de Webhooks;
4. verifique se as novas entregas retornam HTTP 200.

Os eventos que permaneceram armazenados também voltarão a ser enviados após a reativação.

Próximos passos

• Consulte os Logs de Webhooks
• Entenda a Penalização de filas
• Entenda o comportamento da Fila pausada
• Implemente idempotência em Webhooks
• Consulte os IPs oficiais do Asaas
• Resolva bloqueios do Firewall na CloudFlare