Как подключить amoCRM к LEVBOT

После подключения Green сможет работать с amoCRM в двух режимах:

• передавать обращения менеджеру: создавать или находить контакт, заводить сделку в выбранной воронке, добавлять резюме разговора и при необходимости ставить задачу;
• если Avito подключён к amoCRM — принимать сообщения Avito через amoCRM и отвечать клиенту в том же чате.

Пользователю не нужны командная строка, Client Secret, двадцатиминутный код авторизации или ручные API-запросы. Для базового подключения используются:

1. адрес аккаунта amoCRM;
2. долгосрочный токен;
3. LEVBOT DEPLOY.

Важно: полный долгосрочный токен — это пароль от доступа к CRM. Не публикуйте его, не вставляйте в переписку и не оставляйте на скриншотах. amoCRM показывает созданный токен только один раз.

Что должно быть готово

• аккаунт amoCRM с правами администратора;
• установленный Green и известный технический домен, например bot.company.ru;
• актуальная версия LEVBOT DEPLOY с блоком amoCRM;
• доступ к amoМаркету в аккаунте;
• если LEVBOT должен отвечать в Avito через amoCRM — подключённый к amoCRM аккаунт Avito.

Шаг 1. Зарегистрируйтесь или войдите в amoCRM

Откройте https://www.amocrm.ru/, войдите в существующий аккаунт либо зарегистрируйте новый. Для теста можно использовать пробный период.

После первого входа amoCRM может предложить мастер настройки. Его можно пропустить: сначала нам нужны amoМаркет и собственная интеграция LEVBOT. Salesbot настроим в конце этой инструкции.

Шаг 2. Откройте amoМаркет

На рабочем столе нажмите amoМаркет в левом меню.

Шаг 3. Начните создание интеграции

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

Шаг 4. Выберите «Внешняя интеграция»

В открывшемся окне нажмите Создать напротив пункта Внешняя интеграция.

Этот вариант работает через API amoCRM и не требует отдельного JavaScript-виджета LEVBOT.

Шаг 5. Пройдите проверку amoCRM, если она появится

При первом создании интеграции amoCRM может запросить подтверждение личности и паспортные данные. Это происходит на стороне amoCRM; LEVBOT эти данные не получает.

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

После одобрения снова откройте:

amoМаркет → три точки → Создать интеграцию → Внешняя интеграция.

Шаг 6. Заполните форму интеграции

Заполните поля следующим образом.

Ссылка для перенаправления

Используйте адрес технического домена Green:

https://ВАШ-ДОМЕН/amo/oauth/callback

Пример:

https://bot.company.ru/amo/oauth/callback

Точный Redirect URI можно скопировать из блока amoCRM в LEVBOT DEPLOY. Домен должен совпадать с техническим доменом установленного Green.

Права

Включите:

Предоставить доступ: Все

Оставьте выключенными:

• Контроль дублей;
• Множественные источники.

LEVBOT самостоятельно обрабатывает повторные события. Эти специальные режимы amoCRM для базового подключения не нужны.

Название

LEVBOT

Описание

Интеграция персонального чат-бота LEVBOT с amoCRM.
Создаёт и обновляет контакты и сделки,
сохраняет результаты диалогов
и передаёт обращения менеджерам.

Язык оставьте Русский. Логотип можно не загружать. Нажмите Сохранить.

После сохранения amoCRM вернёт вас в amoМаркет. Это нормально: интеграция уже создана, но долгосрочный токен ещё не выпущен.

Шаг 7. Откройте созданную интеграцию

Перейдите на вкладку Установленные и нажмите карточку LEVBOT.

Откройте вкладку Ключи и доступы.

Шаг 8. Сгенерируйте долгосрочный токен

В блоке Долгосрочный токен нажмите Сгенерировать токен.

Для подключения через DEPLOY не нужны:

• секретный ключ;
• ID интеграции;
• код авторизации, действующий 20 минут.

DEPLOY использует долгосрочный токен и адрес вашего аккаунта amoCRM.

Шаг 9. Выберите срок действия

Укажите максимально удобную дату. amoCRM позволяет выпустить долгосрочный токен на срок от одного дня до пяти лет.

Нажмите Подтвердить.

Сразу скопируйте появившийся токен и сохраните его в надёжном месте. После закрытия окна amoCRM больше не покажет его целиком.

Шаг 10. Подключите amoCRM в LEVBOT DEPLOY

Откройте LEVBOT DEPLOY и включите:

Подключить amoCRM

Заполните два поля.

Адрес аккаунта

Это адрес вашего кабинета amoCRM, например:

company.amocrm.ru

Не используйте общий адрес www.amocrm.ru. Нужен именно домен вашего аккаунта.

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

