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

Установка

Где взять 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-ключ администратора» и кнопка «Проверить подключение» на вкладке «Подключение»

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

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

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

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

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

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

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

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