Интеграция с AmoCRM
Внимание. Интеграция находится на стадии бета-тестирования. Интеграция не хранит персональные данные ваших пользователей дольше, чем требуется для передачи в AmoCRM.
Возможные кейсы использования
Автоматическое создание сделки в AmoCRM при заполнении формы в боте Senler.
Отправка служебных заметок менеджеру (телефон, источник, ответы на вопросы бота).
Назначение ответственного, проставление тега/статуса, запись поля "Источник" (UTM) из переменных бота.
Как работает интеграция
Интеграция добавляется как шаг в схему чат-бота Senler. Когда подписчик доходит до этого шага, Senler берёт значения из переменных шага и отправляет их в AmoCRM согласно выбранному набору переменных. Подключение к AmoCRM выполняется через авторизацию: администратор один раз даёт доступ "Интеграции с Senler" в интерфейсе AmoCRM и выбирает нужный аккаунт.
Инструкция по установке и настройке
1) Установка интеграции
Первым делом необходимо установить интеграцию "AmoCRM" в вашем личном кабинете Senler. Для этого:
Перейдите в раздел Интеграции.
Найдите и установите интеграцию "AmoCRM".
2) Подключение аккаунта AmoCRM
В открывшемся окне AmoCRM нажмите "Получить токен Senler"
Нажмите "Подключить amoCRM"
В открывшемся окне AmoCRM выберите нужный аккаунт и нажмите "Разрешить" для интеграции с Senler.
После успешной авторизации в окне Senler появится блок Аккаунт в amoCRM с кнопкой Сменить аккаунт.
3) Добавление шага интеграции в чат-боте
Откройте нужного чат-бота → на схеме добавьте шаг AmoCRM.
Нажмите на шаг и в правой панели выберите "Настроить".
Откроется модальное окно "AmoCRM".
Направление передачи данных
Выберите, в какую сторону передавать информацию:
Отправка данных в amoCRM - Senler передаёт данные в amoCRM (создание/обновление сделки и заполнение полей).
Отправка данных в Senler - данные из amoCRM передаются в Senler (если используется обратная передача).
Настройки передачи в amoCRM (Только для отправки в amoCRM)
В этом блоке настраиваются расширенные параметры сделки, которые будут переданы в amoCRM.
Имя сделки
Можно выбрать:
Имя клиента - в сделку будет подставлено имя клиента;
Своё значение - вы задаёте шаблон имени вручную. Если выбрано «Своё значение», можно использовать переменные Senler в формате
%...%. Пример:%username% сенлера амо %fullname%
Доступные системные переменные:
usernamefullnameuseridcityrelationcountryа также все пользовательские переменные Senler.
Если значение переменной отсутствует, передаётся пустое значение (null).
Воронка
Выберите воронку amoCRM, в которой будет создана/обновлена сделка.
Статус
Выберите этап (статус) сделки в выбранной воронке. Также доступен вариант "Не изменять" - статус сделки не будет изменён (актуально при обновлении существующей сделки).
Ответственный
Назначьте ответственного пользователя amoCRM или выберите "Не назначать".
Цена
Укажите сумму сделки (числовое значение), которая будет записана в amoCRM.
Нажмите "Добавить" у поля "Передача значений".
У вас появилось два поля с возможностью выбора переменных:
В первом поле выберите значение, которое хотите отправлять:
В переменную amoCRM - выберите поле amoCRM, куда записывать значение (например,
utm_source,roistatили пользовательское поле).
Из Senler - укажите текст или переменную Senler (поддерживается формат
%...%).
Важно. Обратное действие из amoCRM в Senler работает только для тех лидов/сделок, которые были созданы интеграцией Senler → amoCRM.
Ограничение: максимальная длина значения в поле «Из Senler» - 2000 символов.
Пример:
В переменную amoCRM:
utm_sourceИз Senler:%utm_source%
Во втором поле вы можете указать текст и множество переменных соединив их, исходя из ваших задач.
Для добавления переменной в текст нажмите кнопку "Добавления" "+" - В открывшемся окне из списка выберите нужную переменную и нажмите "Вставить" - Нажмите "Сохранить"
Максимальное количество символов в одной переменной 2000, это ограничение AmoCRM, если символов в значении переменной окажется больше - значение обрежется до 2000
⚠️ Важная информация по сопоставлению полей и доступным типам данных переменных: На данный момент в интеграции Senler с AmoCRM реализована передача данных переменных для полей со следующими типами:
Числовые поля: Поля Senler, содержащие числовые значения (например, баллы, сумма заказа), могут быть сопоставлены с числовыми полями в AmoCRM.
Текстовые (строковые) поля: Поля Senler, содержащие текстовые данные (например, имя, комментарий, UTM-метки), могут быть сопоставлены с текстовыми или строковыми полями в AmoCRM.
4) Шаблон настроек
Что это: сохранённый набор переменных для шага интеграции. Создаётся в одном чат-боте канала и может повторно использоваться в других ботах этого же канала.
Зачем нужен: чтобы не настраивать одни и те же переменные каждый раз — выбрали шаблон, и все поля заполнятся автоматически.
В модальном окне интеграции найдите блок Шаблон настроек.
Нажмите кнопку "+ Добавить"
Как выбрать, переименовать или удалить шаблон
Кликните по полю "Выберите шаблон" — раскроется список доступных шаблонов.
Выберите нужный шаблон, чтобы применить его к шагу.
Для управления шаблоном "Переименовать" "Удалить" используйте иконки действий рядом с его названием в выпадающем списке.
Примечание: шаблоны доступны только в пределах текущего канала и видны во всех чат-ботах этого канала.
5) Тестирование
Пройдите сценарий бота сами: введите тестовые данные → проверьте, что в AmoCRM появилась сделка и заполнены нужные поля.
При необходимости отредактируйте шаблон и формат подстановок переменных.
6) Удаление интеграции
Чтобы удалить интеграцию AmoCRM:
Откройте раздел Интеграции и выберите карточку AmoCRM.
В открывшемся окне нажмите кнопку "Действия" (в правом верхнем углу модального окна).
В выпадающем списке выберите "Удалить".
Подтвердите действие в появившемся диалоговом окне.
Важно: после удаления интеграции шаги и сценарии, использующие эту интеграцию, перестанут работать. Перед удалением убедитесь, что она больше не используется в ваших чат-ботах и процессах.
Пример использования
Воронка "Онлайн-заявки", начальный статус "Новая".
В боте после шага с формой (Имя + Телефон) — шаг AmoCRM с выбранным шаблоном.
В заметку сделки выводим: Имя, Телефон, Ссылка на профиль/диалог, Ответы на вопросы, UTM.
Менеджеру прилетает готовая сделка — остаётся только позвонить.
Результат
После прохождения пользователем шага интеграции в AmoCRM автоматически создаётся/обновляется сделка, а в примечании фиксируются ответы из бота.
Ошибки
1. Ожидание обработки
После запуска интеграции данные обрабатываются до 24 часов.
2. Как перезапустить обработку неудавшихся записей
Откройте нужного чат-бота.
Перейдите к шагу Интеграция → Статистика.
Нажмите Повторить (перезапуск произойдёт только для записей, упавших в ошибку они снова пойдут на обработку 24 часов).
3. Ошибка "Переполнены лимиты"
Что значит: в вашем аккаунте АmoCRM количество открытых сделок превысило лимит.
Почему возникает: в АmoCRM лимит считается на пользователя (например: 1 пользователь = 500 открытых сделок). Когда лимит исчерпан, новые сделки создать нельзя — интеграция возвращает ошибку.
Как исправить (выберите вариант)
a. Закройте или удалите часть сделок, чтобы освободить место.
Если были созданы “пустые” сделки без переменных, и они приводят к переполнению — удалите их.
После этого интеграция попробует создать их повторно при следующем прогоне.
b. Увеличьте лимит в АmoCRM (расширьте тариф / докупите слоты), чтобы поднять допустимое количество открытых сделок. Подробнее о лимитах АmoCRM можно посмотреть здесь.
c. Повысить лимит запросов в секунду Для одной интеграции действует ограничение до 7 запросов/сек. Если ваш лимит выше, необходимо написать обращение в техническую поддержку для его увеличения.
4. Если вы удалили API-ключ
Создайте новый API-ключ в вашем аккаунте.
Свяжитесь с технической поддержкой и укажите новый ключ.
Мы добавим ключ в интеграцию и подтвердим, когда всё снова заработает.
⚠️ Без добавления нового ключа в интеграцию запросы будут отклоняться.
Примечания
Создать сделку или вернуть сделку в «Неразобранное» нельзя.
Если этап (статус) сделки не выбран, по умолчанию сделка создаётся в статусе «Первичный контакт».
Last updated