Навык «amoCRM»

Навык подключает Искру к вашему аккаунту amoCRM: помогает искать и создавать компании, контакты и сделки, заполнять поля по документам, прикреплять файлы, работать с задачами и примечаниями. По умолчанию перед записью появляется черновик для подтверждения. Предварительное разрешение на заполненные действия задаётся отдельно для вашего профиля в настройках подтверждения.

Подключение

Администратор amoCRM открывает амоМаркет → меню «⋯» справа вверху → «Создать интеграцию» → внешняя интеграция. Заполните название «Искра», обязательное описание, например «Помощник для работы с CRM», и ссылку для перенаправления: https://cloud.iskrabot.ru для облачной Искры либо адрес вашей установки. Включите предоставление доступа и сохраните интеграцию.
В созданной интеграции откройте «Ключи и доступы» → блок «Долгосрочный токен» → «Сгенерировать токен». Выберите срок действия и подтвердите. Для навыка нужен именно долгосрочный токен: секретный ключ интеграции — другое значение. Токен показывается один раз, сразу скопируйте его для ввода в защищённую форму Искры.
В Искре откройте «Навыки» → каталог → amoCRM и установите навык лично или в организацию. На карточке нажмите «Требует настройки» (позже — страница навыка → вкладка «Настройки»). Если доступны оба варианта, выберите в строке «Кому доступно» вверху окна «Только мне» или «Всей организации». В группе «Подключение amoCRM» заполните:
- Поддомен — romashka из romashka.amocrm.ru.
- Домен — amocrm.ru, amocrm.com или kommo.com.
- Долгосрочный токен — значение из предыдущего шага.

Если настраиваете подключение из чата, нажмите кнопку «Настроить секреты навыка» в ходе выполнения. Она открывает окно; сама подготовка кнопки ещё не означает, что подключение сохранено. Уже указанные поддомен, домен и уровень подключения подставляются в форму.

Попросите Искру показать воронки, чтобы проверить подключение.

Общее подключение организации один раз настраивает владелец или администратор. Оно доступно сотрудникам, которым предоставлен этот навык. Личное подключение доступно только вам: другие участники организации не видят его настройки и не могут его использовать. Оно полностью замещает организационное; окно настройки предупреждает о таком выборе и показывает, какое подключение действует. Подробнее — Группы настроек.

Сохранённый токен скрыт: его можно заменить, но нельзя посмотреть. Отозвать доступ можно в amoCRM. API работает с правами пользователя, выдавшего доступ; выбор сотрудника в Искре задаёт атрибуцию записей, а не дополнительные права. Для вложений интеграции также требуется доступ к файлам amoCRM.

Кто вы в amoCRM

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

Компании, сделки и поля

Примеры поручений:

«Найди компанию по ИНН из этой карточки и создай, если её ещё нет».
«Заполни реквизиты компании из приложенного PDF».
«Найди сведения об этой компании по ИНН в интернете и покажи источники».
«Оформи сделку по договору, свяжи с компанией и приложи договор».
«Свяжи существующую сделку с этой компанией».
«Покажи мои просроченные задачи» или «Сводка по основной воронке».

Искра читает текст документа, а для сканов использует доступное распознавание. Неразборчивые и противоречивые реквизиты требуют уточнения. Поиск компаний проверяет также варианты кириллицы, латиницы и сокращения. Если подходят несколько карточек, выберите нужную по названию и реквизитам. Поиск можно продолжить на следующих страницах.

Если поиск по названию пуст, проверьте написание по произношению в другом алфавите: смена регистра или сокращение в том же алфавите этого не заменяют. Для поиска по ИНН, телефону и email такая проверка не требуется.

Повторное создание с теми же данными проверяется по сохранённому результату операции и существующим карточкам. Совпадения по названию, телефону, email и ИНН в структурированных реквизитах помогают избежать дублей. Если нужен отдельный объект с совпадающими данными, явно поручите создать его отдельно. По умолчанию запись выполняется после проверки черновика в форме. Если в настройках этого навыка вы выключили «Спрашивать каждый раз», полностью заполненное действие может выполниться без нового подтверждения. Недостающие данные Искра всё равно предложит заполнить. При потере ответа amoCRM Искра сначала проверяет результат предыдущей записи.

Бюджет сделки можно изменить на ноль. После создания или изменения карточки Искра перечитывает её и сообщает, если не удалось подтвердить сохранение.

Списки и типы полей загружаются из вашего amoCRM. Недостающие значения можно собрать одной формой, затем проверить в черновике. Сотрудники показываются по именам, когда доступен справочник пользователей amoCRM (для него нужны права администратора). Если справочник недоступен, чтение карточек продолжается с предупреждением и идентификаторами. Карточка компании содержит связанные сделки. При замене компании в сделке черновик показывает, какая связь меняется.

