Документация · Интеграции · amoCRM

Подключение amoCRM.

Внешняя интеграцияДолгосрочный токен

Лиды проекта сами попадают в amoCRM: каждый — сделкой с контактом и примечанием. Подключение делается один раз на проект. В amoCRM создаётся интеграция и выпускается токен, в кабинете kukuruza вписываются адрес аккаунта и этот токен.

01Что понадобится

права администратора в amoCRM — без них в amoМаркете нет кнопки создания интеграции;
доступ к почте владельца аккаунта amoCRM: туда придёт код подтверждения;
аккаунт amoCRM на адресе вида компания.amocrm.ru;
кабинет kukuruza.tech и проект, лиды которого нужно передавать.

02Интеграция в amoCRM

1. Откройте создание интеграции

В левом меню amoCRM откройте amoМаркет, справа вверху нажмите ⋯ и выберите «Создать интеграцию».

amoМаркет: меню «⋯» с пунктом «Создать интеграцию»

2. Выберите внешнюю интеграцию

Нажмите «+ Создать» у варианта «Внешняя интеграция». Приватная интеграция не нужна: она для загрузки собственного JS-кода в аккаунт, а kukuruza работает только через API.

Окно «Создание интеграции»: внешняя и приватная интеграция

3. Заполните форму

Поле	Что указать	Зачем
Ссылка для перенаправления	https://kukuruza.tech	Поле обязательное. При подключении по долгосрочному токену эта ссылка не используется.
Ссылка для хука об отключении	оставьте пустой	Необязательное поле.
Предоставить доступ	только «Доступ к данным аккаунта»	Этого права хватает, чтобы создавать сделки и контакты, добавлять примечания и искать дубли. Доступ к файлам и центру уведомлений не нужен.
Контроль дублей	не отмечать	Дубли по телефону проверяет kukuruza и оставляет решение вам.
Множественные источники	не отмечать	С этой галкой amoCRM не создаёт источник по умолчанию.
Название и описание	kukuruza.tech · «Передача лидов из kukuruza.tech»	Видны только вам в списке интеграций. Логотип необязателен.

В списке «Предоставить доступ» по умолчанию отмечено всё — снимите галки со всех пунктов, кроме «Доступ к данным аккаунта».

Список прав: отмечен только «Доступ к данным аккаунта»

4. Сохраните и подтвердите кодом

Нажмите «Сохранить». amoCRM попросит подтверждение: нажмите «Отправить код», введите шесть цифр из письма и нажмите «Подтвердить».

Интеграция появится в amoМаркете на вкладке «Установленные». Пока токен не выпущен, у неё статус «Отключена» — это нормально. После выпуска токена статус сменится на «Установлено».

Интеграция kukuruza.tech на вкладке «Установленные»

03Долгосрочный токен

1. Откройте «Ключи и доступы»

Нажмите на карточку интеграции и перейдите на вкладку «Ключи и доступы». В блоке «Долгосрочный токен» нажмите «Сгенерировать токен». Секретный ключ и ID интеграции не нужны — кнопку «Сгенерировать ключ» не трогайте.

Вкладка «Ключи и доступы» с кнопкой «Сгенерировать токен»

2. Выберите срок действия

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

Окно «Сгенерировать токен» с выбранной датой

Токен не продлевается. Когда срок выйдет, лиды перестанут уходить в amoCRM, пока вы не выпустите новый токен. Выбирайте срок с запасом и запишите дату.

3. Скопируйте токен

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

Токен действует с правами пользователя amoCRM, который его выпустил. Если интеграция должна видеть только одну воронку, выпустите токен под пользователем с доступом только к ней.

04Подключение в кабинете

1. Выберите amoCRM

В кабинете kukuruza откройте Интеграции → CRM, выберите проект и в поле «CRM» — amoCRM. К одному проекту подключается одна CRM.

Кабинет kukuruza: в поле «CRM» выбран amoCRM

2. Впишите адрес и токен

Subdomain amoCRM — часть адреса аккаунта до .amocrm.ru: для https://mycompany.amocrm.ru это mycompany. Полный адрес тоже подойдёт.
Долгосрочный токен — токен, скопированный в amoCRM.
Когда отправлять — «Только квалифицированные»: сделка появляется, когда в разговоре подтвердили интерес. «Все лиды при создании»: каждый новый лид уходит сразу, ещё до звонка.
pipeline_id и status_id — номера воронки и этапа. Если оставить пустыми, сделки попадут на первый этап главной воронки. Номер воронки виден в адресе её страницы в amoCRM: …/leads/pipeline/12345678.
Передавать тег «kukuruza» — сделка получит этот тег, и по нему можно отобрать наши лиды в amoCRM. В новом подключении галка уже стоит, снять её можно в любой момент.

Заполненная форма подключения amoCRM в кабинете

3. Нажмите «Подключить»

kukuruza проверит токен запросом к amoCRM и покажет название аккаунта. Повторные обращения номера, с которым в проекте уже закончили работу, в amoCRM не отправляются ни в одном режиме.

Кабинет kukuruza: «CRM подключена», amoCRM и название аккаунта

05Что приходит в amoCRM

сделка с названием «kukuruza · кампания · телефон» — на этапе из настроек или на первом этапе главной воронки;
контакт с номером в поле «Телефон» (рабочий);
примечание к сделке: комментарий оператора, проект, кампания, статус и ссылка на лид в кабинете;
тег «kukuruza» на сделке, если он включён в настройках. Уже отправленные сделки он не меняет.

Сделка от kukuruza в amoCRM: контакт с телефоном и примечание

Каждая отправка видна в кабинете, в журнале «Доставки в CRM» под формой подключения.

Журнал «Доставки в CRM» с отправленным лидом

Статус	Что значит
В очереди	Лид ждёт отправки, обычно не дольше минуты.
Отправляется	Идёт запрос к amoCRM.
Отправлено	Сделка создана или обновлена, в колонке «CRM id» — её номер.
Ждёт решения	В amoCRM уже есть контакт или сделка с этим телефоном. В кабинете выберите: создать новую сделку или пропустить. Если найдена сделка, её можно обновить.
Пропущено	Вы выбрали «Пропустить» для дубля.
Ошибка	amoCRM не принял запрос. Отправка повторяется автоматически, до пяти попыток; текст ошибки — в последней колонке.

06Отключение и новый токен

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

В amoCRM срок токена виден на вкладке «Выданные доступы». Кнопка «Отозвать доступ» там же сразу прекращает передачу лидов.

Вкладка «Выданные доступы»: срок токена и «Отозвать доступ»

07Если не работает

Ошибка при «Подключить» — проверьте поддомен, что токен скопирован целиком, его срок не истёк и доступ не отозван.
Доставки перешли в «Ошибка» после того, как всё работало, — чаще всего истёк или отозван токен. Выпустите новый и обновите ключи в кабинете.
Адрес аккаунта не на amocrm.ru (например, amocrm.com или kommo.com) — такое подключение пока не поддерживается, напишите в поддержку.

08Поддержка

Вопросы по подключению — на profit@kukuruza.tech. Если лиды нужно забирать в собственную систему, есть API передачи лидов.