---
title: "Métricas de grupo no WhatsApp: entradas e saídas"
description: "Como medir entradas, saídas, churn e engajamento de grupos de WhatsApp com a API não oficial: eventos de participantes, mensagens por membro e painel SQL."
url: "https://api-wa.me/blog/metricas-grupo-whatsapp-entradas-saidas-engajamento"
language: "pt-BR"
og:type: "article"
og:site_name: "WAME API"
---

[Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Métricas de grupo no WhatsApp: entradas, saídas e engajamento pela API

Raphael Serafim· Publicado em 28 de setembro de 2026· 8 min de leitura

Compartilhar

# Métricas de grupo no WhatsApp: entradas, saídas e engajamento pela API

Como medir entradas, saídas, churn e engajamento de grupos de WhatsApp com a API não oficial: eventos de participantes, mensagens por membro e painel SQL.

Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/metricas-grupo-whatsapp-entradas-saidas-engajamento.md)

**Para medir um grupo de WhatsApp pela API não oficial, registre dois tipos de evento que chegam no webhook: `participants_updated` (entradas, saídas, promoções) e cada mensagem de grupo, que traz `group_id` e `from`. Com essas duas tabelas você calcula crescimento, churn, membros ativos, membros silenciosos e o efeito de cada mensagem enviada.** O WhatsApp não tem painel de grupo; você monta o seu com algumas consultas SQL.

Quem administra grupos no celular vive de impressão: "acho que o grupo esfriou", "parece que saiu gente depois daquele aviso". Com dados, essas perguntas têm resposta. Este guia mostra o que coletar, como guardar e quais métricas valem acompanhar.

> A camada não oficial da WAME é independente e não é afiliada, endossada ou suportada pelo WhatsApp ou pela Meta. O uso é de responsabilidade de quem envia.

## O que dá para medir

| Métrica | Pergunta que responde | Fonte |
| --- | --- | --- |
| Entradas por dia | O convite está funcionando? | evento de participantes |
| Saídas por dia | Algo está afastando gente? | evento de participantes |
| Churn do período | Quanto do grupo perdi? | eventos + membros |
| Mensagens por dia | O grupo está vivo? | mensagens de grupo |
| Membros ativos | Quantos falam de verdade? | mensagens de grupo |
| Membros silenciosos | Quem só observa? | membros − ativos |
| Saídas após envio | Aquela mensagem incomodou? | eventos + seus envios |

Nenhuma dessas métricas depende de ler o conteúdo das conversas. Contagem basta.

## Ligando a coleta

Aponte o webhook de grupos para o seu servidor com `PUT /{key}/instance`, no formato `meta`:

bash

Copiar

```
curl -X PUT "https://us.api-wa.me/SUA_KEY/instance" \
  -H "Content-Type: application/json" \
  -d '{
    "allowWebhook": true,
    "allowNumber": "all",
    "webhookGroup": "https://seu-servidor.com/webhook/grupos",
    "webhookFormat": "meta"
  }'
```

A partir daqui, entradas, saídas e mensagens de grupo chegam nessa URL. O histórico começa hoje: o que aconteceu antes da coleta não volta.

## Tabela 1: eventos de participantes

No formato `meta`, a mudança de participantes chega com `field: "groups"`:

json

Copiar

```
{
  "object": "wame",
  "provider": "whatsapp",
  "entry": [{
    "changes": [{
      "field": "groups",
      "value": {
        "groups": {
          "event": "participants_updated",
          "id": "[email protected]",
          "action": "add",
          "participants": ["[email protected]"]
        }
      }
    }]
  }]
}
```

Grave uma linha por participante:

javascript

Copiar

```
app.post('/webhook/grupos', async (req, res) => {
  res.sendStatus(200);
  const change = req.body?.entry?.[0]?.changes?.[0];

  if (change?.field === 'groups') {
    const { event, id, action, participants } = change.value.groups;
    if (event !== 'participants_updated') return;
    for (const p of participants ?? []) {
      await db.query(
        'INSERT INTO grupo_eventos (grupo, participante, acao, quando) VALUES ($1, $2, $3, now())',
        [id, p, action],
      );
    }
    return;
  }

  const msg = change?.value?.messages?.[0];
  if (msg?.group_id && !msg.from_me) {
    await db.query(
      'INSERT INTO grupo_mensagens (grupo, autor, tipo, quando) VALUES ($1, $2, $3, now())',
      [msg.group_id, msg.from, msg.type],
    );
  }
});
```