Правила продаж команды

Владелец или администратор задаёт правила один раз в настройках amoCRM:

В профиле организации откройте «Навыки» → amoCRM → настройки.
Выберите «Организация», затем блок «Правила продаж команды».
Укажите продукты через ;, шаблон названия, например {client} — {product}, и названия обязательных полей через ;. Названия полей должны совпадать с существующими полями сделок в amoCRM. При необходимости укажите поля вида продаж и даты подписания.
Сохраните настройки. Изменения действуют при следующей записи сделки.

Адрес CRM повторно вводить не нужно: новые правила автоматически привязываются к подключению организации. Если задано только личное подключение, используется его адрес. Поддомен и домен можно заполнить вместе с правилами в том же окне. При редактировании существующих правил их привязка сохраняется.

Искра определяет продукт по содержанию сделки, а название составляет из имени связанной компании и продукта. Перед созданием и изменением сделки проверяются компания, продукт и обязательные поля. Уже заполненные значения учитываются при обновлении; очистка обязательного поля остановит запись. Вид продаж выбирается по контексту из вариантов CRM, дата подписания — из документа или подтверждённого ответа пользователя.

Правила действуют для указанного аккаунта CRM в этой организации, в том числе через личное подключение к нему. Они не открывают другим сотрудникам доступ к личному токену. Для другого аккаунта CRM эти правила не применяются. Если правила не настроены, сделка использует название и поля из запроса. Отдельный навык и PDF с регламентом для работы не требуются.

Реквизиты компании

Навык заполняет существующие поля amoCRM. Если в списке полей компании нет ИНН, КПП или ОГРН, администратор amoCRM должен добавить их: открыть любую карточку компании → «Настроить» → «Добавить поле». Для отдельных идентификаторов подойдёт тип «Текст», сохраняющий ведущие нули. Поля создаются для компаний аккаунта, а не для одной карточки. Инструкция amoCRM по созданию полей.

После сохранения попросите Искру перечитать поля компании и заполнить реквизиты. Переключатель в админке Искры для этого не нужен. Запись реквизитов в примечание — отдельный вариант, который Искра согласует с вами. По умолчанию готовая запись требует подтверждения; при выключенном «Спрашивать каждый раз» для amoCRM заполненное действие может выполниться сразу.

Файлы сделок

Попросите прикрепить загруженный в чат файл к конкретной сделке. Поддерживаются разные форматы, в том числе PDF, изображения и офисные документы, размером до 20 МБ (20 000 000 байт) на файл. По умолчанию перед прикреплением появляется подтверждение со сделкой, именем файла и размером. Если в настройках этого навыка вы выключили «Спрашивать каждый раз», полностью заполненное действие может выполниться без нового подтверждения. Недостающие данные Искра всё равно предложит заполнить. Ограничения самого amoCRM также применяются.

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

Можно также попросить показать вложения сделки, скачать выбранный документ в текущий чат для чтения или распознавания, убрать вложение из сделки либо загрузить новую версию. Скачивание и загрузка поддерживают тот же предел 20 МБ; для сохранения в чат должно хватать свободного места в рабочей папке.

Удаление вложения убирает связь с выбранной сделкой. Сам файл в amoCRM и его связи с другими карточками сохраняются. Новая версия заменяет содержимое общего файла: в подтверждении перечислены связанные карточки, которые увидят обновление. При выключенном «Спрашивать каждый раз» заполненное действие может выполниться сразу — учитывайте влияние на все эти карточки. Повтор прикрепления того же содержимого к той же сделке проверяет версию сохранённого файла. Если содержимое уже заменили, Искра сообщает о расхождении; неизменённый файл можно использовать повторно.

Если новая версия загрузилась, но Искра не смогла сохранить подтверждение операции, повторный запрос проверяет уже загруженную версию. Повторная отправка содержимого для этого не нужна.

Задачи, примечания и контакты сделки

У существующей задачи можно изменить текст, срок и ответственного, завершить её с результатом или вернуть в работу. В обычном примечании можно исправить текст: по умолчанию в подтверждении показаны прежний и новый варианты. Если в настройках этого навыка вы выключили «Спрашивать каждый раз», полностью заполненное действие может выполниться без нового подтверждения. Недостающие данные Искра всё равно предложит заполнить. Системные записи истории этим действием не редактируются.

К существующей сделке можно прикрепить контакт, убрать его связь со сделкой или назначить уже прикреплённый контакт основным. Остальные связи сохраняются; сама карточка контакта при отвязке остаётся в CRM.

Карта подключения

В «Карте знаний» на странице навыка (вкладка «Содержимое», группа «Знания») накапливаются знания о воронках и полях amoCRM. Построить или обновить её можно кнопкой «Исследовать» / «Обновить карту». Подробнее — Карта знаний подключения.