Passar para o conteúdo principal

⚡ Processamento em Fila de Requisições para Webhooks

Otimize o disparo de suas campanhas em massa por meio do novo sistema de fila de requisições em Webhooks. Garanta a tentativa de envio em 100% de seus registros sem exceder os limites da API do Meta. 🚀

📋 Em que consiste esta atualização?

Quando você executa envios em massa através de Webhooks com um alto volume de contatos, o Atom processa e inicializa as solicitações adicionando-as dinamicamente a uma fila de processamento. Esta melhoria arquitetônica protege sua operação ao evitar saturações de rede e garantir que a plataforma tente processar 100% das solicitações.

Aspecto

Comportamento

Garantia do sistema

Garante que o Atom tente enviar o template em 100% das execuções recebidas sem ultrapassar a taxa de solicitações da API do Meta.

Filtros externos

A entrega final no dispositivo do cliente continuará dependendo da qualidade do template e dos algoritmos de entrega do Meta (como MM Lite).

Retrocompatibilidade

A atualização é 100% transparente. Você não precisa recriar nem modificar seus Webhooks configurados no Atom.


🛠️ Mudança no Código de Resposta HTTP (Status 202)

Para confirmar o recebimento imediato em campanhas de larga escala, o motor do Atom responde com um código de status HTTP 202 (Aceito) assim que valida que a solicitação não contém erros de parâmetros.

Este código significa que o Atom recebeu e aceitou a solicitação corretamente e a enfileirou para execução posterior na vez correspondente.

⚠️ Importante: Se seu CRM ou sistema externo avalia estritamente o código de resposta do servidor ao disparar para o Atom, você deve atualizar a regra de validação do seu sistema para aceitar o código 202 (em vez do código 200 anterior).


🔍 Matriz de Códigos de Resposta HTTP

Use a seguinte referência técnica para auditar as respostas enviadas pelo Atom ao executar ou enfileirar um Webhook:

Código HTTP

Condição do Sistema

Mensagem de Erro / Status

Detalhe Operacional

202

Webhook enfileirado com sucesso

Webhook task has been queued for processing

✅ Sucesso: A solicitação foi aceita e adicionada à fila.

200

Execução imediata bem-sucedida

Webhook ejecutado satisfactoriamente

✅ Sucesso: Solicitação processada diretamente.

400

Identificador inválido ou vazio

Invalid Webhook ID

O webhookId não pode ser processado.

400

Parâmetros ausentes

Missing params: {lista}

Faltam variáveis obrigatórias definidas no body.

400

Dados de contato ausentes

Missing phone number / Invalid phone number

O telefone não está presente ou seu formato não é válido.

401

Token ausente ou formato inválido

Authorization header required

Falta o token de autorização ou o formato não é UUID.

403

Estado inativo ou bloqueio

Webhook is not active / Disabled due to failed attempts

Desabilitado por configuração ou superou 1.000 tentativas falhadas.

404

Registro não encontrado

Webhook not found / Company not found

O ID do Webhook ou da empresa não existe no Atom.

500

Erro interno do servidor

Internal server error / Failed to create queue task

Ocorreu uma exceção ao processar a fila.

💡 Dica: Revise a integração de seus sistemas externos para garantir que registrem o código 202 como um disparo bem-sucedido. Isso evitará novas tentativas desnecessárias ou falsos positivos nos logs do seu CRM.


Com a implementação da fila de processamento em Webhooks, suas campanhas em massa ganham estabilidade e confiabilidade absoluta. Ao manter sua taxa de solicitações em faixas ótimas para o Meta, você garante uma operação fluida e preparada para escalar no ritmo do seu negócio. ✅

Respondeu à sua pergunta?