Статьи: Контур.Толк
Начало работы

Установка и настройка интеграции

Пошаговая инструкция: как выпустить API-ключ, установить и настроить приложение, планировать видеовстречи прямо из Битрикс24 и автоматически получать записи и транскрипции в CRM.

О приложении

Приложение объединяет сервис видеоконференций Контур Толк и Битрикс24. Работать с конференциями можно из одного окна, не переключаясь в интерфейс Контур Толк.

  • Создание, просмотр и редактирование встреч прямо из Битрикс24.
  • Привязка встреч к CRM: компаниям, сделкам, лидам и контактам.
  • Автоматическое бронирование переговорной, чтобы на один аккаунт не попали две встречи в одно время.
  • Синхронизация со штатным календарём Битрикс24 и календарём Контур Толк.
  • Запись и транскрипция в Битрикс24: после окончания встречи файлы сами загружаются на Диск и прикрепляются к карточке CRM.
  • Архив встреч с поиском по периоду, названию и карточке CRM.
Где работает. Приложение работает и в облачном, и в коробочном Битрикс24.

Что нужно заранее

ТребованиеПояснение
Права администратора в Контур ТолкОни нужны, чтобы создать API-ключ в разделе Управление → API ключи.
Вебхуки в API Контур ТолкПо умолчанию вебхуки в API могут быть не включены. Напишите в поддержку Контур Толк и попросите включить их для вашего пространства.
Права администратора в Битрикс24Они нужны для установки приложения и создания переговорной.
Поддомен пространстваАдрес вашего пространства Контур Толк, например yourcompany.ktalk.ru.
Важно: без вебхуков автоматизация не работает. При настройке приложение подписывается на события «встреча завершена» и «запись готова». Если вебхуки в API не включены, записи и транскрипции не будут приходить в Битрикс24 автоматически.

Шаг 1. Создайте API-ключ в Контур Толк

1

Войдите в Контур Толк под администратором. Откройте УправлениеAPI ключи и нажмите + Добавить.

Раздел API ключи в Контур Толк
Раздел «API ключи» в Контур Толк
2

Введите название ключа, например «Битрикс24». Описание заполнять не обязательно.

Создание API-ключа — название
Форма «Создание API-ключа»
3

Укажите срок действия ключа, лучше максимальный. Когда срок истечёт, интеграция перестанет работать и ключ придётся выпустить заново.

Выбор срока действия ключа
Выбор даты окончания действия ключа
Ограничение по IP. Переключатель «Доступ к ключу только с разрешённых IP-адресов» для интеграции с Битрикс24 не нужен. Оставьте его выключенным.
4

В блоке «Доступы» выдайте максимальные права по всем пунктам: Изменение, а где его нет, Просмотр. Лишних прав здесь не бывает: без них часть функций приложения не заработает.

Настройка доступов API-ключа
Все права выставлены на максимум, включая «Вебхуки: Изменение»
Проверьте строку «Вебхуки». Для неё должно стоять «Изменение». Если строки нет или её нельзя выбрать, значит, вебхуки в API не включены. Обратитесь в поддержку Контур Толк.
5

Нажмите Добавить. Ключ появится в списке, скопировать его можно по ссылке Скопировать ключ. Не закрывайте вкладку: ключ понадобится на шаге 3.

Созданный API-ключ в списке
Ключ создан и появился в списке

Шаг 2. Установите приложение в Битрикс24

6

Откройте Маркетплейс в Битрикс24 и найдите приложение по запросу «Контур Толк». Также его можно установить по персональной ссылке от разработчика. Проверьте запрашиваемые доступы и нажмите Установить.

Окно установки приложения Интеграция с Контур Толк
Окно установки приложения «Интеграция с Контур Толк»
7

После установки в левом меню появится пункт «Контур Толк». Если его не видно, обновите страницу: скорее всего, ещё не обновился кеш.

Приложение в левом меню Битрикс24
Пункт приложения в левом меню
8

Откройте приложение. Вкладки: Список, Календарь, Архив и Настройки. Начните с настроек. Если вкладки «Настройки» нет, обновите страницу.

Главный экран приложения
Главный экран приложения, вкладка «Список»
Совет. Приложение удобнее открыть по прямой ссылке на весь экран, а не в боковом слайдере.

Шаг 3. Подключите Контур Толк и зарегистрируйте вебхук

9

Откройте вкладку Настройки, блок «Подключение к Контур Толк». Вставьте скопированный API-ключ и укажите поддомен пространства, например yourcompany.ktalk.ru. Нажмите Сохранить.

