Limites e regras da Partner API: políticas da Meta, 20 mensagens por segundo e a regra dos 14 dias
Um número de Coexistência conectado pela Partner API da easyCoexistence envia até 20 mensagens por segundo, taxa que a Meta fixa, e a Meta desconecta um número cujo telefone fica inativo por cerca de 14 dias. Uma plataforma que conecta as contas dos clientes age em nome deles, então mantém para eles as regras de cada rede: no WhatsApp, respostas dentro da janela de atendimento de 24 horas, templates aprovados fora dela, sem spam e sem chatbots de IA de uso geral.
Throughput fixo que a Meta define para um número em uso com o app do WhatsApp Business e a Cloud API.
Throughput padrão da Cloud API para um número só na API, que pode subir automaticamente para 1,000.
Inatividade do telefone que tem o app do WhatsApp Business, após a qual a Meta desconecta o número, motivo PRIMARY_INACTIVITY.
A janela de atendimento aberta pela mensagem de um usuário; fora dela, a empresa só pode enviar templates aprovados.
Limite de mensagens de um novo Portfólio de Negócios: pessoas alcançadas fora da janela de atendimento por período móvel de 24 horas.
De quais regras uma plataforma cuida?
As de cada rede, para cada cliente que ela conecta. As contas rodam na API oficial de cada rede, e as regras dela valem para o que o seu software envia e publica por meio delas. No WhatsApp, a fiscalização da Meta recai sobre a Conta do WhatsApp Business do cliente e sobre o app ao qual o número está conectado, por isso o abuso das regras da Meta encerra a chave de API da plataforma.
Quais regras da Meta se aplicam no WhatsApp?
As regras de mensagens da Meta, mantidas pelo software que envia para a empresa:
- Respostas livres somente dentro de 24 horas da última mensagem da pessoa; cada nova mensagem dela reinicia a janela.
- Fora da janela, somente templates que a Meta tenha aprovado.
- Mensagens apenas para pessoas que optaram por receber da empresa.
- Nada de spam e nenhum chatbot de IA de uso geral no número.
- O alcance fora da janela é contado por Portfólio de Negócios: um novo começa com 250 pessoas por período móvel de 24 horas.
Com que velocidade um número de Coexistência pode enviar?
A 20 mensagens por segundo, taxa fixa que a Meta define para que o número siga compatível com o app do WhatsApp Business. Um número só na Cloud API começa em 80 e pode ser elevado automaticamente para 1,000, mas um número de Coexistência permanece em 20. O limite de mensagens do portfólio se aplica por cima, contando as pessoas alcançadas fora da janela de atendimento.
O que é a regra dos 14 dias?
A Meta desconecta um número de Coexistência quando o telefone que tem o app do WhatsApp Business fica inativo por cerca de 14 dias, com o motivo PRIMARY_INACTIVITY. A easyCoexistence acompanha cada número e envia à sua URL de eventos connection.disconnected com esse motivo. A solução é um novo link de conexão para esse cliente: ele refaz o fluxo com o mesmo número, e o número volta.
Quais outras desconexões a Meta informa?
Quando a Meta encerra a conexão de um número, connection.disconnected traz o código de motivo da Meta, quando ele é conhecido. Além de PRIMARY_INACTIVITY, a Meta lista estes:
ACCOUNT_DISCONNECTED: fiscalização da Meta, ou o cliente excluiu a conta do WhatsApp; iniciada pelo usuário ou pelo sistema.CHANGE_NUMBER: o cliente trocou o número de telefone.BUSINESS_DOWNGRADE: o número estava registrado no app do WhatsApp para consumidores.USER_RE_REGISTERED: o cliente registrou o WhatsApp de novo em um novo dispositivo.COMPANION_INACTIVITY: um dispositivo vinculado ficou sem uso por cerca de 30 dias.
O que encerra uma chave da Partner API?
Três coisas. Você a rotaciona, o que a substitui por uma nova chave na hora; você a revoga, o que deixa a conta sem chave; ou a easyCoexistence a encerra porque a conta abusou das regras da Meta. A chave não tem data de validade própria e, uma vez encerrada, recebe 401 unauthorized em toda requisição.
Que limites se aplicam às sessões de conexão?
Uma conta pode manter 50 sessões de conexão abertas ao mesmo tempo e criar 100 por hora. A Meta conta cada onboarding de primeira vez contra um limite do app inteiro, que todas as contas da easyCoexistence compartilham, então os tetos impedem que a importação em massa de uma plataforma esgote esse limite para todos. Um teto responde 429 cap_reached ou rate_limited.
Que regras as redes sociais definem?
As próprias de cada rede, aplicadas às contas que seus clientes conectam, e elas diferem em alguns pontos iguais:
- Janelas de mensagens: DMs do Instagram e do Facebook podem ser respondidas dentro de uma janela padrão, geralmente de 24 horas após a última mensagem da pessoa.
- Limites de publicação e cotas de API por conta, que variam de rede para rede.
- Validade dos tokens: algumas redes emitem tokens que duram uma hora ou um dia, que a easyCoexistence renova.
- Consentimento: o dono da conta pode retirar o acesso nas configurações da rede a qualquer momento, o que chega como channel.disconnected.
- Recursos: TikTok, YouTube e LinkedIn não oferecem DMs aqui, e a easyCoexistence não recebe eventos de comentários do YouTube nem do LinkedIn.
Erros comuns
- Enviar em rajadas a partir de um número de Coexistência. A Meta o limita a 20 mensagens por segundo; por isso, enfileire os envios de cada número nessa taxa, em vez de disparar todos de uma vez.
- Contar com o app do WhatsApp Business para enviar templates. Na Coexistência, só a API os envia, então tudo que estiver fora da janela de 24 horas precisa passar pelo seu backend.
- Guardar o token de acesso de uma rede social para usar depois. Alguns duram uma hora ou um dia; por isso, busque as credenciais novamente na easyCoexistence quando cada tarefa começar.
A easyCoexistence mantém os números de WhatsApp dos seus clientes e as contas deles no Instagram, Facebook, TikTok, YouTube e LinkedIn, e mais canais, conectados pela API oficial de cada rede, e avisa sua plataforma com um evento assinado quando um deles cai, com o motivo quando ele é conhecido. De US$ 9 a US$ 0.75 por conexão por mês, com o preço caindo conforme você adiciona conexões, e os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
O que significa COMPANION_INACTIVITY?
Um dispositivo vinculado ficou sem uso por cerca de 30 dias, um dos motivos que a Meta dá para desconectar um número.
O que acontece com meus clientes se minha plataforma violar as regras da Meta?
A fiscalização da Meta recai sobre as Contas do WhatsApp Business deles e sobre o app ao qual os números estão conectados, e a easyCoexistence encerra a chave de API de qualquer conta que abuse das regras.
A regra dos 14 dias vale para contas de redes sociais?
Não. É a regra da Meta para números compartilhados entre o app do WhatsApp Business e a API. Uma conta social cai quando a rede recusa o token ou o dono retira o acesso, o que chega como channel.disconnected.
Os limites variam por rede?
Sim. Cada rede define suas próprias janelas de mensagens, limites de publicação, cotas de API e validade de tokens, e eles valem para as contas que você conecta como valeriam para as suas.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em