> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ezapi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Mensagens em grupo

> Envie mensagens de texto, mídia e interativos para grupos do WhatsApp.

Todos os endpoints de envio da seção **Mensagens** suportam envio para grupos do WhatsApp. Basta usar o **JID do grupo** no campo `phone`.

## Como funciona

O campo `phone` aceita dois formatos:

| Formato        | Exemplo                | Destino             |
| -------------- | ---------------------- | ------------------- |
| Número com DDI | `554499999999`         | Conversa individual |
| JID de grupo   | `120363123456789@g.us` | Grupo do WhatsApp   |

<Note>Para obter o JID do grupo, use o endpoint [Criar grupo](/api-reference/groups/create) (que retorna o `groupId`) ou [Metadados do grupo](/api-reference/groups/metadata).</Note>

## Menções em grupo

Ao enviar mensagens para grupos, você pode mencionar participantes:

### Mencionar participantes específicos

Use o campo `mentioned` com uma lista de números:

```json theme={null}
{
  "phone": "120363123456789@g.us",
  "message": "Olá @554499999999 e @554488888888!",
  "mentioned": ["554499999999", "554488888888"]
}
```

### Mencionar todos os participantes

Use `mentionsEveryOne: true` para mencionar todos os membros do grupo:

```json theme={null}
{
  "phone": "120363123456789@g.us",
  "message": "Atenção todos!",
  "mentionsEveryOne": true
}
```

<Warning>`mentionsEveryOne` busca a lista de participantes do grupo automaticamente. Em grupos grandes, isso pode adicionar um pequeno delay ao envio.</Warning>

## Exemplos por tipo de mensagem

### Texto em grupo

```json theme={null}
POST /instances/{instanceId}/token/{instanceToken}/send-text

{
  "phone": "120363123456789@g.us",
  "message": "Olá grupo!",
  "delayMessage": 1000
}
```

### Imagem em grupo

```json theme={null}
POST /instances/{instanceId}/token/{instanceToken}/send-image

{
  "phone": "120363123456789@g.us",
  "image": "https://example.com/image.jpg",
  "caption": "Imagem para o grupo",
  "mentioned": ["554499999999"]
}
```

### Documento em grupo

```json theme={null}
POST /instances/{instanceId}/token/{instanceToken}/send-document/pdf

{
  "phone": "120363123456789@g.us",
  "document": "https://example.com/relatorio.pdf",
  "fileName": "relatorio.pdf"
}
```

### Enquete em grupo

```json theme={null}
POST /instances/{instanceId}/token/{instanceToken}/send-poll

{
  "phone": "120363123456789@g.us",
  "message": "Qual a melhor opção?",
  "poll": ["Opção A", "Opção B", "Opção C"],
  "pollMaxOptions": 1
}
```

## Compatibilidade

Todos os tipos de mensagem suportam envio para grupos:

* Texto (`send-text`)
* Imagem (`send-image`)
* Áudio (`send-audio`)
* Vídeo (`send-video`)
* PTV (`send-ptv`)
* Documento (`send-document`)
* Sticker (`send-sticker`)
* GIF (`send-gif`)
* Localização (`send-location`)
* Contato (`send-contact` / `send-contacts`)
* Link (`send-link`)
* Enquete (`send-poll`)
* Botões (`send-button-actions`, `send-button-list`, etc.)
* Reação (`send-reaction`)

Os campos `mentioned` e `mentionsEveryOne` são opcionais e podem ser usados em qualquer tipo de mensagem enviada para grupos.