Promover/Remover administradores

Endpoint: PUT https://croncrm.com/api/v2/groups/promote-demote-admins

Promova ou remova administradores de um grupo.

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

chat_wid

WID do grupo.

Sim

String

contact_wid

WID do contato.

Sim

String

type

Operação a executar.

Valores aceitos: promote (promove o contato informado a administrador do grupo); demote (remove o contato informado da lista de administradores do grupo).

Observação: envie exatamente promote ou demote (string em lowercase).

Sim

String

{
  "chat_wid": "[email protected]",
  "contact_wid": "[email protected]",
  "type": "promote"
}
Response do request

Em caso de sucesso, retorna HTTP 200 com success true. Se chat_wid, contact_wid ou type não forem informados/forem inválidos, retorna 422. Se chat_wid ou contact_wid forem inválidos, retorna 400. Se o grupo não for encontrado, retorna 404. 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

{
  "success": true,
  "msg": "Administrador promovido com sucesso."
}
<?php
$apiKey = 'SEU_API_KEY';
$url = 'https://croncrm.com/api/v2/groups/promote-demote-admins';

$payload = [
    'chat_wid' => '[email protected]',
    'contact_wid' => '[email protected]',
    'type' => 'promote',
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PUT',
    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 PUT \
  'https://croncrm.com/api/v2/groups/promote-demote-admins' \
  -H 'apiKey: SEU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"chat_wid":"[email protected]","contact_wid":"[email protected]","type":"promote"}'