Envie Mensagens para Grupos do WhatsApp via API

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, 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}.

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.

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 ou de um payload de webhook recebido daquele grupo.

Enviar Texto para um Grupo

POST https://{BaseUrl}/v2/api/external/{ApiID}/group

{
  "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

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

POST https://{BaseUrl}/v2/api/external/{ApiID}/groupMediaUrl

{
  "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

{
  "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.

Primeiros Passos

Mensagens

Mensagens Interativas

Tickets e Contatos

Campanhas e CRM

Canais e Recursos

Organização e Produtividade

Dados e Relatórios

Administração da Plataforma

Webhooks e Eventos

Envie Mensagens para Grupos do WhatsApp via API

O Campo `number` para Grupos

Enviar Texto para um Grupo

Enviar Arquivo para um Grupo via Upload Multipart

Enviar Arquivo para um Grupo via URL

Resposta de Sucesso

​O Campo number para Grupos

​Enviar Texto para um Grupo

​Enviar Arquivo para um Grupo via Upload Multipart

​Enviar Arquivo para um Grupo via URL

​Resposta de Sucesso

O Campo `number` para Grupos

Enviar Texto para um Grupo

Enviar Arquivo para um Grupo via Upload Multipart

Enviar Arquivo para um Grupo via URL

Resposta de Sucesso