Skip to main content
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:
FormatoExemploDestino
Número com DDI554499999999Conversa individual
JID de grupo120363123456789@g.usGrupo do WhatsApp
Para obter o JID do grupo, use o endpoint Criar grupo (que retorna o groupId) ou Metadados do grupo.

​
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: 
{
  "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: 
{
  "phone": "120363123456789@g.us",
  "message": "Atenção todos!",
  "mentionsEveryOne": true
}
mentionsEveryOne busca a lista de participantes do grupo automaticamente. Em grupos grandes, isso pode adicionar um pequeno delay ao envio.

​
Exemplos por tipo de mensagem

​
Texto em grupo

POST /instances/{instanceId}/token/{instanceToken}/send-text

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

​
Imagem em grupo

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

POST /instances/{instanceId}/token/{instanceToken}/send-document/pdf

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

​
Enquete em grupo

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.