Как создать вебхук в Битрикс24

Вебхук — это ссылка, по которой сервис читает ваши звонки и переписки. Создаётся за минуту, ничего не меняет в портале и отзывается одной кнопкой. Делать это должен администратор портала.

  1. Откройте раздел «Разработчикам»В строке поиска Битрикс24 наверху страницы наберите Разработчикам и выберите одноимённый пункт меню. Так быстрее, чем искать его в левом меню.
  2. Внизу страницы нажмите «Другое»Плитка с тремя точками, подпись: «Создайте входящий вебхук, исходящий вебхук или локальное приложение».
  3. Выберите «Входящий вебхук»Именно входящий — тот, что «для работы с данными вашего Битрикс24 через API». Не исходящий и не локальное приложение.
  4. Отметьте права в блоке «Настройка прав»Это самый важный шаг. Нажмите + выбрать и отметьте всё из списка ниже. Забытое право не сломает подключение сразу — оно тихо отключит часть сервиса.
  5. Нажмите «Создать» и пришлите нам ссылкуСкопируйте строку из поля «Вебхук для вызова rest api» — она вида https://ваш-портал.bitrix24.ru/rest/1/xxxxxxxxxxxx/. Эту ссылку и пришлите.

Какие права отметить

CRM
crm сделки, лиды и контакты — чтобы связать звонок с клиентом
Телефония
telephony список звонков и ссылки на записи
Пользователи
user имена сотрудников; без них в отчётах будут номера
Открытые линии
imopenlines переписки в WhatsApp, Telegram, MAX и ВКонтакте — без них видны только звонки
Диск
disk часть АТС хранит записи разговоров на диске портала
Отметьте все пять. Лишнего они не открывают, а недостающее право выясняется не сразу: сервис подключится, но, например, вместо имён сотрудников будут номера, или переписки не появятся вовсе.

Что сервис делает с этим доступом

Только читает. Сервис не создаёт и не меняет в вашем Битриксе ничего: ни сделок, ни задач, ни комментариев, ни стадий. Он забирает записи разговоров и переписки, разбирает их у себя и показывает результат в отдельном кабинете.

Ссылку храним зашифрованной и показываем в своей админке обрезанной. Если захотите прекратить — удалите вебхук в том же разделе «Разработчикам», и доступ пропадёт в ту же секунду, без обращения к нам.

Не получилось — пришлите скриншот экрана с настройкой прав, разберёмся.