
# Grupos de WhatsApp (Beta)

Mostre os grupos de WhatsApp de um número de [WhatsApp Web](whatsapp-web.md) ligado na sua caixa de entrada e responda-lhes a partir da aplicação. Cada grupo que escolher torna-se uma conversa, com o nome de cada membro nas suas mensagens, para que possa seguir a conversa, citar um membro e mencionar pessoas tal como no seu telemóvel. Se desejar, o seu agente de IA também pode responder num grupo, mas apenas quando um membro mencionar o seu número ou responder a uma das suas mensagens.

> **Beta.** Os grupos de WhatsApp são uma funcionalidade nova e ainda em fase de melhoramento. Estão disponíveis em planos pagos; num plano gratuito, a secção Grupos aparece como bloqueada. Se a sua conta for gerida por uma agência, a agência decide se os grupos estão disponíveis para si.

Os grupos funcionam apenas em números de WhatsApp Web. A API do WhatsApp Business é ponto a ponto, pelo que os grupos não estão disponíveis nela.

---

## Antes de começar

- Os grupos estão **desativados por predefinição**. Nada dos seus grupos aparece na aplicação até que ative os grupos para um número e escolha os grupos manualmente.
- **Todos no grupo veem as suas respostas**, e as respostas da IA se a ativar. Escreva num grupo da mesma forma que faria no seu telemóvel.
- **O WhatsApp aplica as suas próprias regras a contas que automatizam em grupos** e pode restringir uma conta que envie respostas automáticas nesses locais. Utilize a IA apenas nos grupos onde as pessoas esperam que ela esteja presente.
- **Nada do que é anterior é importado.** Um grupo mostra as mensagens que chegam depois de o ativar, não o seu histórico anterior.

---

## Passo 1: Ativar Grupos para um Número

1. Vá a **Definições → Canais**.
2. Encontre o cartão **WhatsApp Web** do número que pretende. O número tem de estar ligado.
3. Abra a secção **Grupos** nesse cartão (tem um emblema **Beta**).
4. Selecione a caixa **Os membros do grupo veem as minhas respostas. O WhatsApp pode restringir contas que enviem respostas automáticas em grupos.** O interruptor permanece cinzento até o fazer.
5. Ative **Mostrar os meus grupos de WhatsApp na caixa de entrada**.

O interruptor é por número. Os seus outros números de WhatsApp Web permanecem como estão até que também os ative.

---

## Passo 2: Escolher os Grupos a Mostrar

Assim que o interruptor estiver ligado, o cartão lista todos os grupos em que o número está inserido, com o nome do grupo, o número de membros e um emblema de **Administrador** quando o seu número é administrador do grupo. Um grupo onde apenas os administradores podem escrever mostra **Apenas administradores**.

1. Ative **Mostrar na caixa de entrada** para cada grupo que pretende na aplicação.
2. Clique em **Atualizar grupos** se um grupo a que acabou de se juntar ainda não estiver na lista.

Pode mostrar até **25 grupos por número**. O cartão mostra quantos está a utilizar ("3 de 25 grupos mostrados"); para mostrar outro grupo depois de atingir os 25, oculte um primeiro. Ocultar um grupo impede a entrada de novas mensagens desse grupo.

---

## Trabalhar numa Conversa de Grupo

Cada grupo que mostra aparece em **Conversas** como uma conversa com uma etiqueta **Grupo**, o número de membros e a mensagem mais recente.

- **Quem escreveu o quê.** As mensagens de cada membro contêm o seu nome e a sua própria cor, com a sua fotografia na primeira mensagem de uma sequência. O nome é aquele que guardou para essa pessoa se já tiver uma conversa privada com ela; caso contrário, é o nome que utilizam no WhatsApp ou, na falta deste, o seu número.
- **As suas próprias mensagens.** O que envia a partir da aplicação e o que escreve no grupo no seu telemóvel aparece do seu lado da conversa.
- **Responder a um membro.** Utilize **Responder** na mensagem de um membro para a citar, tal como no seu telemóvel.
- **Mencionar um membro.** Escreva **@** na caixa de mensagem e escolha o membro da lista. Eles recebem uma menção real do WhatsApp.
- **Fotografias, notas de voz, reações e vistos** funcionam da mesma forma que numa conversa individual do WhatsApp Web.

### Mensagens à espera de resposta

Quando a mensagem mais recente num grupo é de um membro e ninguém do seu lado escreveu desde então, a linha do grupo mostra quantas mensagens estão à espera, por exemplo **2 por responder**. O filtro **Precisa de resposta** no topo da lista de conversas mostra apenas esses grupos.

Também pode receber uma notificação sobre isso: **Mensagens de grupo do WhatsApp à espera** é enviada no máximo uma vez a cada 10 minutos por grupo. Ative ou desative esta opção juntamente com as suas outras notificações.

### Detalhes do grupo

Abra o painel lateral do grupo (**Detalhes do grupo**) para ver:

- **Membros**: quantas pessoas estão no grupo e a lista completa.
- **Abrir conversa privada** junto a um membro: abre a sua conversa individual com essa pessoa, ou cria-a. Nada é enviado para a pessoa. Isto não está disponível quando o WhatsApp oculta o número do membro; o membro aparece então como **Número oculto** e só pode contactá-lo no grupo.
- **Silenciar IA para este membro**: a IA não responderá a este membro neste grupo. A sua conversa privada não é afetada.
- **IA neste grupo** e **Agente de IA**: se a IA está ativa aqui e qual o agente que responde (ver abaixo).
- **Resumir a conversa**: escreve um breve resumo por IA da conversa mais recente no grupo, indicando quem disse o quê.