O `action` chega como `add` (entrada), `remove` (saída), `promote` (virou admin) ou `demote` (deixou de ser admin); guarde o valor como chegou e interprete nas consultas. Participantes podem aparecer como LID (`@lid`) — para contagem não faz diferença, e se precisar do telefone veja [LID no WhatsApp](https://api-wa.me/blog/lid-whatsapp-o-que-e-resolver-numero-api).

## Tabela 2: mensagens de grupo

O mesmo webhook já salva a segunda tabela no código acima: `grupo`, `autor`, `tipo` e horário. Repare que **não guardamos o texto**. Para métricas de engajamento, quem falou e quando é suficiente, e não guardar conteúdo reduz muito o problema de dado pessoal.

Um detalhe: ignore `from_me`. As mensagens da própria instância (avisos, bot) inflariam o engajamento com a sua própria voz.

## Tabela 3: fotografia de membros

Eventos contam mudanças; para saber o total, tire uma foto diária com `GET /{key}/groups/{id}/members`:

javascript

Copiar

```
async function fotografar(grupos) {
  for (const g of grupos) {
    const r = await fetch(`https://us.api-wa.me/SUA_KEY/groups/${g}/members`).then((x) => x.json());
    // /members devolve a lista de participantes em `data`.
    const membros = r.data ?? [];
    await db.query(
      'INSERT INTO grupo_membros_dia (grupo, dia, total) VALUES ($1, current_date, $2) ON CONFLICT DO NOTHING',
      [g, membros.length],
    );
    await new Promise((ok) => setTimeout(ok, 3000));
  }
}
```

A foto diária também corrige o que o webhook eventualmente perder. Se você gerencia muitos grupos, integre isso ao inventário descrito em [gerenciar centenas de grupos](https://api-wa.me/blog/gerenciar-centenas-grupos-whatsapp-api).

## As consultas que viram painel

Entradas e saídas por dia, por grupo:

sql

Copiar

```
SELECT grupo, date(quando) AS dia,
       count(*) FILTER (WHERE acao = 'add')    AS entradas,
       count(*) FILTER (WHERE acao = 'remove') AS saidas
FROM grupo_eventos
GROUP BY grupo, dia
ORDER BY dia DESC;
```

Churn dos últimos 30 dias:

sql

Copiar

```
SELECT e.grupo,
       count(*) FILTER (WHERE e.acao = 'remove')::float
         / nullif(max(m.total), 0) AS churn_30d
FROM grupo_eventos e
JOIN grupo_membros_dia m ON m.grupo = e.grupo AND m.dia = current_date
WHERE e.quando > now() - interval '30 days'
GROUP BY e.grupo;
```

Membros ativos e silenciosos na semana:

sql

Copiar

```
SELECT m.grupo,
       m.total AS membros,
       count(DISTINCT g.autor) AS ativos,
       m.total - count(DISTINCT g.autor) AS silenciosos
FROM grupo_membros_dia m
LEFT JOIN grupo_mensagens g
  ON g.grupo = m.grupo AND g.quando > now() - interval '7 days'
WHERE m.dia = current_date
GROUP BY m.grupo, m.total;
```

Com essas três consultas num Metabase, Grafana ou planilha, você já tem mais visibilidade que a maioria dos administradores de grupo.

## A métrica mais útil: saídas depois de um envio

Guarde também os envios que você faz para cada grupo (horário e tipo de conteúdo). Cruzando com as saídas das duas horas seguintes, você descobre qual conteúdo afasta gente:

sql

Copiar

```
SELECT s.id AS envio, s.tipo, s.quando,
       count(e.*) AS saidas_2h
FROM seus_envios s
LEFT JOIN grupo_eventos e
  ON e.grupo = s.grupo AND e.acao = 'remove'
 AND e.quando BETWEEN s.quando AND s.quando + interval '2 hours'
