Интеграция связывает мессенджеры клиентов с воронкой продаж amoCRM в обе стороны. Клиент пишет в Telegram, в amoCRM появляются контакт и сделка, менеджер видит переписку в карточке сделки и отвечает оттуда: ответ уходит клиенту в тот же мессенджер.
Подключение занимает одну авторизацию по OAuth 2.0. Токены обновляются автоматически, канал для обмена сообщениями создаётся сам.
#Что синхронизируется
| Сущность amoCRM | Чтение | Запись |
|---|---|---|
| Контакты | Поиск по телефону и email | Создание контакта при первом обращении, привязка к диалогу |
| Сделки | Список сделок клиента, последняя сделка | Создание, перемещение по этапам, теги, кастомные поля, ответственный |
| Воронки и этапы | Все воронки (pipelines) и их этапы (statuses) | Выбор воронки для новых сделок |
| Пользователи amoCRM | Список менеджеров | Назначение ответственного за сделку |
| Примечания | Нет | Добавление примечаний (notes) к сделке |
| Кастомные поля | Список полей контакта и сделки | Заполнение значениями из диалога |
| Чат Amojo | Входящие сообщения из чата amoCRM | Исходящие сообщения в чат сделки, «Написать первым» из карточки |
#Что нужно на стороне amoCRM
- Аккаунт amoCRM с правом устанавливать интеграции.
- Доступ менеджеров к воронке и к чатам: иначе они не увидят переписку в карточке сделки.
- Разрешение
INTEGRATIONS_CONNECTу вашей роли в tuk-tuk.online (см. Роли и разрешения).
Вводить Client ID и Client Secret не нужно: авторизация проходит через кнопку amoCRM.
#Как подключить
- Откройте раздел Интеграции и выберите amoCRM: в карточке написано «Авторизация в один клик».
- Нажмите «Подключить AmoCRM»: откроется всплывающее окно amoCRM.
- Войдите в amoCRM, выберите аккаунт и разрешите доступ: окно закроется, карточка получит отметку «Интеграция подключена».
- Нажмите «Управлять»: откроется страница amoCRM в кабинете со статусом «Подключено» и адресом Webhook URL.
После авторизации платформа сама получает OAuth-токен, сохраняет идентификатор аккаунта для Chat API, включает синхронизацию контактов и сделок, создаёт канал Amojo и регистрирует вебхук для входящих сообщений из amoCRM.
#Проверить, что работает
- Напишите боту с тестового номера: в amoCRM появится контакт и сделка в выбранной воронке.
- Откройте сделку в amoCRM: во вкладке чата видно входящее сообщение.
- Ответьте из amoCRM: сообщение придёт клиенту в мессенджер, а в tuk-tuk.online появится в диалоге как исходящее.
#Что происходит после подключения
| Событие | Действие платформы |
|---|---|
| Новый клиент написал в мессенджер | Поиск контакта по телефону или email; если нет, создание контакта и сделки в выбранной воронке |
| Входящее сообщение | Копия сообщения в чат сделки в amoCRM (Amojo) |
| Менеджер ответил из amoCRM | Ответ отправляется клиенту в мессенджер |
| Цепочка дошла до блока «Интеграция с CRM» | Сделка создаётся, перемещается, получает тег, примечание, поле или ответственного |
| Событие в amoCRM попало под правило конструктора | Действия правила ставятся в очередь и выполняются по порядку |
#Конструктор правил
Конструктор правил живёт на странице amoCRM в кабинете (кнопка «Управлять» в разделе интеграций). Правило состоит из двух частей:
- Условия срабатывания: когда вебхук от amoCRM должен запускать действия. Проверяются поля сделки (воронка, этап, ответственный, бюджет, название, даты создания и обновления, причина отказа) и контакта (имя, фамилия, телефон, email) операторами «равно», «содержит», «начинается с», «больше», «входит в список», «пусто» и их отрицаниями.
- Действия: что выполнить при срабатывании, по порядку: сменить этап, заполнить поле, добавить примечание, добавить или удалить тег, создать задачу, создать сделку, ИИ-обработка, задержка.
У каждого правила есть журнал срабатываний и логи. Действие с ошибкой повторяется до 3 раз, затем помечается как невыполненное.
#amoCRM в цепочках
Блок Интеграция с CRM выполняет действия amoCRM как шаг сценария.
| Действие | Ключ | Что делает |
|---|---|---|
| Создать сделку | create_deal | Создаёт сделку и привязывает контакт по телефону или email |
| Переместить по воронке | move_pipeline | Переводит сделку на указанный этап воронки |
| Кастомное поле | set_custom_field | Заполняет поле контакта или сделки |
| Ответственный | set_responsible | Назначает менеджера |
| Тег сделки | tag_deal | Добавляет тег к сделке |
| Тег контакта | tag_contact | Добавляет тег к контакту |
| Примечание | add_note | Записывает текст в историю сделки |
#Безопасность
- Авторизация по OAuth 2.0, refresh_token обновляется автоматически.
- Входящие сообщения из Amojo проверяются по подписи HMAC-SHA1 в заголовке
X-Signature; запрос без подписи или с неверной подписью отклоняется с кодом 401. - Секрет вебхука (24 байта, 48 hex-символов) генерируется автоматически при подключении.
- Пересылку сообщений в amoCRM можно приостановить, не отключая интеграцию.
#Ограничения
- Одна интеграция = один аккаунт amoCRM.
- Канал Amojo создаётся только через интеграцию; вручную его не добавить.
- Переписка попадает в amoCRM только после подключения; старые диалоги задним числом не переносятся.
#Частые проблемы
| Проблема | Что делать |
|---|---|
| Не создаются сделки | Проверьте, что на странице amoCRM выбрана воронка и включено автосоздание |
| Сообщения не попадают в amoCRM | Убедитесь, что интеграция в статусе «Подключено», канал amoCRM (Amojo) активен и пересылка не приостановлена |
| Ошибка OAuth при подключении | Закройте всплывающее окно, обновите страницу и повторите «Подключить AmoCRM» под администратором amoCRM |
| Amojo не подключился | Проверьте, что у аккаунта amoCRM есть доступ к чатам (мессенджинг) |
| Менеджер не видит чат | Выдайте менеджеру доступ к воронке и чатам в настройках amoCRM |