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

Установка

Где взять API-ключ Контур.Толка и как его подключить

Обновлено:

Как создать API-ключ в Контур.Толке? #

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

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

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

Как вставить ключ в настройки виджета? #

Ключ вставляется на вкладке «Подключение» вместе с адресом пространства. Это делает администратор amoCRM.

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

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

Во время проверки кнопка показывает «Проверка…», после успеха «Подключение проверено». Вкладка покажет «Подключение активно» и строку вида «Тариф: Бизнес · Действует до {date} · Записи доступны». «Действует до» показывает срок действия API-ключа. Название тарифа в строке виджет подставляет сам и всегда пишет «Бизнес», поэтому фактический тариф пространства эта строка не отражает. Поля адреса и ключа блокируются, а вместо проверки появляется кнопка «Отключить».

Что значит «Подключение активно (только ссылки)»? #

Так вкладка называет режим «только ссылки»: встречи создаются, а записи в сделку не попадают. Режим включается, когда у ключа нет прав на записи или тариф пространства не даёт читать записи по API. Как выйти из него, описано в разделе настройка подключения. Если записи не появляются, смотрите раздел Почему не появляется запись встречи.

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

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

Что делать, если проверка подключения не прошла? #

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

Что делать дальше? #

  1. Выполните первую настройку.
  2. Настройте основные параметры.