Login Cadastre-se

Alterar funil

Endpoint: PUT https://croncrm.com/api/v2/funnels/change

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

apiKey

Informe sua API Key gerada na interface do CRONCRM.

Sim

String
Body do request

access_token (obrigatório), name (opcional), description (opcional)

Atributo Descrição Obrigatório Tipo

access_token

Token do funil.

Sim

String

name

Novo nome do funil.

Não

String

description

Nova descrição do funil.

Não

String

 
{
  "access_token": "FUNNEL_TOKEN",
  "name": "Vendas (Atualizado)",
  "description": "Novo texto de descrição"
}
Response do request

Em caso de sucesso, retorna HTTP 200 com success true. Se access_token não for informado, retorna 400. Se já existir um funil com esse nome, retorna 400. Se não encontrar o funil pelo access_token, 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

funnel

Dados do funil alterado.

name: (String) Nome do funil.

description: (String) Descrição do funil.

access_token: (String) Token do funil.

Object

 
{
  "success": true,
  "msg": "Seu funil foi alterado com sucesso.",
  "funnel": {
    "name": "Vendas (Atualizado)",
    "description": "Novo texto de descrição",
    "access_token": "FUNNEL_TOKEN"
  }
}
 
<?php
$apiKey = 'SEU_API_KEY';
$url = 'https://croncrm.com/api/v2/funnels/change';

$payload = [
    'access_token' => 'FUNNEL_TOKEN',
    'name' => 'Vendas (Atualizado)',
    'description' => 'Novo texto de descrição',
];

$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/funnels/change' \
  -H 'apiKey: SEU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"access_token":"FUNNEL_TOKEN","name":"Vendas (Atualizado)","description":"Novo texto de descrição"}'