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

# Envie Mensagens para Grupos do WhatsApp via API

> Envie texto, arquivos via upload multipart ou arquivos via URL diretamente para um grupo do WhatsApp usando a API externa do PanÐá Zap.

Estes endpoints enviam mensagens diretamente para um **grupo** do WhatsApp em vez de um contato individual. A mecânica é a mesma dos endpoints de [Enviar Mensagens](/api/send-messages), mas o campo `number` carrega o **ID do grupo** em vez de um número de telefone, e as rotas usam um sufixo dedicado.

Todas as requisições exigem o cabeçalho `Authorization: Bearer {BearerToken}`.

<Note>
  Estes endpoints **enviam mensagens** para um grupo já existente. Para criar grupos, adicionar/remover participantes, alterar título, descrição, foto ou gerenciar links de convite, use a página [Grupos do WhatsApp](/api/whatsapp-groups).
</Note>

***

## O Campo `number` para Grupos

Em todos os endpoints abaixo, o campo `number` recebe o **ID do grupo** do WhatsApp — não um número de telefone. Você pode obter o ID de um grupo através do endpoint [ListGroupsInfo](/api/whatsapp-groups#listar-grupos-com-participantes) ou de um payload de webhook recebido daquele grupo.

***

## Enviar Texto para um Grupo

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/group
```

```json theme={null}
{
  "body": "A mensagem desejada",
  "number": "12356818915189153",
  "externalKey": "ID_UNICA_DO_SISTEMA_CLIENTE_PARA_EXECUTAR_UMA_ACAO_COM_WEBHOOK",
  "isClosed": false
}
```

| Campo         | Tipo    | Obrigatório | Descrição                                                                    |
| ------------- | ------- | ----------- | ---------------------------------------------------------------------------- |
| `body`        | string  | Sim         | Texto da mensagem que será enviada ao grupo.                                 |
| `number`      | string  | Sim         | ID do grupo do WhatsApp de destino.                                          |
| `externalKey` | string  | Não         | Chave única do seu sistema para deduplicação e correlação com webhooks.      |
| `isClosed`    | boolean | Não         | Define se o ticket do grupo será fechado logo após o envio. Padrão: `false`. |

***

## Enviar Arquivo para um Grupo via Upload Multipart

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/group
Content-Type: multipart/form-data
```

| Campo do Formulário | Tipo    | Obrigatório | Descrição                                                     |
| ------------------- | ------- | ----------- | ------------------------------------------------------------- |
| `media`             | arquivo | Sim         | Arquivo (ou arquivos) a ser enviado — imagem, documento, etc. |
| `body`              | string  | Não         | Texto que acompanhará o arquivo.                              |
| `number`            | string  | Sim         | ID do grupo do WhatsApp de destino.                           |
| `externalKey`       | string  | Não         | Chave única do sistema para identificação/deduplicação.       |
| `isClosed`          | boolean | Não         | Define se o ticket será fechado após o envio.                 |

***

## Enviar Arquivo para um Grupo via URL

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/groupMediaUrl
```

```json theme={null}
{
  "mediaUrl": "https://exemplo.com/imagem.png",
  "body": "A mensagem desejada",
  "number": "12356818915189153",
  "externalKey": "ID_UNICA_DO_SISTEMA_CLIENTE_PARA_EXECUTAR_UMA_ACAO_COM_WEBHOOK",
  "isClosed": false
}
```

| Campo         | Tipo    | Obrigatório | Descrição                                                                                                                                |
| ------------- | ------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `mediaUrl`    | string  | Sim         | URL de acesso público do arquivo a ser enviado. Deve usar `http` ou `https`; redirecionamentos e hosts internos/privados são bloqueados. |
| `body`        | string  | Não         | Legenda que acompanhará o arquivo.                                                                                                       |
| `number`      | string  | Sim         | ID do grupo do WhatsApp de destino.                                                                                                      |
| `externalKey` | string  | Não         | Chave única do sistema para identificação/deduplicação.                                                                                  |
| `isClosed`    | boolean | Não         | Define se o ticket será fechado após o envio.                                                                                            |

***

## Resposta de Sucesso

```json theme={null}
{
  "success": true,
  "data": {
    "message": "Message sent successfully",
    "ticketId": 123
  }
}
```

| Campo           | Tipo    | Descrição                                                        |
| --------------- | ------- | ---------------------------------------------------------------- |
| `success`       | boolean | `true` quando a mensagem foi aceita para entrega.                |
| `data.message`  | string  | Confirmação legível por humanos.                                 |
| `data.ticketId` | integer | ID do ticket (conversa de grupo) na qual a mensagem foi enviada. |