Todo número de WhatsApp no Omni Octo tem um limite de envio, e toda forma de enviar a partir desse número o obedece: a caixa de entrada, a API, o Octo, os fluxos de trabalho, as pesquisas e as campanhas. Esta página explica o que é esse limite, quem o define e o que acontece quando um envio esbarra nele.
A Lavanderia Tidewater é o exemplo de novo. Ela tem um número de WhatsApp. Numa segunda-feira de manhã, roda uma campanha lembrando 1.800 clientes de que as coletas voltam depois do feriado, enquanto duas pessoas na caixa de entrada respondem perguntas sobre edredons. As duas coisas continuam funcionando, e o motivo é a divisão descrita abaixo.
Os valores padrão
Um número que ninguém configurou envia nestes ritmos:
| Janela | Padrão | Conta |
|---|---|---|
| Por segundo | 5 | Todas as mensagens |
| Por minuto | 250 | Todas as mensagens |
| Por dia | 2.000 | Só modelos |
Na página do canal isso aparece como Em vigor: 5/segundo + 250/minuto + 2000/dia · padrão da plataforma. Uma regra da plataforma para o seu número também pode acrescentar um limite por hora; ele funciona como o por minuto.
Os limites por segundo e por minuto são o nosso ritmo, aplicado a tudo o que o número envia. O limite diário conta só modelos, e existe para acompanhar o nível de mensagens da Meta (próxima seção). Uma resposta em texto livre dentro da janela de 24 horas nunca conta, então um número que já usou os modelos do dia ainda pode responder a quem escreve para ele.
O limite diário e os níveis de mensagens da Meta
A Meta limita com quantas pessoas um número pode iniciar conversas em 24 horas, e o limite depende do nível de mensagens do número. O nível que a Meta informa para um número é um de 50, 250, 1.000, 10.000, 100.000 ou ilimitado.
2.000 não é um nível da Meta. É o valor que usamos quando não sabemos o nível do seu número — alto o bastante para não atrapalhar o uso comum, baixo o bastante para frear um envio descontrolado. Se o seu nível real for 250, 2.000 é generoso demais; se for 10.000, é apertado demais. De qualquer forma, ajuste para o seu nível.
O limite diário é escolhido em Nível diário do WhatsApp:
| Opção | Significado |
|---|---|
| Herdar (padrão) | Usar uma regra da plataforma para este número, se houver; senão, 2.000 |
| 250 / dia … 100.000 / dia | Essa quantidade de modelos por dia (250, 1.000, 2.000, 10.000, 100.000) |
| Ilimitado | Sem limite diário; os limites por segundo e por minuto continuam valendo |
Um valor definido de outra forma (um nível detectado de 50, por exemplo) aparece como uma opção própria, como 50 / dia.
Mudar o nível diário muda só o limite diário. Os limites por segundo e por minuto continuam como estavam; não há campo para eles no app.
Onde alterar
Um número conectado direto da Meta. Abra-o em /channels. O cartão Limite de envio mostra o limite em vigor e de onde ele vem: padrão da plataforma, definido neste canal ou da regra da plataforma … quando o Omni Octo tem uma regra para o prefixo do seu número. Escolha um Nível diário do WhatsApp e clique em Salvar.
Ou clique em Detectar pela Meta. Ele pede à Meta o nível atual do número e salva o limite diário correspondente — Nível TIER_1K da Meta aplicado, por exemplo. Se a Meta não devolver um nível, um erro avisa e nada muda. A detecção roda quando você clica; ela não acompanha seu nível depois, então clique de novo quando o nível mudar.
Um número que você comprou pelo Omni Octo. O cartão do canal diz Este número é um dos seus números de telefone. Defina o limite de envio na página desse número. Lá, em Limites de envio, a mesma lista Nível diário do WhatsApp fica ao lado dos limites de SMS e de chamadas; Salvar limites grava e Restaurar o padrão remove. Um limite definido no número de telefone prevalece sobre todo o resto.
Pedindo ao Octo. “Aumente o limite diário do nosso número de WhatsApp para 10.000” também funciona, para os dois tipos de número.
Só um proprietário ou administrador do espaço de trabalho pode mudar o limite, em qualquer um desses lugares. Na página do canal, os demais o veem somente para leitura, com Somente um proprietário ou administrador do espaço de trabalho pode alterar o limite de envio.; na página do número de telefone, o salvamento deles é recusado.
Os dois editores trazem o mesmo alerta, e é ele que deve ser levado a sério:
Elevar esses valores acima do que sua operadora ou a Meta realmente permitem pode fazer este número ser limitado ou bloqueado — o risco é seu. Para o WhatsApp, confirme seu nível real em WhatsApp Manager → Messaging limits.
Subir o limite aqui não sobe o da Meta. Só faz com que não sejamos nós a recusar primeiro.
Duas cotas de velocidade, uma para o dia
Uma campanha e todo o resto usam cotas por segundo e por minuto separadas, cada uma do tamanho do limite configurado:
- As campanhas têm uma.
- Os envios diretos — a caixa de entrada, a API, o Octo, as pesquisas e os fluxos de trabalho — dividem a outra.
Assim, a campanha da Lavanderia Tidewater enviando o mais rápido que o número permite não atrasa em um segundo uma resposta na caixa de entrada. O preço é que as duas juntas podem enviar ao dobro do ritmo configurado: 10 por segundo com o padrão de 5.
A contagem diária de modelos é um total único por número. Todo modelo conta, seja qual for a via que o enviou. Se a campanha de segunda-feira enviar 1.800 modelos num número de 2.000 por dia, sobram 200 modelos para a caixa de entrada naquele dia — e respostas em texto livre ilimitadas para quem estiver com a janela aberta.
O alerta acima de 40 por segundo
A vazão padrão da Meta para um número é de 80 mensagens por segundo. Quando o limite por segundo de um número passa de 40, os dois editores mostram:
Este número pode enviar 50 mensagens por segundo. As campanhas e os envios diretos (a caixa de entrada, a API e o Octo) têm cada um essa velocidade, então juntos podem ultrapassar o padrão da Meta de 80 mensagens por segundo por número.
Com os valores padrão você não vai vê-lo.
O que cada via faz no limite
| Onde o envio começa | No limite por segundo ou por minuto | No limite diário de modelos |
|---|---|---|
| Campanha | Espera, e continua quando a janela reabre | Espera o dia seguinte |
| Caixa de entrada | ”Este número está enviando rápido demais no momento. Tente novamente em 12 segundos." | "Este número atingiu o limite de modelos do WhatsApp de hoje. As respostas em texto livre continuam funcionando; os modelos serão retomados em 5 horas.” |
| API | 429, código rate_limited, cabeçalho Retry-After | 429, código daily_limit_reached, cabeçalho Retry-After |
| Octo | Diz quando tentar de novo, em vez de repetir por conta própria | O mesmo, com as horas até o reinício |
| Etapa de fluxo de trabalho | Repetida automaticamente depois da espera | A etapa falha: “This number reached its daily WhatsApp template limit; it resets in N h” |
| Pergunta de pesquisa | Feita de novo depois da espera | Feita de novo depois da espera |
Alguns detalhes por trás da tabela:
- A caixa de entrada guarda seu texto. A mensagem aparece abaixo da caixa de resposta e o rascunho continua lá, pronto para enviar de novo.
- Uma espera curta é absorvida. Fora de uma campanha, um limite por segundo ou por minuto que reabre em até dois segundos é aguardado e o envio sai. Qualquer coisa mais longa, e o limite diário, é recusada na hora.
- Um fluxo de trabalho espera até cinco minutos. Uma recusa que se resolve em até 300 segundos é repetida depois exatamente dessa espera; qualquer coisa mais longa — na prática, o limite diário — faz a etapa falhar.
- Os dois códigos da API trazem
retryAfterSecno corpo, igual ao cabeçalhoRetry-After. Enviar do seu próprio sistema tem a resposta completa, e a taxa própria da API por espaço de trabalho (300 chamadas por minuto por padrão), que a caixa de entrada, o Octo e as campanhas nunca tocam.
Um envio recusado não deixa mensagem
Quando o limite recusa um envio da caixa de entrada, da API ou do Octo, nada chegou à Meta e nada é registrado: nenhuma mensagem aparece na conversa, e não há nada marcado como falha para limpar. Se era a primeira mensagem para esse número, a conversa em si ainda é criada, vazia. Um modelo recusado também não consome nada da contagem do dia.
O que o limite não faz
- Ele conta mensagens, não pessoas. O nível da Meta conta as pessoas com quem você inicia conversas; nós contamos cada modelo. Três modelos para um cliente são um no limite da Meta e três no nosso. Isso erra para o lado seguro, mas um número que escreve com frequência para as mesmas pessoas vai atingir o nosso limite antes do da Meta.
- O dia é um dia UTC. Ele reinicia à meia-noite UTC, não à meia-noite onde você está, nem 24 horas depois do seu primeiro envio. A janela da própria Meta é de 24 horas corridas.
- Um envio que a Meta rejeita continua contando. A contagem é feita antes de a mensagem ir para a Meta. Se a Meta recusar depois — um modelo de marketing que ela decide não entregar, uma variável errada —, ele ocupou um lugar no dia.
- Ele não aumenta os limites da Meta. A Meta ainda pode recusar ou desacelerar um número que está dentro dos nossos.
Para onde ir depois
- Quando uma mensagem do WhatsApp precisa ser um modelo — a janela de 24 horas e por que as respostas em texto livre ficam fora do limite diário.
- Enviar um modelo para uma lista — a campanha que divide a contagem diária com todo o resto.
- Enviar um modelo a partir de uma conversa, do seu próprio sistema ou pedindo ao Octo.