GROUP BY s.id, s.tipo, s.quando
ORDER BY saidas_2h DESC;
```

Se a promoção das 22h derruba dez pessoas e o conteúdo das 10h não derruba nenhuma, a decisão está tomada. Saída em massa também é um sinal de risco para o número: gente que sai incomodada tende a denunciar. Os outros sinais estão em [sinais de que o número está em risco](https://api-wa.me/blog/sinais-numero-whatsapp-risco-bloqueio).

## Privacidade: agregue antes de mostrar

Métricas de grupo tocam em dado pessoal de todo mundo que participa. Três regras práticas:

- **Não guarde conteúdo** se o objetivo é métrica. Autor, tipo e horário bastam.
- **Mostre agregado.** O painel exibe totais e taxas; o detalhe por pessoa fica restrito aos administradores.
- **Defina retenção.** Eventos de meses atrás raramente mudam decisão. Apague ou agregue depois de um prazo.

Nunca publique ranking de "quem mais fala" no próprio grupo sem as pessoas saberem e concordarem. Para o lado contratual, veja [API de WhatsApp e LGPD](https://api-wa.me/blog/whatsapp-api-lgpd-contrato-cliente).

## Onde as métricas mudam a operação

Com números, as decisões de grupo ficam objetivas:

- **Grupo de lançamento:** entradas por hora mostram quando a página converte e quando abrir o próximo grupo. Veja [grupos de lançamento com rotação](https://api-wa.me/blog/grupos-lancamento-whatsapp-automacao-api).
- **Grupo de clientes:** churn crescendo indica frequência alta demais de avisos.
- **Comunidade aberta:** poucos ativos e muitos silenciosos pedem conteúdo que convide à conversa — uma [enquete](https://api-wa.me/blog/pesquisa-satisfacao-enquete-whatsapp-api), por exemplo.

## Conclusão

Métricas de grupo no WhatsApp saem de dois eventos que a API não oficial da WAME entrega no webhook de grupos — `participants_updated` e as mensagens com `group_id` — mais uma fotografia diária de membros. Com três tabelas e algumas consultas SQL, você mede entradas, saídas, churn, membros ativos e o efeito de cada envio, sem guardar o conteúdo das conversas. É o painel que o WhatsApp não tem, e é ele que transforma a administração de grupo de palpite em decisão. Os formatos completos estão na [documentação](https://api-wa.me/docs).

### Pronto para automatizar seu WhatsApp?

Crie sua conta gratuita e comece a enviar mensagens pela API em minutos.

[Começar grátis](https://portal.api-wa.me/sign-up)

## Perguntas frequentes

Como saber quem entrou e saiu de um grupo de WhatsApp pela API?+

Configure o webhook de grupos (webhookGroup em PUT /{key}/instance). Cada entrada, saída, promoção ou rebaixamento chega como evento com field groups e value.groups contendo event participants\_updated, o id do grupo, a action e a lista de participants. Grave cada evento numa tabela e você tem o histórico completo.

Dá para medir engajamento de um grupo?+

Sim. Toda mensagem de grupo chega no webhook com group\_id e from (quem enviou). Contando mensagens por grupo, por dia e por membro, você calcula membros ativos, membros silenciosos e picos de conversa.

O que é churn de grupo no WhatsApp?+

É a proporção de pessoas que saíram do grupo num período em relação ao total de membros. Churn alto logo depois de uma mensagem específica é o melhor indicador de que aquele conteúdo, horário ou frequência incomodou.

Consigo ver as métricas de grupos antigos, de antes da integração?+

Os eventos de entrada, saída e mensagens só são registrados a partir do momento em que o seu webhook começa a recebê-los. Para o estado atual (membros e admins), use GET /{key}/groups/{id}/members a qualquer momento; o histórico começa no dia em que você ligar a coleta.

Posso mostrar quem mais fala no grupo para os membros?+

Evite. Métricas de grupo envolvem dado pessoal de quem participa. Use os números agregados para tomar decisões (horário, frequência, conteúdo) e mantenha o detalhe por pessoa restrito aos administradores, pelo tempo necessário.

## Continue lendo

[### Como gerenciar centenas de grupos de WhatsApp pela API (em lote)

Inventário, padronização em lote, auditoria de admins e limpeza de grupos mortos: como gerenciar centenas de grupos de WhatsApp com a API não oficial.](https://api-wa.me/blog/gerenciar-centenas-grupos-whatsapp-api)[### Grupos de lançamento no WhatsApp: automação com rotação de grupos pela API

Como automatizar grupos de lançamento no WhatsApp pela API não oficial: criar grupos em sequência, link único com rotação, modo anúncio e dia do carrinho.](https://api-wa.me/blog/grupos-lancamento-whatsapp-automacao-api)[### IA que responde dúvidas no grupo de WhatsApp (só quando chamada)

IA para responder dúvidas em grupo de WhatsApp pela API não oficial: gatilho por menção, base de conhecimento, resposta citada e escalar para admin.](https://api-wa.me/blog/ia-responder-duvidas-grupo-whatsapp)

[Voltar ao blog](https://api-wa.me/blog)

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "WAME API",
  "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram, Messenger e Telegram",
  "url": "https://api-wa.me",
  "inLanguage": "pt-BR",
  "publisher": {
    "@id": "https://api-wa.me/#organization",
    "@type": "Organization",
    "name": "WAME API",
    "url": "https://api-wa.me"
  }
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://api-wa.me/#organization",
  "name": "WAME API",
  "alternateName": [
    "WAME",
    "Wame API",
    "wame.api.br",
    "api-wa.me"
  ],
  "url": "https://api-wa.me",
  "logo": {
    "@type": "ImageObject",
    "url": "https://api-wa.me/images/web-app-manifest-512x512.png",
    "width": 512,
    "height": 512
  },
  "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.",
  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "INPI-BR",
    "name": "Pedido de registro de marca (INPI, classe NCL 42)",
    "value": "944724159"
  },
  "foundingDate": "2017",
  "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram, Messenger e Telegram numa instância só. Desde 2017.",
  "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code e o Telegram, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.",
  "knowsAbout": [
    "WhatsApp Cloud API oficial (Meta)",
    "API oficial de Instagram (Direct)",
    "API oficial de Messenger",
    "API multicanal Meta",
    "Meta Business Partner",
    "WhatsApp API",
    "API não oficial de WhatsApp",
    "automação de WhatsApp",
    "números virtuais",
    "webhooks"
  ],
  "sameAs": [
    "https://github.com/wame-api",
    "https://www.linkedin.com/company/wameapi",
    "https://www.instagram.com/wame.api/",
    "https://www.youtube.com/@wameapi"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer support",
    "url": "https://api-wa.me/contact",
    "availableLanguage": [
      "Portuguese"
    ]
  }
}
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Métricas de grupo no WhatsApp: entradas, saídas e engajamento pela API",
  "description": "Como medir entradas, saídas, churn e engajamento de grupos de WhatsApp com a API não oficial: eventos de participantes, mensagens por membro e painel SQL.",
  "image": "https://api-wa.me/blog/metricas-grupo-whatsapp-entradas-saidas-engajamento/opengraph-image",
  "datePublished": "2026-09-28",
  "dateModified": "2026-09-28",
  "author": {
    "@type": "Person",
    "name": "Raphael Serafim",
    "url": "https://github.com/raphaelvserafim",
    "sameAs": [
      "https://github.com/raphaelvserafim"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "api-wa.me",
    "logo": {
      "@type": "ImageObject",
      "url": "https://api-wa.me/images/screenshot.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://api-wa.me/blog/metricas-grupo-whatsapp-entradas-saidas-engajamento"
  },
  "keywords": "api whatsapp não oficial, api não oficial whatsapp, gerenciar grupos whatsapp api, métricas grupo whatsapp, quem saiu do grupo whatsapp, engajamento grupo whatsapp, relatório grupo whatsapp",
  "inLanguage": "pt-BR"
}
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://api-wa.me"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog da API do WhatsApp",
      "item": "https://api-wa.me/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Métricas de grupo no WhatsApp: entradas, saídas e engajamento pela API",
      "item": "https://api-wa.me/blog/metricas-grupo-whatsapp-entradas-saidas-engajamento"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Como saber quem entrou e saiu de um grupo de WhatsApp pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Configure o webhook de grupos (webhookGroup em PUT /{key}/instance). Cada entrada, saída, promoção ou rebaixamento chega como evento com field groups e value.groups contendo event participants_updated, o id do grupo, a action e a lista de participants. Grave cada evento numa tabela e você tem o histórico completo."
      }
    },
    {
      "@type": "Question",
      "name": "Dá para medir engajamento de um grupo?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sim. Toda mensagem de grupo chega no webhook com group_id e from (quem enviou). Contando mensagens por grupo, por dia e por membro, você calcula membros ativos, membros silenciosos e picos de conversa."
      }
    },
    {
      "@type": "Question",
      "name": "O que é churn de grupo no WhatsApp?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "É a proporção de pessoas que saíram do grupo num período em relação ao total de membros. Churn alto logo depois de uma mensagem específica é o melhor indicador de que aquele conteúdo, horário ou frequência incomodou."
      }
    },
    {
      "@type": "Question",
      "name": "Consigo ver as métricas de grupos antigos, de antes da integração?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Os eventos de entrada, saída e mensagens só são registrados a partir do momento em que o seu webhook começa a recebê-los. Para o estado atual (membros e admins), use GET /{key}/groups/{id}/members a qualquer momento; o histórico começa no dia em que você ligar a coleta."
      }
    },
    {
      "@type": "Question",
      "name": "Posso mostrar quem mais fala no grupo para os membros?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Evite. Métricas de grupo envolvem dado pessoal de quem participa. Use os números agregados para tomar decisões (horário, frequência, conteúdo) e mantenha o detalhe por pessoa restrito aos administradores, pelo tempo necessário."
      }
    }
  ]
}
```