Login Cadastre-se

Criar grupo

Endpoint: POST https://croncrm.com/api/v2/groups/create

Crie um grupo no WhatsApp.

Header do request
Atributo Descrição Obrigatório Tipo

apiKey

Informe sua API Key gerada na interface do CRONCRM.

Sim

String
Body do request
Atributo Descrição Obrigatório Tipo

name

Nome do grupo.

Sim

String

participants

WIDs dos participantes separados por ;

Sim

String

description

Descrição do grupo.

Não

String

announce

Apenas admins podem enviar (0/1).

Não

0|1

restrict

Apenas admins podem editar info (0/1).

Não

0|1

ephemeral_duration

Mensagens temporárias (0/1).

Não

0|1

profile_picture

URL da foto do grupo.

Não

String (URL)

 
{
  "name": "Equipe Vendas",
  "participants": "[email protected];[email protected]",
  "description": "Canal oficial",
  "announce": 0,
  "restrict": 0,
  "ephemeral_duration": 0
}
Response do request

Em caso de sucesso, retorna HTTP 201 com success true. Se name ou participants não forem informados, retorna 422. Se announce, restrict ou ephemeral_duration forem diferentes de 0 ou 1, retorna 422. Se algum participante for inválido, retorna 422. Método incorreto retorna 405; falhas inesperadas retornam 500.

Atributo Descrição Tipo

success

Informa se a operação teve sucesso ou não.

Boolean

msg

Mensagem de retorno.

String

group

Dados do grupo criado.

Array

 
{
  "success": true,
  "msg": "Seu grupo foi criado com sucesso.",
  "group": {
    "wid": "[email protected]",
    "wuser": "1203630...",
    "wserver": "g.us",
    "description": "Canal oficial",
    "announce": false,
    "restrict": false,
    "ephemeral_duration": false,
    "profile_picture": null,
    "participants": [
      "[email protected]",
      "[email protected]"
    ],
    "fail_add_participants": []
  }
}
 
<?php
$apiKey = 'SEU_API_KEY';
$url = 'https://croncrm.com/api/v2/groups/create';

$payload = [
    'name' => 'Equipe Vendas',
    'participants' => '[email protected];[email protected]',
    'description' => 'Canal oficial',
    'announce' => 0,
    'restrict' => 0,
    'ephemeral_duration' => 0,
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'apiKey: ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE),
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);
curl_close($ch);

if ($error) {
    throw new RuntimeException($error);
}

echo "HTTP {$httpCode}\n";
echo $response;
?>
curl -X POST \
  'https://croncrm.com/api/v2/groups/create' \
  -H 'apiKey: SEU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Equipe Vendas","participants":"[email protected];[email protected]"}'