Criando grupos – Central de Atendimento

Este método é responsável por criar um grupo com seus respectivos participantes. Infelizmente não é possível criar o grupo com imagem, mas você pode logo após a criação utilizar-se do método Update-group-photo que está nesta mesma sessão.

/create-group

Tipo	URL
`POST`	https://api.plugzapi.com.br/instances/SUA_INSTANCIA/token/SEU_TOKEN/create-group

DICA
Assim como no WhatsappWeb você vai precisar adicionar ao menos um contato para conseguir criar um grupo.

ATENÇÃO!
No dia 4 de novembro de 2021 o whatsapp alterou a formato da criação de novos grupos, antes: "phone": "5511999999999-1623281429" agora: "phone": "120363019502650977-group"

Novo atributo
Recentemente, o WhatsApp implementou uma validação para verificar se o número de telefone conectado à API possui o contato do cliente salvo. No entanto, o PlugMessage desenvolveu uma solução para contornar essa validação, introduzindo um novo recurso chamado "autoInvite". Agora, quando uma solicitação é enviada para adicionar 10 clientes a um grupo e apenas 5 deles são adicionados com sucesso, a API envia convites privados para os cinco clientes que não foram adicionados. Esses convites permitem que eles entrem no grupo, mesmo que seus números de telefone não estejam salvos como contatos.

Atributos obrigatórios

Atributos	Tipo	Descrição
autoInvite	boolean	true ou false (Envia link de convite do grupo no privado)
groupName	string	Nome do grupo a ser criado
phones	array string	Array com os números a serem adicionados no grupo

Request Body:

{
"groupName": "Meu grupo no PlugMessage",
"phones": ["5511999999999", "5511888888888"]
}

Response

200

Atributos	Tipo	Descrição
phone	string	ID/Fone do grupo
invitationLink	string	link para entrar no grupo

Exemplo:

Forma antiga -
{
"phone": "5511999999999-1623281429",
"invitationLink": "https://chat.whatsapp.com/DCaqftVlS6dHWtlvfd3hUa"
}

------------------------------------------------

Forma nova
{
"phone": "120363019502650977-group",
"invitationLink": "https://chat.whatsapp.com/GONwbGGDkLe8BifUWwLgct"
}

405

Neste caso certifique que esteja enviando o corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no início deste tópico.

415

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json"

Alguns exemplos para auxiliar a implementação

Exemplo em C#

var client = new RestClient("https://api.plugzapi.com.br/instances/SUA_INSTANCIA/token/SEU_TOKEN/creat-group");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddParameter("undefined", "{\"groupName\": \"Meu grupo PlugMessage\", \"phones\": [\"5511999999999\",\"5511888888888\"], \"profileImage\": \"https://www.plugzapi.com.br/wp-content/themes/PlugMessage/dist/images/logo.svg\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

Exemplo em PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.plugzapi.com.br/instances/SUA_INSTANCIA/token/SEU_TOKEN/creat-group",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{\"groupName\": \"Meu grupo PlugMessage\", \"phones\": [\"5511999999999\",\"5511888888888\"], \"profileImage\": \"https://www.plugzapi.com.br/wp-content/themes/PlugMessage/dist/images/logo.svg\"}",
CURLOPT_HTTPHEADER => array(
"content-type: application/json"
),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo"cURL Error #:" . $err;
} else {
echo $response;
}

Exemplo em Node.js

var http = require("https");

var options = {
"method": "POST",
"hostname": "api.plugzapi.com.br",
"port": null,
"path": "/instances/SUA_INSTANCIA/token/SEU_TOKEN/creat-group",
"headers": {}
};

var req = http.request(options, function (res) {
var chunks = [];

res.on("data", function (chunk) {
chunks.push(chunk);
});

res.on("end", function () {
var body = Buffer.concat(chunks);
console.log(body.toString());
});
});

req.write(JSON.stringify({
groupName: 'Meu grupo PlugMessage',
phones: ['5511999999999', '5511888888888'],
profileImage: 'https://www.plugzapi.com.br/wp-content/themes/PlugMessage/dist/images/logo.svg'
}));
req.end();

/create-group

Request Body:

Response

Artigos relacionados