← Voltar ao Blog
novidades sandbox pool-numbers webhooks byon

Novidades do PipesBot: Limite Diário de Envios nos Números Pool, Aba de Webhooks e Retenção de 7 Dias

Read in English →

Resumo: cada número sandbox (Pool) que você ativa agora pode enviar 5 mensagens por dia (UTC). O recebimento continua ilimitado, o limite é o mesmo em todos os planos e números BYON não têm limite diário. Quando você atinge o limite, a API responde 429 DAILY_LIMIT_REACHED com o horário em que ele zera. Nesta semana também lançamos uma aba de Webhooks em cada App, com log de entregas e reenvio manual, e agora apagamos os payloads de webhook armazenados após 7 dias.

Números Pool: 5 envios por dia

Por quê

Quando lançamos os números sandbox (Pool), deixamos tudo aberto de propósito, para qualquer pessoa plugar um agente e ver o WhatsApp funcionando em minutos. Vocês usaram muito mais do que imaginávamos.

Aí, em 1º de outubro, a Meta passou a cobrar pelas service messages: toda resposta enviada dentro da janela de 24 horas. Os números sandbox são do PipesBot, então cada uma dessas respostas cai na nossa conta, e no volume que o sandbox atingiu não dá para mantê-lo ilimitado. O sandbox volta ao que ele foi feito para ser: testar o PipesBot, experimentar e uso pessoal leve.

O limite, exatamente

  • 5 envios por dia UTC, por número Pool ativado. A contagem zera às 00:00 UTC (21:00 no horário de Brasília).
  • Igual em todos os planos. Fazer upgrade não aumenta o limite.
  • Recebimento ilimitado. As mensagens recebidas continuam chegando ao seu agente como antes.
  • Só contam envios que a Meta aceita. Uma requisição recusada antes de chegar à Meta (validação, janela de 24 horas, erro de template, limite de 60 por minuto) não consome sua cota. Se a Meta falhar o envio, a vaga é devolvida.
  • Mensagens do sistema não contam para você. A mensagem de boas-vindas para contatos desconhecidos sai no máximo uma vez por remetente, por número, a cada 24 horas, e o aviso de “agente offline” agora sai uma vez por dia por número, em vez de a cada hora.
  • Números BYON não são afetados. O PipesBot não impõe limite diário a eles.

O limite vale para todas as formas de enviar por um número Pool: POST /v1/messages/send (texto e mídia), POST /v1/messages/passthrough com chave pk_ e respostas por WebSocket (whatsapp_reply), que é como os plugins de agente respondem.

O que seu código recebe

Envios pelo sandbox agora trazem os headers X-Daily-Limit, X-Daily-Remaining e X-Daily-Reset para você acompanhar a cota: X-Daily-Limit é sempre 5 e X-Daily-Remaining mostra quantos envios aquele número ainda tem hoje.

O sexto envio do dia retorna 429 com o código DAILY_LIMIT_REACHED e um header Retry-After com os segundos que faltam até 00:00 UTC. Pelo WebSocket, o evento reply_status volta com success: false e code: "DAILY_LIMIT_REACHED".

Se o seu agente responde por um número Pool, trate esse código como você trata rate limit: pare de enviar, avise o usuário se fizer sentido e tente de novo depois do Retry-After. Não fique tentando em loop, porque toda tentativa vai receber a mesma resposta até o reset.

Como passar do limite

Se o seu agente ficou grande demais para o sandbox, conecte seu próprio número com BYON. Sua WhatsApp Business Account paga a Meta diretamente, e o PipesBot não impõe limite diário. Leva uns cinco minutos com o Embedded Signup, e o registro agora é automático. Se estiver em dúvida sobre qual escolher, o comparativo Pool vs BYON explica os prós e contras.

Os detalhes estão na documentação do sandbox.

Uma aba de Webhooks em cada App

Cada App agora tem uma aba Webhooks que lista as entregas dos últimos 7 dias para o seu endpoint:

  • filtros All / Failed / Delivered e por tipo de evento (messages, campos v2, number.onboarded, template_status_update, test);
  • uma visão de detalhe com status code, duração e tentativas, e o payload nas falhas;
  • Retry para uma entrega ou Retry all failed, que reenvia as falhas da mais antiga para a mais nova para a sua URL de webhook atual.

Uma entrega é registrada como falha depois de 3 tentativas. Se o seu endpoint ficou fora do ar por uma hora, você corrige e reenvia o que perdeu, em vez de perder esses eventos. As atualizações de status de template, que antes eram descartadas após 3 falhas, agora seguem o mesmo caminho e também podem ser reenviadas.

Payloads de webhook apagados após 7 dias

Quando uma entrega falha, guardamos o payload para você poder reenviar. Esse payload pode conter conteúdo de mensagens dos usuários finais, então agora ele tem um prazo de retenção: toda entrega armazenada é removida do nosso banco de dados ativo quando completa 7 dias, seja qual for o status, por uma rotina de limpeza recorrente, e o payload é removido assim que um reenvio dá certo. As cópias nos backups do banco são sobrescritas no ciclo normal de backups. Entregas bem-sucedidas são registradas sem o payload.

Na mesma linha, ajustamos os logs do servidor para que erros de banco de dados sejam registrados só pelo nome e código. As mensagens desses erros podem repetir os valores de uma query, e não queremos nada disso em log.

Visual novo no dashboard

O app em app.pipes.bot agora usa o design do PipesBot: tipografia e cores novas, modo escuro que segue o sistema operacional (com botão na barra superior), menu para celular e e-mails renovados. Também tiramos do cabeçalho do dashboard a busca e o sino de notificações, que ainda não faziam nada.

Experimente

Tudo isso já está no ar. Abra o dashboard para ver a aba de Webhooks do seu App e, se o seu agente precisa de mais de 5 envios por dia, conecte seu próprio número com BYON.