Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Получить статус звонка getStatus». Вы узнаете экспертные методики работы с получить статус и научитесь избегать типичных ошибок начинающих разработчиков.
Получить статус звонка getStatus
Тут может не хватать некоторых данных — дополним в ближайшее время
- уточнить права и скоуп
- в блоке «Обработка ответа» нет примера
- нет блока «Обработка ошибок»
> Scope: telephony
>
> Кто может выполнять метод: любой пользователь
Метод возвращает информацию о текущем звонке.
Без параметров.
Примеры кода
Вызов метода плейсмента. Результат приходит в колбэке.
- cURL (Webhook)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"PLACEMENT":"getStatus","PARAMS":{}}' \
"https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/placement.call"- cURL (OAuth)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"PLACEMENT":"getStatus","PARAMS":{}}' \
"https://**put_your_bitrix24_address**/rest/placement.call?auth=**put_access_token_here**"- JS
BX24.placement.call('getStatus', {}, function (result) {
console.log(result);
});- PHP
require_once('crest.php');
$result = CRest::call(
'placement.call',
[
'PLACEMENT' => 'getStatus',
'PARAMS' => (object)[]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';Обработка ответа
Возвращаемые данные
Названиетип | Описание |
|---|---|
CALL_IDstring | id текущего звонка |
PHONE_NUMBERstring | Номер телефона клиента |
CRM_ENTITY_TYPEstring | Тип связанного со звонком объекта CRM (CONTACT, LEAD, COMPANY) |
CRM_ENTITY_IDint | id связанного со звонком объекта CRM |
CRM_ACTIVITY_IDint | id дела CRM, связанного со звонком |
CALL_DIRECTIONstring | Направление звонка (incoming, outgoing, incomingTransfer, callback) |
CALL_LIST_MODEbool | Признак работы в режиме обзвона |
| CRM_BINDINGS | Массив привязок звонка к объектам CRM |
- [](./disable-auto-close)
- [](./enable-auto-close)
- [](./call-card-entity-changed)
- [](./call-card-before-close)
- [](./call-card-call-state-changed)
💡 Экспертное мнение и рекомендации
Практические рекомендации:
- При написании кастомных компонентов для «Получить статус звонка getStatus» всегда разделяйте бизнес-логику и представление (шаблон).
- Используйте отладку SQL-запросов через конструкцию
$wpdb->last_queryили стандартный трекер Битрикса, чтобы контролировать нагрузку.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru