Dá para enviar para grupos com a API oficial do WhatsApp?

Vou direto ao ponto que provavelmente te trouxe aqui: não dá para enviar para grupos com a API oficial do WhatsApp. A Cloud API da Meta não permite mandar mensagem para um grupo, não permite criar grupo e não recebe as mensagens que circulam dentro de grupos. Quando alguém nos procura querendo disparar promoção num grupo de clientes pela API, essa é a primeira frustração que a gente precisa desfazer.

É uma limitação de projeto, não um bug nem algo que se resolve com configuração. A API oficial foi desenhada para conversas de um para um, entre a empresa e cada cliente individualmente. Grupo simplesmente não está no escopo.

Por que a API oficial não funciona com grupos

A conversa dentro de grupos no WhatsApp segue a lógica de várias pessoas trocando mensagens num mesmo espaço, sem que exista consentimento individual de cada participante para receber conteúdo de empresa. Isso bate de frente com todo o modelo que a Meta construiu para a API.

A API oficial gira em torno de dois pilares: o opt-in (cada cliente precisa ter autorizado receber suas mensagens) e a janela de 24 horas (depois que o cliente te escreve, você responde livre por 24h; fora disso, só com template aprovado). Grupo quebra os dois. Não há como garantir que os 200 participantes de um grupo autorizaram a empresa a falar com eles. Não há janela de 24h individual controlável. Por isso a Meta nem expôs esses recursos na API.

Na prática, quando você olha a documentação da Cloud API, os endpoints de mensagem trabalham sempre com um número de destino individual (o campo to recebe um telefone, nunca um ID de grupo). Não existe endpoint de grupo. Não é que esteja escondido, ele não existe.

E os números de grupo que aparecem em algumas ferramentas?

Quem já mexeu com bibliotecas não oficiais (as que fazem espelhamento do WhatsApp Web) viu que ali dá para ler e escrever em grupos. Só que isso não é API oficial. São soluções que automatizam o app por engenharia reversa, ficam fora dos termos da Meta e derrubam o número sem aviso. A gente não recomenda e não trabalha com esse caminho. O risco de banimento é real e não tem recurso.

O que a API oficial faz muito bem no lugar de grupos

A boa notícia é que quase todo mundo que pede grupo, na verdade, quer resolver outra coisa: falar com muita gente ao mesmo tempo. E isso a API oficial faz, só que de forma individual, o que costuma render bem mais resultado.

Em vez de um grupo com 100 pessoas onde qualquer um responde para todos, você dispara templates aprovados para cada contato separadamente. Cada cliente recebe a mensagem no privado, como se fosse uma conversa exclusiva. Quem quiser responder, responde só para você, e abre a janela de 24 horas para você conversar à vontade.

Isso muda a percepção de quem recebe. Uma mensagem individual tem cara de atendimento, não de spam de grupo. E você mantém controle: sabe quem leu, quem respondeu, quem pediu para sair.

Templates: o caminho oficial para mensagem ativa

Para iniciar conversa fora da janela de 24h, você usa um modelo de mensagem aprovado pela Meta. Hoje as categorias são marketing, utilidade e autenticação. Um template de marketing pode ser usado para uma campanha para toda a sua base (desde que com opt-in), e a mensagem chega no privado de cada pessoa.

Quando um cliente nos chega com template rejeitado, quase sempre é por conteúdo que parece propaganda escondida em categoria de utilidade, ou por variáveis mal formatadas. Vale escrever o template pensando em como a Meta lê aquilo, não só em como você quer vender.

Listas de transmissão são a mesma coisa que grupo?

Não, e essa confusão é comum. A lista de transmissão do app WhatsApp Business envia a mesma mensagem para vários contatos, mas cada um recebe no privado, sem ver os outros. É o conceito mais próximo do que a maioria imagina quando pede grupo.

Na API oficial não existe o botão de lista de transmissão, mas o efeito é reproduzido tecnicamente: você faz vários envios individuais do mesmo template. A plataforma cuida disso por trás. Do ponto de vista do cliente, é uma mensagem só para ele.

Há um detalhe importante da lista de transmissão no app comum: ela só entrega para quem tem o seu número salvo na agenda. Na API com template aprovado, você não depende disso. O template chega mesmo para quem nunca salvou seu contato, desde que exista o opt-in.