Вставьте скопированный токен и нажмите:

ПРОВЕРИТЬ И ЗАПОЛНИТЬ

DEPLOY автоматически:

1. проверит токен и аккаунт;
2. получит список воронок;
3. получит этапы выбранной воронки;
4. найдёт или создаст служебное поле LEVBOT_OUTBOX;
5. подготовит готовый код Salesbot именно для вашего аккаунта.

Выберите:

• воронку, куда должны поступать обращения Green;
• этап новой сделки;
• нужно ли автоматически создавать задачу менеджеру.

После успешной проверки в нижней части блока появится Salesbot LEVBOT и готовый код.

Не копируйте код из этой статьи или со скриншота. В вашем DEPLOY код формируется автоматически и содержит идентификатор служебного поля именно вашего аккаунта amoCRM.

Шаг 11. Проверьте подключение Avito к amoCRM

Этот шаг нужен только если LEVBOT должен отвечать клиентам Avito через amoCRM.

Если вы уже ведёте переписку Avito внутри amoCRM, ничего менять не нужно.

В amoCRM интеграция Avito должна быть подключена как обычный источник чатов.

Если Avito ещё не подключён, сначала подключите его средствами amoCRM. Официальная инструкция:

https://www.amocrm.ru/support/incoming_leads/avito

Для связки LEVBOT + amoCRM + Avito используются текстовые сообщения. Фото, видео и файлы через этот маршрут не поддерживаются.

Шаг 12. Откройте список Salesbot

В amoCRM откройте:

Настройки → Чаты и мессенджеры

В блоке Список ботов нажмите:

Создать нового бота или импортировать.

Шаг 13. Создайте нового бота LEVBOT

Нажмите плитку Новое.

Назовите бота точно:

LEVBOT

Название важно: DEPLOY ищет Salesbot по имени LEVBOT.

Шаг 14. Переключите Salesbot в режим кода

В открывшемся редакторе нажмите значок:

</>

в правой верхней части редактора.

Шаг 15. Вставьте код из DEPLOY

Вернитесь в LEVBOT DEPLOY и нажмите:

СКОПИРОВАТЬ КОД

Вставьте скопированный код целиком в редактор Salesbot вместо текущего содержимого.

Ничего внутри JSON вручную менять не нужно.

Нажмите Сохранить.

Шаг 16. Не создавайте автоматический триггер

LEVBOT запускает Salesbot программно только тогда, когда Green уже подготовил ответ клиенту. Поэтому отдельное условие автоматического запуска в amoCRM не требуется.

Если amoCRM покажет предупреждение:

«Бот не будет запущен без триггера. Сохранить триггер?»

выберите:

Выйти без сохранения

Это нормально. Сам Salesbot сохранён; мы просто не создаём автоматический триггер.

Шаг 17. Обязательно проверьте Salesbot в DEPLOY

После сохранения Salesbot не нажимайте сразу «Перенастроить Льва».

Сначала вернитесь в блок amoCRM в LEVBOT DEPLOY и нажмите:

НАЙТИ И ПРОВЕРИТЬ SALESBOT

DEPLOY должен показать три зелёных статуса:

✓ amoCRM проверена
✓ LEVBOT_OUTBOX готов
✓ Salesbot LEVBOT найден

Только после этого переходите к установке или перенастройке Green.

Правильный порядок:

Сохранить Salesbot в amoCRM
→ НАЙТИ И ПРОВЕРИТЬ SALESBOT в DEPLOY
→ убедиться, что Salesbot LEVBOT найден
→ Запустить Льва / Перенастроить Льва

Если DEPLOY сообщает, что найдено несколько ботов с одинаковым именем, выберите нужный либо удалите старые тестовые копии.

DEPLOY сам сохраняет ID найденного Salesbot. Пользователю не нужно вручную искать field_id, bot_id или редактировать .env.

Шаг 18. Проверьте ответ из Avito

Откройте любое активное объявление Avito, которое подключено к amoCRM, и отправьте обычное текстовое сообщение.

Если всё настроено правильно, сообщение пройдёт по цепочке:

Avito
→ amoCRM
→ Green / LEVBOT
→ Salesbot LEVBOT
→ amoCRM
→ Avito

Ответ LEVBOT должен появиться в том же диалоге Avito.

Для первой проверки достаточно двух сообщений подряд. Во втором сообщении спросите что-нибудь, что зависит от предыдущей реплики: так вы одновременно убедитесь, что Green продолжает один и тот же диалог.

Что происходит после подключения

Передача обращения менеджеру

Когда Green принимает решение передать обращение человеку, amoCRM-адаптер может:

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

Диалог Avito через amoCRM

