Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Limites e regras da Partner API: políticas da Meta, 20 mensagens por segundo e a regra dos 14 dias

Um número Coexistence ligado através da Partner API da easyCoexistence envia até 20 mensagens por segundo, um ritmo fixado pela Meta, e a Meta desliga um número cujo telemóvel fique inativo durante cerca de 14 dias. Uma plataforma que liga as contas dos seus clientes atua em nome deles, por isso cumpre as regras de cada rede: no WhatsApp, respostas dentro da janela de serviço ao cliente de 24 horas, templates aprovados fora dela, sem spam e sem chatbots de IA de uso geral.

20 mps

Throughput fixo que a Meta define para um número em uso com a app do WhatsApp Business e a Cloud API.

80 mps

Throughput predefinido da Cloud API para um número só na API, que pode subir automaticamente até 1,000.

About 14 days

Inatividade do telemóvel com a app do WhatsApp Business, após a qual a Meta desliga o número, motivo PRIMARY_INACTIVITY.

24 hours

A janela de serviço ao cliente aberta pela mensagem de uma pessoa; fora dela, uma empresa só pode enviar templates aprovados.

250

Limite de mensagens de um novo portefólio empresarial: pessoas contactadas fora da janela de serviço por cada 24 horas móveis.

De quem são as regras que a plataforma cumpre?

De cada rede, para cada cliente que liga. As contas funcionam pela API oficial de cada rede, e as suas regras aplicam-se ao que o seu software envia e publica através dela. No WhatsApp, a fiscalização da Meta recai sobre a conta WhatsApp Business do cliente e sobre a app através da qual o número está ligado, por isso o abuso das regras da Meta termina a chave de API de uma plataforma.

Que regras da Meta se aplicam no WhatsApp?

As regras de mensagens da Meta, cumpridas pelo software que envia em nome da empresa:

  • Respostas em texto livre só nas 24 horas após a última mensagem da pessoa; cada nova mensagem dela reinicia a janela.
  • Fora da janela, apenas templates que a Meta tenha aprovado.
  • Mensagens apenas para pessoas que optaram por receber mensagens da empresa.
  • Sem spam e sem chatbots de IA de uso geral no número.
  • O alcance fora da janela conta-se por portefólio empresarial: um novo começa com 250 pessoas por cada 24 horas móveis.

Com que rapidez pode enviar um número Coexistence?

A 20 mensagens por segundo, um ritmo fixo que a Meta define para que o número continue compatível com a app do WhatsApp Business. Um número só na Cloud API parte de 80 e pode subir automaticamente até 1,000, mas um número Coexistence mantém-se nas 20. O limite de mensagens do portefólio aplica-se por cima, contando as pessoas contactadas fora da janela de serviço.

O que é a regra dos 14 dias?

A Meta desliga um número Coexistence quando o telemóvel com a app do WhatsApp Business esteve inativo durante cerca de 14 dias, com o motivo PRIMARY_INACTIVITY. A easyCoexistence vigia cada número e envia para o URL de eventos da sua conta connection.disconnected com esse motivo. A solução é um novo link de ligação para esse cliente: o cliente repete o fluxo com o mesmo número, e este regressa.

Que outras desligações a Meta comunica?

Quando a Meta termina a ligação de um número, connection.disconnected traz o código de motivo da Meta, sempre que se conhece. Além de PRIMARY_INACTIVITY, a Meta indica estes:

  • ACCOUNT_DISCONNECTED: fiscalização da Meta, ou o cliente eliminou a conta WhatsApp; iniciado pelo utilizador ou pelo sistema.
  • CHANGE_NUMBER: o cliente mudou o número de telefone.
  • BUSINESS_DOWNGRADE: o número estava registado na app WhatsApp de consumo.
  • USER_RE_REGISTERED: o cliente voltou a registar o WhatsApp num novo dispositivo.
  • COMPANION_INACTIVITY: um dispositivo associado esteve sem uso durante cerca de 30 dias.

O que termina uma chave da Partner API?

Três coisas. Renova-a, o que a substitui de imediato por uma nova chave; revoga-a, o que deixa a conta sem chave; ou a easyCoexistence a termina porque a conta abusou das regras da Meta. Uma chave não tem data de validade própria e, depois de terminada, devolve 401 unauthorized em cada pedido.

Que limites se aplicam às sessões de ligação?

Uma conta pode ter 50 sessões de ligação abertas em simultâneo e criar 100 por hora. A Meta conta cada primeira integração contra um limite de toda a app, que todas as contas da easyCoexistence partilham, por isso os tetos impedem que a importação em massa de uma plataforma o esgote para todos. Um teto responde com 429 cap_reached ou rate_limited.

Que regras definem as redes sociais?

As de cada rede, aplicadas às contas que os seus clientes ligam, e diferem nos mesmos poucos aspetos:

  • Janelas de mensagens: as mensagens diretas do Instagram e do Facebook podem ser respondidas dentro de uma janela predefinida, normalmente 24 horas após a última mensagem da pessoa.
  • Limites de publicação e quotas da API por conta, que variam consoante a rede.
  • Validade dos tokens: algumas redes emitem tokens que duram uma hora ou um dia, que a easyCoexistence renova.
  • Consentimento: o titular da conta pode retirar o acesso nas definições da rede a qualquer momento, o que chega como channel.disconnected.
  • Funcionalidades: o TikTok, o YouTube e o LinkedIn não oferecem mensagens diretas 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 mesmo número Coexistence. A Meta mantém-no em 20 mensagens por segundo, por isso coloque em fila os envios de cada número a esse ritmo, em vez de os disparar todos de uma vez.
  • Contar com a app do WhatsApp Business para enviar templates. No Coexistence só a API os envia, por isso tudo o que estiver fora da janela de 24 horas tem de passar pelo seu backend.
  • Guardar o token de acesso de uma rede social para mais tarde. Alguns duram uma hora ou um dia, por isso obtenha as credenciais de novo à easyCoexistence no início de cada tarefa.
Fazer isto com a EasyCoexistence

A easyCoexistence mantém os números WhatsApp dos seus clientes e as suas contas de Instagram, Facebook, TikTok, YouTube e LinkedIn, e mais canais, ligados através da API oficial de cada rede, e avisa a sua plataforma com um evento assinado quando uma ligação cai, com o motivo sempre que se conhece. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

O que significa COMPANION_INACTIVITY?

Um dispositivo associado esteve sem uso durante cerca de 30 dias, um dos motivos que a Meta indica para desligar um número.

O que acontece aos meus clientes se a minha plataforma violar as regras da Meta?

A fiscalização da Meta recai sobre as contas WhatsApp Business dos clientes e sobre a app através da qual os números estão ligados, e a easyCoexistence termina a chave de API de qualquer conta que abuse das regras.

A regra dos 14 dias aplica-se às contas sociais?

Não. É a regra da Meta para números partilhados entre a app do WhatsApp Business e a API. Uma conta social cai quando a rede recusa o seu token ou o titular retira o acesso, o que chega como channel.disconnected.

Os limites diferem de rede para rede?

Sim. Cada rede define as suas próprias janelas de mensagens, limites de publicação, quotas da API e validade dos tokens, e aplicam-se às contas que liga como aplicariam às suas próprias contas.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em