Поле API-ключа в настройках
Блок «Подключение к Контур Толк»
10

В блоке «Статус подключения» должна появиться зелёная надпись «Подключено. Найдено пользователей в Толке: N». Кнопка Проверить соединение проверяет связь ещё раз.

Статус подключения
Подключение установлено, вебхук пока не зарегистрирован
11

Нажмите Показать права API-ключа. Приложение покажет, какие права есть у ключа, и выделит зелёным критически важные.

Разрешения API-ключа
Список разрешений API-ключа
12

В блоке «Вебхук записей встреч» нажмите Зарегистрировать вебхук. Статус должен смениться на зелёный: «Вебхук активен».

Вебхук активен
Вебхук зарегистрирован и активен
Зачем нужен вебхук. С ним Контур Толк сам сообщает приложению, что запись встречи готова. Файл загружается на Диск Битрикс24 и прикрепляется комментарием в таймлайн карточки CRM.

Шаг 4. Сопоставьте пользователей и задайте параметры

Сопоставление пользователей

13

В блоке «KTalk — Сопоставление пользователей» нажмите + Добавить строку. Слева выберите сотрудника Битрикс24, справа его учётную запись в Контур Толк.

Сопоставление пользователей
Выбор пары «сотрудник Битрикс24 — пользователь Контур Толк»
14

Сопоставьте всех сотрудников, которые участвуют в конференциях, и нажмите Сохранить. Затем укажите часовой пояс и тоже сохраните.

Сопоставленный пользователь и часовой пояс
Сопоставление пользователей и часовой пояс
Не пропускайте сотрудников и не забывайте сохранять. Без сопоставления интеграция не знает, кого добавлять участником со стороны Контур Толк. У каждого блока настроек своя кнопка Сохранить, и изменения без неё не применяются.

Переговорная по умолчанию

15

Создайте в Битрикс24 переговорную для интеграции. Откройте КалендарьЗанятость переговорныхПереговорныеДобавить, назовите её, например, «Контур Толк» и нажмите Сохранить.

Добавление переговорной в Битрикс24
Добавление переговорной «Контур Толк» в Битрикс24
16

Вернитесь в Настройки приложения. В поле «Переговорная по умолчанию» выберите созданную переговорную и нажмите Сохранить. Она будет бронироваться автоматически при создании каждой встречи.

Переговорная по умолчанию
Часовой пояс и переговорная по умолчанию

Автозавершение встреч

17

В блоке «Автозавершение встреч» укажите, через сколько часов встреча считается завершённой, если событие о её окончании не пришло. По умолчанию стоит 2 часа. Это страховка на случай сбоя вебхука или недоступности Битрикс24.

Автозавершение встреч
Автозавершение встреч и сводка по подключению

Шаг 5. Запланируйте встречу

На вкладке Список встречи сгруппированы по дням, режимы «Неделя» и «День». На вкладке Календарь встречи удобно создавать и переносить мышкой.

18

Откройте вкладку Календарь и кликните по нужному времени, чтобы создать встречу.

Вкладка Календарь
Вкладка «Календарь» с недельной сеткой
19

В окне «Новая конференция» выберите в поле «Привязка к CRM» тип сущности (компания, сделка, лид, контакт) и найдите запись по названию. Затем укажите тему, дату, время начала и конца.

Новая конференция — привязка к CRM
Привязка встречи к карточке CRM и основные поля
20

Добавьте участников через поиск сотрудников. В блоке «Занятость сотрудников» видно, кто и когда свободен. Интервал можно двигать и растягивать мышкой, как в календаре Битрикс24, и время начала и конца изменится само.

Внизу формы есть два переключателя:

  • Внешние участники: гости смогут подключиться по ссылке без аккаунта KTalk.
  • Автоматическая запись встречи: запись начнётся, когда войдёт первый участник.

Нажмите Создать конференцию.

Участники, занятость и переключатели
Участники, шкала занятости, внешние участники и автозапись
Бронирование переговорной. Вместе со встречей всегда бронируется переговорная «Контур Толк». Поэтому на один аккаунт нельзя поставить две встречи на одно время. Это важно для тарифов, где одновременно может идти только одна конференция.
21

Встреча появится в календаре приложения.

Созданная встреча в календаре
Созданная встреча в календаре приложения
22

Кликните по встрече, чтобы открыть её карточку: время, ссылка для подключения, переговорная и участники. Там же есть кнопки Изменить и Отменить.

Карточка встречи
Карточка встречи
23

