dooCall · Docs

API документацияdoocall.uz

Интеграция с Bitrix24

После подключения каждый завершённый звонок из мобильного приложения DooCall автоматически регистрируется в Битрикс24 как телефонный звонок: для незнакомых номеров Битрикс24 сам создаёт лид, запись разговора прикрепляется к звонку или публикуется в ленте CRM.

1Создайте входящий вебхук

В Битрикс24 откройте: Разработчикам (левое меню) → Другое → «Входящий вебхук». Откроется страница с готовой ссылкой вида:

https://ваш-портал.bitrix24.ru/rest/1/xxxxxxxxxxxxxxxx/

2Настройте права (самый важный шаг)

В блоке «Настройка прав» нажмите «+ выбрать» и добавьте ДВА права:

  • «Телефония (telephony)» — регистрация звонков;
  • «CRM (crm)» — создание лидов и публикация ссылки на запись в ленту.
Не перепутайте: в списке есть похожий пункт «Телефония (совершение звонков) (call)» — он НЕ подходит. Нужен именно пункт с «(telephony)» в скобках. Затем нажмите «Сохранить».
При изменении прав или нажатии «Перегенерировать» код ссылки может измениться — после сохранения сверьте URL и при необходимости обновите его в DooCall.

3Подключите в DooCall

В кабинете DooCall: Настройки → Интеграция → Bitrix24. Заполните:

  • URL входящего вебхука — ссылка из шага 1 целиком;
  • ID пользователя Bitrix24 — сотрудник, за которым фиксируются звонки (по умолчанию 1 — администратор);
  • Адрес аккаунта — для справки, например ваш-портал.bitrix24.ru.

Нажмите «Подключить», затем «Проверить подключение».

Как это работает

  • Звонок регистрируется через telephony.externalcall.register и завершается finish — он попадает в статистику телефонии и в карточку CRM.
  • Незнакомый номер → Битрикс24 автоматически создаёт лид (CRM_CREATE).
  • Статусы: успешный (200), недозвон (304), занято (486), отклонён (603).
  • Запись в mp3/wav прикрепляется прямо к звонку; другие форматы (например .ogg с Android) публикуются постоянной ссылкой в ленту лида/контакта.
  • Повторная отправка того же звонка в течение 30 минут не создаёт дубликатов (EXTERNAL_CALL_ID).

Возможные проблемы

  • insufficient_scope — вебхуку не хватает права «Телефония (telephony)» (см. шаг 2);
  • INVALID_CREDENTIALS — ссылка вебхука изменилась или вебхук удалён: скопируйте актуальный URL и обновите его в DooCall;
  • Звонок не появился — проверьте статус на странице Bitrix24 в кабинете DooCall и что интеграция включена.