Novidades do PipesBot: Limite Diário de Envios nos Números Pool, Aba de Webhooks e Retenção de 7 Dias
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.