---
title: "Интеграция amoCRM: сделки, контакты и чат Amojo из мессенджеров"
nav_title: "amoCRM"
url: https://docs.tuk-tuk.online/integrations/amocrm
markdown: https://docs.tuk-tuk.online/integrations/amocrm.md
section: "Интеграции"
description: "Как подключить amoCRM к tuk-tuk.online по OAuth 2.0: автосоздание контактов и сделок, переписка из Telegram в карточке сделки через Amojo, теги, примечания, конструктор правил и блоки в цепочках."
keywords: ["AmoCRM интеграция Telegram", "AmoCRM подключить мессенджер", "Amojo мессенджер Telegram", "AmoCRM автоматизация продаж", "AmoCRM воронки продаж", "AmoCRM чат-бот", "CRM мессенджер интеграция", "сделки AmoCRM авто", "AmoCRM конструктор правил"]
lang: ru
product: tuk-tuk.online
app: https://lk.tuk-tuk.online
api_base: https://back.tuk-tuk.online
---

> [!AI] Кратко
> Интеграция amoCRM подключается по OAuth 2.0 в один клик и даёт двустороннюю связь мессенджеров с CRM: автосоздание контактов и сделок, переписка в карточке сделки через Amojo, теги, примечания, кастомные поля, конструктор правил и действия в цепочках.
>
> - Где: «Интеграции» → amoCRM → «Подключить AmoCRM» (всплывающее окно amoCRM); настройки и конструктор правил на странице amoCRM по кнопке «Управлять».
> - Client ID и Client Secret вводить не нужно; refresh_token обновляется автоматически.
> - При подключении автоматически создаётся скрытый канал amoCRM (Amojo) для обмена сообщениями.
> - Действия в цепочках: create_deal, move_pipeline, set_custom_field, set_responsible, tag_deal, tag_contact, add_note.
> - Входящие вебхуки Amojo проверяются по HMAC-SHA1 (заголовок X-Signature), без подписи отклоняются (401).
> - Одна интеграция = один аккаунт amoCRM; действия конструктора повторяются до 3 раз при ошибке.
>
> Связанные страницы: https://docs.tuk-tuk.online/channels/amocrm-chat, https://docs.tuk-tuk.online/chains/blocks/integration, https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/ai/sales-assistant, https://docs.tuk-tuk.online/users/roles-permissions

# Интеграция amoCRM

Интеграция связывает мессенджеры клиентов с воронкой продаж amoCRM в обе стороны. Клиент пишет в Telegram, в amoCRM появляются контакт и сделка, менеджер видит переписку в карточке сделки и отвечает оттуда: ответ уходит клиенту в тот же мессенджер.

Подключение занимает одну авторизацию по OAuth 2.0. Токены обновляются автоматически, канал для обмена сообщениями создаётся сам.

## Что синхронизируется

| Сущность amoCRM | Чтение | Запись |
|---|---|---|
| Контакты | Поиск по телефону и email | Создание контакта при первом обращении, привязка к диалогу |
| Сделки | Список сделок клиента, последняя сделка | Создание, перемещение по этапам, теги, кастомные поля, ответственный |
| Воронки и этапы | Все воронки (pipelines) и их этапы (statuses) | Выбор воронки для новых сделок |
| Пользователи amoCRM | Список менеджеров | Назначение ответственного за сделку |
| Примечания | Нет | Добавление примечаний (notes) к сделке |
| Кастомные поля | Список полей контакта и сделки | Заполнение значениями из диалога |
| Чат Amojo | Входящие сообщения из чата amoCRM | Исходящие сообщения в чат сделки, «Написать первым» из карточки |

> [!NOTE] Для обмена сообщениями при подключении автоматически создаётся скрытый канал [amoCRM (Amojo)](https://docs.tuk-tuk.online/channels/amocrm-chat). Не удаляйте его: без него переписка перестанет попадать в amoCRM.

## Что нужно на стороне amoCRM

- Аккаунт amoCRM с правом устанавливать интеграции.
- Доступ менеджеров к воронке и к чатам: иначе они не увидят переписку в карточке сделки.
- Разрешение `INTEGRATIONS_CONNECT` у вашей роли в tuk-tuk.online (см. [Роли и разрешения](https://docs.tuk-tuk.online/users/roles-permissions)).

Вводить Client ID и Client Secret не нужно: авторизация проходит через кнопку amoCRM.

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


![Подключение amoCRM](https://docs.tuk-tuk.online/assets/screens/integrations/amocrm.webp "amoCRM подключается в один клик: вход в аккаунт amoCRM, права выдаются автоматически.")

1. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations) и выберите amoCRM: в карточке написано «Авторизация в один клик».
2. Нажмите «Подключить AmoCRM»: откроется всплывающее окно amoCRM.
3. Войдите в amoCRM, выберите аккаунт и разрешите доступ: окно закроется, карточка получит отметку «Интеграция подключена».
4. Нажмите «Управлять»: откроется страница amoCRM в кабинете со статусом «Подключено» и адресом Webhook URL.

После авторизации платформа сама получает OAuth-токен, сохраняет идентификатор аккаунта для Chat API, включает синхронизацию контактов и сделок, создаёт канал Amojo и регистрирует вебхук для входящих сообщений из amoCRM.

## Проверить, что работает

1. Напишите боту с тестового номера: в amoCRM появится контакт и сделка в выбранной воронке.
2. Откройте сделку в amoCRM: во вкладке чата видно входящее сообщение.
3. Ответьте из amoCRM: сообщение придёт клиенту в мессенджер, а в tuk-tuk.online появится в диалоге как исходящее.

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

| Событие | Действие платформы |
|---|---|
| Новый клиент написал в мессенджер | Поиск контакта по телефону или email; если нет, создание контакта и сделки в выбранной воронке |
| Входящее сообщение | Копия сообщения в чат сделки в amoCRM (Amojo) |
| Менеджер ответил из amoCRM | Ответ отправляется клиенту в мессенджер |
| Цепочка дошла до блока «Интеграция с CRM» | Сделка создаётся, перемещается, получает тег, примечание, поле или ответственного |
| Событие в amoCRM попало под правило конструктора | Действия правила ставятся в очередь и выполняются по порядку |

## Конструктор правил

Конструктор правил живёт на странице amoCRM в кабинете (кнопка «Управлять» в разделе интеграций). Правило состоит из двух частей:

- **Условия срабатывания**: когда вебхук от amoCRM должен запускать действия. Проверяются поля сделки (воронка, этап, ответственный, бюджет, название, даты создания и обновления, причина отказа) и контакта (имя, фамилия, телефон, email) операторами «равно», «содержит», «начинается с», «больше», «входит в список», «пусто» и их отрицаниями.
- **Действия**: что выполнить при срабатывании, по порядку: сменить этап, заполнить поле, добавить примечание, добавить или удалить тег, создать задачу, создать сделку, ИИ-обработка, задержка.

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

## amoCRM в цепочках

Блок [Интеграция с CRM](https://docs.tuk-tuk.online/chains/blocks/integration) выполняет действия 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 |