На этой странице

Установка

API-ключ Контур.Толка и подключение

Обновлено:

Ключ создаёт администратор пространства в Контур.Толке, а вставляет в виджет администратор amoCRM.

Создание ключа в Контур.Толке #

Та же инструкция есть на вкладке «Подключение» в блоке «Как получить API-ключ в Контур.Толке».

Раскрытая инструкция «Как получить API-ключ в Контур.Толке» на вкладке «Подключение»: плашка о требовании к тарифу, шаг 1 с путём «Настройки» и «API ключи», шаг 2 с кнопкой «Добавить» и параметрами ключа

  1. Войдите в Контур.Толк под администратором пространства и откройте нужное пространство.
  2. Откройте «Настройки» и перейдите в раздел «API ключи».
  3. Нажмите «Добавить».
  4. В поле «Название ключа» введите понятное имя, например amoCRM.
  5. В поле «Срок действия» выберите срок. Рекомендуем 1-2 года.
  6. Оставьте выключенным переключатель «Доступ к ключу только с разрешенных IP-адресов».
  7. В блоке «Доступы» выставьте права из таблицы на вкладке «Подключение» виджета.
  8. Нажмите «Добавить» и скопируйте созданный ключ.

Таблица прав доступа ключа из инструкции на вкладке «Подключение», группа «Общие»: «Профили», «Встречи», «Записи», «Информация по API ключам» и «Вебхуки»

В таблице есть и группа «Видеовстречи» с правами «Комнаты» (нужно «Изменение») и «Отчетность» (просмотр). Право «Комнаты» нужно для полей «Зал ожидания» и срока гостевой ссылки. Без прав «Встречи: Изменение» и «Профили: Просмотр» виджет не принимает ключ. Если у ключа нет прав на записи, встречи создаются, а записи в сделку не попадают, см. режим «только ссылки».

Подключение ключа в виджете #

  1. Откройте настройки amoCRM и выберите пункт «Контур.Толк».
  2. Перейдите на вкладку «Подключение».
  3. В поле «Адрес пространства» введите имя пространства, например company. Адрес целиком тоже подойдёт, виджет оставит нужную часть.
  4. В поле «API-ключ» вставьте скопированный ключ.
  5. Нажмите «Проверить подключение».

Поля «Адрес пространства» с окончанием .ktalk.ru и «API-ключ» с подсказкой «Вставьте API-ключ администратора» и кнопка «Проверить подключение» на вкладке «Подключение»

После успешной проверки вкладка покажет «Подключение активно» и строку со сроком действия ключа, например «Действует до 15.12.2026». Если срок не задан, там написано «бессрочно». Поля адреса и ключа блокируются, вместо проверки появляется кнопка «Отключить».

Если не получается:

  • Над полями красная плашка «Ошибка подключения». Причину ищите в разборе ошибок ключа.
  • Вместо «Подключение активно» стоит «Подключение активно (только ссылки)». Записи в сделку не попадут, как это исправить, описано в разделе управление подключением.

Дальше: сопоставление сотрудников и поля сделки. Без выбранного «Поля для ссылки на встречу» администратор не сможет создать встречу из карточки.