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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Этот вариант работает через API amoCRM и не требует архива с JavaScript-виджетом.

Шаг 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Маркет. Это нормально: Redirect URI на этом этапе не открывается. Интеграция уже создана, но долгосрочный токен ещё не выпущен.

Шаг 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. получит список воронок из amoCRM;
4. получит этапы выбранной воронки;
5. сохранит реальные pipeline_id и status_id без ручного поиска ID.

Выберите:

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

Для уже установленного Green введите SSH-пароль и нажмите Перенастроить Льва. При новой установке заполните обычные поля DEPLOY и нажмите Запустить Льва.

Пустые поля Yandex API Key и Yandex Folder ID при перенастройке заполнять не нужно: DEPLOY сохраняет действующие значения на сервере.

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

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

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

CRM работает как место передачи результата разговора. Telegram, MAX, Bitrix24 и виджет сайта продолжают общаться с Green напрямую.

Как проверить

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Официальная документация 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