Disconnecting chat channel
Method
DELETE https://amojo.kommo.com/v2/origin/custom/{channel.id}/disconnect
Description
After disconnecting the channel, you will stop receiving webhooks for outgoing messages.
The “initiate conversation” option will also be disabled in the lead card (upon the expiration of the UI/UX cache)
Headers & Authorization type
The request headers are the same as the ones for all Chat API requests. Information about them is explained in details in the connect a chat channel page.
Header | Description |
---|---|
Date | Date and time when the request was generated. |
Content-type | Request data type. |
Content-MD5 | For the request body |
X-Signature | Signature of the request as a string. |
Example of the body
{
"account_id": "52fd2a28-d2eb-4bd8-b862-a67934927b38"
}
Body parameters
Parameter | Data type | Description |
---|---|---|
account_id | string | amojo_id of the account |
Note: You should write the body in your request exactly the same as written when calculating the headers.
Example in PHP
$secret = 'fb50586ff7b68cd831fe0ef356345903f644c0d2';
$method = 'DELETE';
$contentType = 'application/json';
$date = date(DateTimeInterface::RFC2822);// in format "Wed, 30 Nov 2022 16:33:21 +0000";
$path = '/v2/origin/custom/f62a0162-46a7-430e-b06c-0ef798d56b21/disconnect';
$url = "https://amojo.kommo.com" . $path;
$body = [
'account_id' => '52fd2a28-d2eb-4bd8-b862-a67934927b38'
];
$requestBody = json_encode($body);
$checkSum = md5($requestBody);
$str = implode("\n", [
strtoupper($method),
$checkSum,
$contentType,
$date,
$path,
]);
$signature = hash_hmac('sha1', $str, $secret);
$headers = [
'Date' => $date,
'Content-Type' => $contentType,
'Content-MD5' => strtolower($checkSum),
'X-Signature' => strtolower($signature),
];
$curlHeaders = [];
foreach ($headers as $name => $value) {
$curlHeaders[] = $name . ": " . $value;
}
echo $method . ' ' . $url . PHP_EOL;
foreach ($curlHeaders as $header) {
echo $header . PHP_EOL;
}
echo PHP_EOL . $requestBody . PHP_EOL;
Example of the cURL request
curl --location --request DELETE 'https://amojo.kommo.com/v2/origin/custom/f62a0162-46a7-430e-b06c-0ef798d56b21/disconnect' \
--header 'Date: Wed, 30 Nov 2022 16:33:21 +0000' \
--header 'Content-type: application/json' \
--header 'Content-MD5: 2a3c7cd98696c0388111e2d6b2b694d0' \
--header 'X-Signature: 7a9ce132fff0315dc4b99ce9b2c69bb2dfdb6404' \
--data-raw '{"account_id":"52fd2a28-d2eb-4bd8-b862-a67934927b38"}'
HTTP response codes.
Response code | Case |
---|---|
200 | Channel disconnected successfully |
404 | Channel does not exist |
403 | Incorrect request signature |
400 | Invalid data given. Details are available in the request response |
Response
This method doesn’t return output.