Login Cadastre-se

Criar canal

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

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

apiKey

Informe sua API Key gerada na interface do CRONCRM.

Sim

String
Body do request

name (obrigatório), opcionais: webhooks (message, incomingCall, stateChanged, qrcode, liveLocation, participantsChanged, addedToGroup)

Atributo Descrição Obrigatório Tipo

name

Nome do canal.

Sim

String

webhookMessage

URL do webhook para mensagens.

Não

String

webhookIncomingCall

URL do webhook para chamadas recebidas.

Não

String

webhookStateChanged

URL do webhook para mudanças de estado.

Não

String

webhookQrcode

URL do webhook para QR Code.

Não

String

webhookLiveLocation

URL do webhook para localização ao vivo.

Não

String

webhookParticipantsChanged

URL do webhook para mudanças de participantes.

Não

String

webhookAddedToGroup

URL do webhook para eventos de adição em grupo.

Não

String

 
{
  "name": "Canal 1",
  "webhookMessage": "https://meuservidor.com/webhooks/message"
}
Response do request

Em caso de sucesso, retorna HTTP 200 com success true. Se name não for informado, retorna 400. Se a empresa já tiver atingido o limite de canais do plano, retorna 400. Se algum webhook informado for inválido, retorna 400. 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

instance

Dados do canal criado.

name: (String) Nome do canal.

created: (String) Data de criação do canal.

modified: (String) Data da última alteração do canal.

type: (Object) Tipo do canal (code/name).

api_enable: (Boolean) Indica se a API está habilitada.

have_external_chatbot: (Boolean) Indica se possui chatbot externo.

in_log: (Boolean) Indica se está em log.

improved_synchronization: (Boolean) Indica se a sincronização aprimorada está habilitada.

webhooks: (Object) URLs de webhooks (message, incomingCall, stateChanged, qrcode, liveLocation, participantsChanged, addedToGroup).

api_key: (String) API Key do canal.

access_token: (String) Token do canal.

Object

 
{
  "success": true,
  "msg": "Seu canal foi criado com sucesso.",
  "instance": {
    "name": "Canal 1",
        "created": "01/01/2026 10:00:00",
        "modified": "01/01/2026 10:00:00",
        "type": {
            "code": 1,
            "name": "Desconhecido"
        },
        "api_enable": true,
        "have_external_chatbot": true,
        "in_log": false,
        "improved_synchronization": true,
        "webhooks": {
            "message": "https://meuservidor.com/webhooks/message",
            "incomingCall": "",
            "stateChanged": "",
            "qrcode": "",
            "liveLocation": "",
            "participantsChanged": "",
            "addedToGroup": ""
        },
        "api_key": "API_KEY",
        "access_token": "INSTANCE_TOKEN"
  }
}
 
<?php
$apiKey = 'SEU_API_KEY';
$url = 'https://croncrm.com/api/v2/instances/create';

$payload = [
    'name' => 'Canal 1',
    'webhookMessage' => 'https://meuservidor.com/webhooks/message',
];

$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/instances/create' \
  -H 'apiKey: SEU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Canal 1","webhookMessage":"https://meuservidor.com/webhooks/message"}'