В режиме редактирования текущая встреча подсвечивается жёлтым на шкале занятости. Сдвиньте её на новое время и нажмите Сохранить.

Редактирование встречи
Перенос встречи при редактировании

Шаг 6. Синхронизация с календарями

24

Встреча, созданная через приложение, появляется в штатном календаре Битрикс24. Её можно редактировать прямо там, например перетащить на другое время. Изменения попадут и в Контур Толк.

Встреча в календаре Битрикс24
Встреча в штатном календаре Битрикс24
25

На вкладке Список у встречи отображаются время, переговорная, ссылка на карточку CRM, статус, владелец и участники. Действия:

  • Войти: открыть конференцию в Контур Толк;
  • значок копирования: скопировать полный текст приглашения;
  • Изменить / Отменить: изменить или отменить встречу.
Встреча в списке
Встреча во вкладке «Список»
26

Кнопка Изменить открывает окно «Редактировать конференцию». Если выбранное время пересекается с другой встречей в переговорной, приложение предупредит об этом.

Окно Редактировать конференцию
Окно «Редактировать конференцию»
27

Та же встреча с участниками видна в календаре Контур Толк. Если участников со стороны Контур Толк несколько, там появятся все.

Встреча в календаре Контур Толк
Встреча в календаре Контур Толк
Мобильное приложение. В мобильной версии Битрикс24 приложение показывает список встреч и кнопку «Добавить».

Шаг 7. Проведите встречу и запишите её

28

Войдите в конференцию и включите запись: «Запись встречи»Начать запись. Если при создании встречи был включён переключатель автозаписи, запись начнётся сама. После встречи остановите запись, завершите конференцию и покиньте комнату.

Запуск записи в Контур Толк
Запуск записи встречи в Контур Толк

Шаг 8. Запись и транскрипция в CRM и на Диске

Когда конференция завершится, приложение автоматически:

  • отметит встречу как завершённую;
  • загрузит видеозапись на Диск Битрикс24 и добавит её в таймлайн привязанной карточки CRM;
  • загрузит транскрипцию, как только Контур Толк её подготовит. Сначала приходит запись, затем транскрипция.
29

Откройте карточку CRM, к которой привязана встреча. В таймлайне появятся событие о встрече и комментарий со ссылкой на запись.

Таймлайн карточки CRM
Встреча и запись в таймлайне карточки компании
30

У карточки появится отдельная вкладка «KTalk». Сначала она может оказаться в меню Ещё. Её можно перетащить ближе к началу или настроить через Настроить меню.

Настройка вкладок карточки
Вкладка «KTalk» в меню «Ещё» карточки компании
31

На вкладке «Видеоконференции KTalk» собраны все встречи по этой карточке: дата, статус, ссылки на запись и транскрипцию. Нажмите на ссылку, чтобы открыть файл.

Вкладка Видеоконференции KTalk
Все встречи по карточке CRM
32

Файлы хранятся на Общем диске Битрикс24 в папке «KTalk записи конференций». Внутри файлы разложены по карточкам CRM, а затем по году и месяцу, например Компания (14) Тест Контур → 2026 → Август.

Папка с записью и транскрипцией на Диске
Видеозапись и транскрипция (TXT) на Общем диске
33

Транскрипцию можно открыть, скачать, отправить клиенту или передать ИИ-ассистенту, например чтобы получить краткое содержание встречи.

Файл транскрипции
Файл транскрипции на Диске Битрикс24
Если файл не появился сразу. Обновите страницу. Транскрипция приходит позже записи, когда Контур Толк её подготовит.

Шаг 9. Архив встреч

34

На вкладке Архив хранятся завершённые встречи со ссылками на записи и транскрипции. Искать можно по периоду, названию конференции или карточке CRM (для компании — по её названию).

Архив встреч
Архив завершённых встреч с поиском

Чек-лист настройки

  • Поддержка Контур Толк включила вебхуки в API
  • API-ключ создан с максимальным сроком и полными правами, для «Вебхуков» стоит «Изменение»
  • Приложение установлено в Битрикс24
  • В настройках сохранены API-ключ и поддомен, статус «Подключено»
  • Вебхук зарегистрирован, статус «Вебхук активен»
  • Все участники конференций сопоставлены и сохранены
  • Часовой пояс указан и сохранён
  • Переговорная создана в Битрикс24 и выбрана по умолчанию
  • Время автозавершения встреч проверено
  • Тестовая встреча с записью прошла, запись и транскрипция появились в карточке CRM

Если остались вопросы, обращайтесь, мы с удовольствием поможем.