Блог Горошко Андрея Bitrix24 Событие смены статуса звонка CallCard::CallStateChanged

Событие смены статуса звонка CallCard::CallStateChanged

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Событие смены статуса звонка CallCard::CallStateChanged». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

Событие смены статуса звонка CallCard::CallStateChanged

Тут может не хватать некоторых данных — дополним в ближайшее время

  • уточнить права и скоуп
  • добавлен нестандартный блок «Подписка на событие»
  • нестандартный блок «Что получает обработчик»

> Scope: telephony
>
> Кто может подписаться: любой пользователь

Событие CallCard::CallStateChanged возникает при смене состояния текущего звонка.

Что получает обработчик

В обработчик передаются указанные ниже аргументы.

Параметр
тип
Описание
PHONE_NUMBER*
callState
Текущее состояние звонка (idle, connecting, connected)
additionalParams
object
Объект с дополнительными полями

Параметр data[]

Параметр
тип
Описание
failedCode
string
Код завершения звонка. Передается только в случае неуспешного завершения звонка при переходе в состояние idle

Подписка на событие

  • cURL (Webhook)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"PLACEMENT":"CallCard::CallStateChanged","HANDLER":"**your_handler_url_here**"}' \
    "https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/placement.bindEvent"
  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"PLACEMENT":"CallCard::CallStateChanged","HANDLER":"**your_handler_url_here**"}' \
    "https://**put_your_bitrix24_address**/rest/placement.bindEvent?auth=**put_access_token_here**"
  • JS
    BX24.placement.bindEvent("CallCard::CallStateChanged", function (callState) {
        console.log(callState);
    });
  • PHP
    require_once('crest.php');

    $result = CRest::call(
        'placement.bindEvent',
        [
            'PLACEMENT' => 'CallCard::CallStateChanged',
            'HANDLER' => '**your_handler_url_here**'
        ]
    );

    echo '<PRE>';
    print_r($result);
    echo '</PRE>';
  • [](./get-status)
  • [](./disable-auto-close)
  • [](./enable-auto-close)
  • [](./call-card-entity-changed)
  • [](./call-card-before-close)

💡 Экспертное мнение и рекомендации

Ключевые выводы по теме «Событие смены статуса звонка CallCard::CallStateChanged»:

Использование современных стандартов D7 при работе с событие смены позволяет писать чистый, масштабируемый и безопасный код. Не забывайте обрабатывать исключения (try/catch) и проверять права доступа текущего пользователя перед выполнением критических операций.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Удалить команду imbot.command.unregisterУдалить команду imbot.command.unregister

При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Удалить команду imbot.command.unregister», разберем архитектурные особенности и предоставим

Изменить аватарку чата im.chat.updateAvatarИзменить аватарку чата im.chat.updateAvatar

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Изменить аватарку чата im.chat.updateAvatar», проанализируем лучшие практики и

Кнопка над таймлайном карточки элемента CRM_XXX_DETAIL_ACTIVITY, CRM_DYNAMIC_…Кнопка над таймлайном карточки элемента CRM_XXX_DETAIL_ACTIVITY, CRM_DYNAMIC_…

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Кнопка над таймлайном карточки элемента CRM_XXX_DETAIL_ACTIVITY, CRM_DYNAMIC_…», проанализируем