Для ответа в Avito используется простая схема:

1. amoCRM получает входящее сообщение из своей штатной интеграции Avito;
2. Green получает текст и формирует ответ;
3. DEPLOY заранее создаёт служебное поле LEVBOT_OUTBOX;
4. Green записывает туда готовый ответ;
5. Green запускает Salesbot LEVBOT;
6. Salesbot отправляет содержимое поля в тот же чат;
7. штатная интеграция amoCRM доставляет сообщение обратно клиенту Avito.

В этой схеме не нужны отдельные расширения amoCRM или автоматический триггер Salesbot.

Как проверить CRM-часть

1. Отправьте сообщение через подключённый канал.
2. Представьтесь.
3. Оставьте тестовый телефон или email.
4. Попросите связать вас с менеджером.
5. Откройте выбранную воронку amoCRM.
6. Проверьте контакт, сделку, примечание и задачу.
7. Повторите сообщение и убедитесь, что дубль сделки не появился.

Частые ошибки

«Токен amoCRM не принят»

Проверьте, что вставлен именно долгосрочный токен, а не ID интеграции, секретный ключ или двадцатиминутный код авторизации.

«Аккаунт не найден»

Указывайте домен своего кабинета, например company.amocrm.ru, а не www.amocrm.ru.

Воронки не появились

Нажмите Проверить и заполнить повторно. Также проверьте права интеграции и доступность API в аккаунте.

DEPLOY пишет «Сначала проверьте amoCRM и подготовьте LEVBOTOUTBOX»

Нажмите Проверить и заполнить. DEPLOY сам найдёт либо создаст служебное поле и после этого сформирует код Salesbot.

Salesbot LEVBOT не найден

Проверьте три вещи:

• имя бота должно быть точно LEVBOT;
• бот должен быть сохранён и активен;
• после создания вернитесь в DEPLOY и снова нажмите Найти и проверить Salesbot.

Автоматический триггер при этом не нужен.

amoCRM предлагает сохранить триггер

Не создавайте условие запуска. Выберите Выйти без сохранения. Green запускает Salesbot самостоятельно.

Сообщение Avito не получает ответ

Проверьте:

• Avito действительно подключён к amoCRM и сообщения видны в CRM;
• в DEPLOY amoCRM успешно проверена;
• Salesbot LEVBOT найден;
• после настройки выполнена установка или Перенастроить Льва;
• тест отправляется обычным текстом, а не фото или файлом.

Создана не та сделка или выбран неправильный этап

Вернитесь в DEPLOY, выберите другую воронку и этап, затем снова нажмите Перенастроить Льва.

Потерян долгосрочный токен

Откройте интеграцию LEVBOT в amoCRM и создайте новый долгосрочный токен. Старый токен нельзя повторно посмотреть целиком.

Нужно отключить amoCRM

Снимите галочку Подключить amoCRM и перенастройте Green. DEPLOY отключит интеграцию, но не удалит ваш аккаунт и данные в amoCRM.

Короткий чек-лист

• [ ] Green установлен и технический домен работает по HTTPS.
• [ ] В amoCRM создана внешняя интеграция LEVBOT.
• [ ] Включён доступ ко всем данным аккаунта.
• [ ] Создан и сохранён долгосрочный токен.
• [ ] В DEPLOY указаны домен аккаунта и токен.
• [ ] DEPLOY получил воронки и этапы.
• [ ] DEPLOY подготовил LEVBOT_OUTBOX.
• [ ] В amoCRM создан Salesbot с точным именем LEVBOT.
• [ ] В Salesbot вставлен код, скопированный из DEPLOY.
• [ ] Автоматический триггер Salesbot не создавался.
• [ ] DEPLOY нашёл и проверил Salesbot.
• [ ] Выполнена установка или перенастройка Green.
• [ ] Если используется Avito — штатная интеграция Avito в amoCRM подключена.
• [ ] Тестовое сообщение Avito получило текстовый ответ LEVBOT.
• [ ] Тестовая передача менеджеру создаёт нужные CRM-сущности без дублей.

Официальная документация amoCRM

• Долгосрочные токены: https://www.amocrm.ru/developers/content/oauth/step-by-step
• Параметры аккаунта: https://www.amocrm.ru/developers/content/crm_platform/account-info
• Воронки и этапы: https://www.amocrm.ru/developers/content/crm_platform/leads_pipelines
• Сделки API v4: https://www.amocrm.ru/developers/content/crm_platform/leads-api
• Salesbot: https://www.amocrm.ru/developers/content/digital_pipeline/salesbot
• Список ботов: https://www.amocrm.ru/support/communications/bot_list
• Интеграция с Avito: https://www.amocrm.ru/support/incoming_leads/avito