Grupos do WhatsApp
Crie grupos, gerencie participantes, convites e configurações. O identificador de grupo termina em @g.us.
POSTNovo grupo
/group/create/:instance
Cria um grupo com os participantes informados.
subjectstringObrigatório- Nome do grupo.
descriptionstringOpcional- Descrição (até 2048). Se falhar, o grupo é criado e a resposta traz warning.
participantsstring[]Obrigatório- Números com DDI.
curl -X POST https://api.connectdm.app/group/create/loja \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"subject": "Clientes VIP",
"participants": [
"5511999998888"
]
}'POSTRenomear grupo
/group/updateGroupSubject/:instance
Troca o nome do grupo.
groupJidqueryObrigatório- Identificador do grupo, terminado em @g.us.
subjectstringObrigatório- Novo nome.
curl -X POST https://api.connectdm.app/group/updateGroupSubject/loja?groupJid=1203630000%40g.us \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"subject": "Clientes VIP 2026"
}'POSTTrocar imagem do grupo
/group/updateGroupPicture/:instance
Troca a foto do grupo.
groupJidqueryObrigatório- Identificador do grupo, terminado em @g.us.
imagestringObrigatório- URL pública da imagem.
curl -X POST https://api.connectdm.app/group/updateGroupPicture/loja?groupJid=1203630000%40g.us \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"image": "https://exemplo.com/logo.png"
}'POSTEditar descrição
/group/updateGroupDescription/:instance
Troca a descrição.
groupJidqueryObrigatório- Identificador do grupo, terminado em @g.us.
descriptionstringObrigatório- Nova descrição.
curl -X POST https://api.connectdm.app/group/updateGroupDescription/loja?groupJid=1203630000%40g.us \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"description": "Avisos e promoções."
}'GETDetalhes do grupo
/group/findGroupInfos/:instance
Dados de um grupo e seus participantes.
groupJidqueryObrigatório- Identificador do grupo, terminado em @g.us.
curl -X GET https://api.connectdm.app/group/findGroupInfos/loja?groupJid=1203630000%40g.us \
-H "apikey: sk_live_SUA_CHAVE"GETGrupos do número
/group/fetchAllGroups/:instance
Todos os grupos em que o número participa.
curl -X GET https://api.connectdm.app/group/fetchAllGroups/loja \
-H "apikey: sk_live_SUA_CHAVE"GETQuem está no grupo
/group/participants/:instance
Participantes e administradores.
groupJidqueryObrigatório- Identificador do grupo, terminado em @g.us.
curl -X GET https://api.connectdm.app/group/participants/loja?groupJid=1203630000%40g.us \
-H "apikey: sk_live_SUA_CHAVE"GETLink de convite
/group/inviteCode/:instance
Link de convite atual do grupo.
groupJidqueryObrigatório- Identificador do grupo, terminado em @g.us.
curl -X GET https://api.connectdm.app/group/inviteCode/loja?groupJid=1203630000%40g.us \
-H "apikey: sk_live_SUA_CHAVE"POSTConvidar por mensagem
/group/sendInvite/:instance
Manda o link de convite para números.
groupJidstringObrigatório- Identificador do grupo, terminado em @g.us.
numbersstring[]Obrigatório- Destinatários.
descriptionstringOpcional- Texto que acompanha o link.
curl -X POST https://api.connectdm.app/group/sendInvite/loja \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"groupJid": "[email protected]",
"numbers": [
"5511999998888"
],
"description": "Entre no grupo!"
}'POSTAdicionar, remover e promover
/group/updateParticipant/:instance
Muda quem participa do grupo e quem é admin, em lote.
groupJidqueryObrigatório- Identificador do grupo, terminado em @g.us.
actionstringObrigatório- O que fazer: add, remove, promote (vira admin) ou demote (deixa de ser admin).
participantsstring[]Obrigatório- Números com DDI.
curl -X POST https://api.connectdm.app/group/updateParticipant/loja?groupJid=1203630000%40g.us \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"action": "add",
"participants": [
"5511999998888"
]
}'POSTQuem pode enviar e editar
/group/updateSetting/:instance
Quem pode enviar mensagens e editar dados do grupo.
groupJidqueryObrigatório- Identificador do grupo, terminado em @g.us.
actionstringObrigatório- "announcement", "not_announcement", "locked" ou "unlocked".
curl -X POST https://api.connectdm.app/group/updateSetting/loja?groupJid=1203630000%40g.us \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"action": "announcement"
}'POSTMensagens que somem
/group/toggleEphemeral/:instance
Liga ou desliga mensagens temporárias.
groupJidqueryObrigatório- Identificador do grupo, terminado em @g.us.
expirationnumberObrigatório- Segundos: 0 (desliga), 86400, 604800 ou 7776000.
curl -X POST https://api.connectdm.app/group/toggleEphemeral/loja?groupJid=1203630000%40g.us \
-H "apikey: sk_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"expiration": 604800
}'DELETEDeixar o grupo
/group/leaveGroup/:instance
O número sai do grupo.
groupJidqueryObrigatório- Identificador do grupo, terminado em @g.us.
curl -X DELETE https://api.connectdm.app/group/leaveGroup/loja?groupJid=1203630000%40g.us \
-H "apikey: sk_live_SUA_CHAVE"