curl -X POST https://zapclass.com.br/api/groups/create \
-H "Content-Type: application/json" \
-H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
-d '{
"name": "Equipe de Vendas",
"participants": ["5511999999999", "5511888888888"]
}'
const response = await fetch("https://zapclass.com.br/api/groups/create", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP",
},
body: JSON.stringify({
name: "Equipe de Vendas",
participants: ["5511999999999", "5511888888888"],
}),
});
const data = await response.json();
if (data.success) {
console.log("Grupo criado:", data.group.name);
console.log("ID do grupo:", data.group.id);
console.log("Participantes adicionados:", data.participants.success.length);
}
<?php
$ch = curl_init('https://zapclass.com.br/api/groups/create');
$payload = [
"name" => "Equipe de Vendas",
"participants" => ["5511999999999", "5511888888888"]
];
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);
if ($data['success']) {
echo "Grupo criado: {$data['group']['name']}\n";
echo "ID: {$data['group']['id']}\n";
echo "Participantes adicionados: " . count($data['participants']['success']);
} else {
echo "Erro: " . $data['message'];
}
curl_close($ch);
?>
{
"success": true,
"message": "Group created successfully",
"group": {
"id": "120363123456789012@g.us",
"name": "Equipe de Vendas",
"timestamp": 1672531200000,
"creator": "5511999999999@s.whatsapp.net"
},
"participants": {
"success": ["5511999999999@s.whatsapp.net", "5511888888888@s.whatsapp.net"],
"failed": []
}
}
{
"success": false,
"message": "Nome do grupo é obrigatório"
}
Grupos
Criar Grupo
Criar um novo grupo no WhatsApp com participantes iniciais
POST
/
groups
/
create
curl -X POST https://zapclass.com.br/api/groups/create \
-H "Content-Type: application/json" \
-H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
-d '{
"name": "Equipe de Vendas",
"participants": ["5511999999999", "5511888888888"]
}'
const response = await fetch("https://zapclass.com.br/api/groups/create", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP",
},
body: JSON.stringify({
name: "Equipe de Vendas",
participants: ["5511999999999", "5511888888888"],
}),
});
const data = await response.json();
if (data.success) {
console.log("Grupo criado:", data.group.name);
console.log("ID do grupo:", data.group.id);
console.log("Participantes adicionados:", data.participants.success.length);
}
<?php
$ch = curl_init('https://zapclass.com.br/api/groups/create');
$payload = [
"name" => "Equipe de Vendas",
"participants" => ["5511999999999", "5511888888888"]
];
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);
if ($data['success']) {
echo "Grupo criado: {$data['group']['name']}\n";
echo "ID: {$data['group']['id']}\n";
echo "Participantes adicionados: " . count($data['participants']['success']);
} else {
echo "Erro: " . $data['message'];
}
curl_close($ch);
?>
{
"success": true,
"message": "Group created successfully",
"group": {
"id": "120363123456789012@g.us",
"name": "Equipe de Vendas",
"timestamp": 1672531200000,
"creator": "5511999999999@s.whatsapp.net"
},
"participants": {
"success": ["5511999999999@s.whatsapp.net", "5511888888888@s.whatsapp.net"],
"failed": []
}
}
{
"success": false,
"message": "Nome do grupo é obrigatório"
}
Cria um novo grupo no WhatsApp adicionando participantes iniciais e configurando as informações básicas do grupo.
Detalhes de Criação
Processo de Criação
Processo de Criação
O grupo é criado com você como administrador e os participantes iniciais.Etapas:
- Validação dos participantes fornecidos
- Criação do grupo no WhatsApp
- Adição automática dos participantes
- Configuração de permissões iniciais
- Retorno das informações do grupo
Requisitos de Participantes
Requisitos de Participantes
Regras para adicionar participantes ao grupo.Requisitos:
- Mínimo de 1 participante além do criador
- Números devem estar no formato internacional
- Apenas dígitos, sem símbolos ou formatação
- Participantes devem ter WhatsApp ativo
- Não podem estar bloqueando você
5511999999999 (código país + DDD + número)Resposta Detalhada
Resposta Detalhada
A resposta inclui informações completas sobre o grupo criado.Dados retornados:
- ID do grupo (JID)
- Nome do grupo
- Lista de participantes adicionados com sucesso
- Lista de participantes que falharam (se houver)
- Timestamp de criação
- Status de cada operação
Limitações e Comportamento
Limitações e Comportamento
Restrições aplicadas durante a criação.Limitações:
- Mínimo: 1 participante além do criador
- Máximo: 1024 participantes (limite do WhatsApp)
- Nome do grupo: máximo 25 caracteres
- Participantes inválidos não impedem a criação
Authorization
string
required
Chave de autenticação da sua conexão, utilizada no header Authorization como
Bearer Token.
Você encontra sua API Key no botão API da sua conexão no painel ZapClass.
A chave sempre começa com o prefixo
Exemplo:
Você encontra sua API Key no botão API da sua conexão no painel ZapClass.
A chave sempre começa com o prefixo
zc_. Exemplo:
zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aPBody Parameters
string
required
Nome do grupo.
Máximo de 25 caracteres.
Exemplo:
Máximo de 25 caracteres.
Exemplo:
"Equipe de Vendas 2024"array
required
Lista de números de telefone dos participantes iniciais.
Formato internacional, apenas dígitos.
Mínimo de 1 participante.
Exemplo:
Formato internacional, apenas dígitos.
Mínimo de 1 participante.
Exemplo:
["5511999999999", "5511888888888"]Dica: Mesmo que alguns participantes falhem ao serem adicionados, o grupo
será criado. Verifique a resposta para identificar quais participantes foram
adicionados com sucesso.
curl -X POST https://zapclass.com.br/api/groups/create \
-H "Content-Type: application/json" \
-H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
-d '{
"name": "Equipe de Vendas",
"participants": ["5511999999999", "5511888888888"]
}'
const response = await fetch("https://zapclass.com.br/api/groups/create", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP",
},
body: JSON.stringify({
name: "Equipe de Vendas",
participants: ["5511999999999", "5511888888888"],
}),
});
const data = await response.json();
if (data.success) {
console.log("Grupo criado:", data.group.name);
console.log("ID do grupo:", data.group.id);
console.log("Participantes adicionados:", data.participants.success.length);
}
<?php
$ch = curl_init('https://zapclass.com.br/api/groups/create');
$payload = [
"name" => "Equipe de Vendas",
"participants" => ["5511999999999", "5511888888888"]
];
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);
if ($data['success']) {
echo "Grupo criado: {$data['group']['name']}\n";
echo "ID: {$data['group']['id']}\n";
echo "Participantes adicionados: " . count($data['participants']['success']);
} else {
echo "Erro: " . $data['message'];
}
curl_close($ch);
?>
{
"success": true,
"message": "Group created successfully",
"group": {
"id": "120363123456789012@g.us",
"name": "Equipe de Vendas",
"timestamp": 1672531200000,
"creator": "5511999999999@s.whatsapp.net"
},
"participants": {
"success": ["5511999999999@s.whatsapp.net", "5511888888888@s.whatsapp.net"],
"failed": []
}
}
{
"success": false,
"message": "Nome do grupo é obrigatório"
}
⌘I