### Quando já não pode escrever num grupo

- Se o seu número saiu do grupo ou foi removido dele, a conversa mostra **O seu número já não está neste grupo, por isso não é possível enviar mensagens aqui.** A IA também para nesse grupo.
- Se o grupo estiver configurado para que apenas os administradores possam enviar mensagens e o seu número não for administrador, a conversa indicará isso e as suas mensagens não serão enviadas.

Pode receber uma notificação quando isto acontece: **Removido de um grupo do WhatsApp**.

---

## Deixar a IA responder num grupo

Se ainda não vê a opção de IA, é porque não está ativada para a sua conta.

A IA é definida por grupo e tem duas opções:

- **Desativada**: a IA nunca escreve neste grupo. Esta é a predefinição.
- **Quando mencionada**: a IA responde apenas ao membro que menciona o seu número ou que responde a uma das mensagens da IA. Responde a esse membro pelo nome, no grupo, citando a sua mensagem. Nunca envia mensagens privadas aos membros.

Para configurar:

1. Em **Definições → Canais**, na lista de **Grupos** do número, defina **IA** como **Quando mencionada** para o grupo. A opção de IA aparece assim que a opção **Mostrar na caixa de entrada** do grupo estiver ativa. (Também pode alterá-la em **IA neste grupo** no painel lateral do grupo.)
2. Indique à plataforma qual o agente que responde nos grupos. Abra o agente em **AI Studio → Agentes de IA**, vá ao separador **Pontos de entrada**, clique em **Novo ponto de entrada** e escolha **Grupos do WhatsApp**.
3. Em **Quais os grupos**, escolha **Todos os grupos com IA ativa** ou **Apenas estes grupos** e selecione os grupos.
4. Opcionalmente, adicione **Palavras-chave de comentário**: a IA responderá apenas às mensagens que contenham uma destas palavras.
5. A regra começa desativada. Selecione **Começar a responder imediatamente** ou ative a regra a partir da lista quando estiver pronto e clique em **Guardar**.

Como a IA se comporta num grupo:

- Mantém-se em silêncio em todas as mensagens que não mencionam o seu número ou não citam uma das suas mensagens. Essa mensagem apresenta uma pequena nota no chat (**Mensagem de grupo não endereçada à IA**) e não tem qualquer custo.
- Responde no máximo em 2 mensagens, apenas em texto. Não marca reuniões nem realiza outras ações num grupo.
- Para manter a calma num grupo, responde ao mesmo membro no máximo uma vez a cada 2 horas, escreve no máximo 20 respostas num grupo por dia e aguarda pelo menos 20 segundos entre duas mensagens no mesmo grupo.
- Nunca responde a um membro que tenha silenciado e nunca responde a uma mensagem marcada como spam (essa mensagem continua a aparecer no chat, marcada como spam).
- Grupos com mais de **500 membros** podem ser apresentados na caixa de entrada, mas a IA não está disponível para eles.

---

## O que os grupos nunca fazem

- Um grupo nunca é um contacto. Os grupos e os seus membros não são adicionados aos seus contactos, listas ou listas inteligentes, e nunca aparecem numa exportação dos seus contactos. Os membros também não são transformados em contactos; **Abrir chat privado** cria um contacto para um membro apenas quando clica nele.
- Não pode enviar uma difusão para um grupo e não são efetuados seguimentos em grupos.
- As automatizações que são iniciadas quando um contacto é criado não são executadas para grupos.
- A aplicação nunca cria grupos, adiciona membros ou partilha links de convite, e nunca envia a primeira mensagem num grupo por iniciativa própria.

---

## Custos dos grupos

Não existe qualquer taxa adicional para grupos. Fazem parte da taxa de ligação existente do número e as mensagens que chegam a um grupo são gratuitas.

As respostas da IA num grupo custam os mesmos créditos que qualquer outra resposta da IA. Isto também se aplica a um número com IA Ilimitada: a IA Ilimitada cobre os chats individuais do número, não as respostas em grupos.

Uma mensagem que envia num grupo conta como uma mensagem para o limite diário de envio do número, independentemente do número de membros que o grupo tenha.

---

## Resolução de Problemas

### Falta um grupo na lista

Clique em **Atualizar grupos** na secção Grupos do número. A lista apenas mostra os grupos em que o número se encontra atualmente. Um grupo que o seu número abandonou apresenta **Saiu**.

### Não consigo ativar a opção Mostrar na caixa de entrada

Já está a mostrar 25 grupos neste número. Oculte um para mostrar outro.

### A IA não responde num grupo

Verifique, por esta ordem:

1. A **IA** do grupo está definida como **Quando mencionado**.
2. Um agente tem um ponto de entrada de **Grupos WhatsApp** que abrange este grupo e a regra está ativada.
3. O membro mencionou o seu número ou respondeu a uma das mensagens da IA. Uma mensagem simples no grupo é ignorada propositadamente.
4. O membro não está silenciado, o grupo tem 500 membros ou menos e a IA não atingiu os seus limites para esse membro ou grupo (ver acima).

Se a opção **IA** não aparecer de todo, é porque ainda não foi ativada para a sua conta.

---

## Relacionado

- [WhatsApp Web](whatsapp-web.md): ligação do número, limites de envio e aquecimento.
- [Pontos de Entrada](../ai-agents/entry-points.md): como os agentes são escolhidos para cada canal.
- [Registo de Erros](../settings/error-log.md#app-3314): a nota apresentada quando uma mensagem de grupo não foi dirigida à IA.