Coexistência: o celular ainda participa de grupos

Aqui entra um ponto que resolve boa parte da dor. Se você conecta seu número à API oficial em modo de coexistência, o app WhatsApp Business continua funcionando no celular no mesmo número, com o histórico e os grupos intactos.

Ou seja: a API cuida dos atendimentos individuais e das campanhas por template, enquanto o app no celular continua sendo usado normalmente, inclusive dentro dos grupos que você já participa. A API não lê nem envia nesses grupos, mas a pessoa operando o celular continua fazendo isso pelo app, sem custo nenhum para iniciar conversas pelo aparelho.

Segundo a covercut, Tech Provider e Business Partner Meta oficial do WhatsApp, na coexistência não é preciso apagar a conta, desinstalar o app nem perder conversas. O número passa a viver nos dois mundos ao mesmo tempo. Para quem depende de grupos operacionais no dia a dia, isso significa que a adoção da API não te obriga a abandonar nada.

Como atender bem sem depender de grupos

Na operação real, a estrutura que mais funciona é essa:

• Base de contatos com opt-in registrado, para poder disparar templates sem risco de queda de qualidade.
• Campanhas por template aprovado na categoria certa (marketing para oferta, utilidade para aviso de pedido, cobrança, agendamento).
• Atendimento individual na janela de 24 horas, com respostas livres depois que o cliente interage.
• Uma plataforma de atendimento (como o Chatwoot integrado à API) para a equipe responder tudo num só painel, já que a API oficial não tem app de conversa próprio.

O que mais derruba a qualidade do número, na prática, não é o volume em si, é mandar mensagem para quem não pediu. Bloqueio e denúncia de usuário puxam a classificação de qualidade para baixo (de verde para amarelo ou vermelho), e aí os limites de disparo caem. Grupo cheio de gente sem opt-in seria justamente o cenário que a Meta quer evitar. Faz sentido a limitação existir.

Resumo prático da limitação

Se o seu objetivo é atirar mensagem num grupo pronto, a API oficial não é o caminho e nenhuma ferramenta séria vai te oferecer isso. Se o objetivo é alcançar muita gente com mensagem relevante, a API resolve melhor, com envio individual, template aprovado e controle de resultado. E se você precisa manter os grupos que já usa no celular, a coexistência deixa o app e a API convivendo no mesmo número.

Quer testar como fica a sua operação sem grupos, com disparo individual por template e atendimento centralizado? Conecte seu número pelo fluxo oficial da Meta com coexistência e mantenha o app do celular funcionando enquanto a API cuida das campanhas.

Perguntas frequentes

Dá para enviar mensagem para grupos usando a API oficial do WhatsApp?

Não. A Cloud API da Meta trabalha apenas com conversas individuais. Não existe endpoint para enviar, criar ou ler grupos. Qualquer ferramenta que prometa isso está usando automação não oficial, o que viola os termos da Meta e coloca seu número em risco de banimento.

Como atingir muitas pessoas ao mesmo tempo se não posso usar grupos?

Você usa templates de mensagem aprovados pela Meta e envia para cada contato individualmente, com opt-in registrado. O efeito é parecido com uma lista de transmissão: todo mundo recebe a mesma mensagem, mas no privado, sem ver os outros. Costuma dar mais resultado que grupo, porque tem cara de atendimento e não de spam.

Se eu conectar meu número à API, perco os grupos que já uso no celular?

Não, desde que você use o modo de coexistência. O app WhatsApp Business continua funcionando no mesmo número, com histórico e grupos intactos. A API cuida dos atendimentos individuais e das campanhas, enquanto você segue participando dos grupos normalmente pelo aparelho.

A lista de transmissão da API é igual à do app comum?

O conceito é o mesmo (uma mensagem para vários contatos no privado), mas na API isso é feito por vários envios individuais de template. A vantagem é que, com template aprovado e opt-in, a mensagem chega mesmo para quem não tem seu número salvo, o que não acontece na lista de transmissão do app.

Enviar para muita gente pela API pode derrubar meu número?

Pode, se você mandar para quem não deu opt-in. Bloqueios e denúncias reduzem a classificação de qualidade do número (verde, amarelo ou vermelho) e podem cortar seus limites de disparo. Enviar só para quem autorizou, com conteúdo relevante e template na categoria certa, mantém a qualidade alta.