# amoCRM

Перед настройкой подключите amoCRM в разделе интеграций.

# Доступные действия

• Изменить статус сделки — переводит текущую сделку на выбранный этап воронки.
• Изменить поле сделки — записывает значение в поле сделки.
• Изменить поле контакта — обновляет данные связанного контакта.
• Изменить поле компании — обновляет данные связанной компании.
• Установить задачу — создаёт задачу в amoCRM для ответственного сотрудника.

Для полей контакта и компании можно выбрать Ответственный и назначить пользователя. При настройке канала в блоке Какую информацию передавать боту доступны также ID сделки и Ссылка на сделку.

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

Для записи данных из чата создайте переменную, например phone, email или client_request, а затем подставьте её через @ в значение поля.

# Списки и мультисписки

В действиях Изменить поле сделки, Изменить поле контакта и Изменить поле компании для полей типа список или мультисписок можно:

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

Перед вызовом действия убедитесь, что переменная заполнена. Пустое значение не должно создавать новый вариант в CRM.

# Изменить статус сделки

Действие переводит текущую сделку в выбранную воронку и статус. При закрытии сделки как неуспешной можно указать стандартную причину отказа из amoCRM.

1. Откройте бота → Интеграции и действия → Изменить нужное действие.
2. В операции Изменить статус сделки выберите подключение amoCRM, воронку и статус.
3. Для статуса Закрыто и не реализовано появится поле Причина закрытия. Выберите причину из списка подключённого аккаунта или оставьте Не выбрана, чтобы закрыть сделку без указания причины.
4. Сохраните действие, затем изменения бота.

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

Если причина удалена в amoCRM, выберите другую или Не выбрана перед сохранением. При пустом списке или ошибке загрузки интерфейс показывает пояснение; настройка статуса остаётся доступна.

Для проверки запустите включённого бота из amoCRM на тестовой сделке и откройте её после выполнения действия. Сверьте воронку, статус и стандартную причину закрытия. Тестовый чат ChatRex имитирует операции amoCRM и не меняет реальную сделку.

Если amoCRM вернула ошибку или не подтвердила выбранную причину, действие считается неуспешным. Перед повторным запуском проверьте состояние сделки.

# Установить задачу

Действие создаёт задачу по текущей сделке amoCRM. В карточке действия выберите нужное подключение amoCRM и добавьте операцию Установить задачу.

1. В поле Срок исполнения задачи выберите дату и время в календаре. Срок должен быть в будущем, не дальше одного года.
2. Выберите Тип задачи: стандартный или пользовательский тип из подключённого аккаунта.
3. При необходимости задайте Ответственный за задачу:
   • Ответственный по текущей сделке — задача назначается сотруднику, ответственному за сделку на момент выполнения действия. Этот вариант используется и в ранее сохранённых действиях.
   • Конкретный сотрудник — появляется обязательное поле Сотрудник. Найдите сотрудника по имени и выберите его из списка активных пользователей подключённого аккаунта.
4. Заполните Текст задачи. Чтобы подставить данные из диалога, введите @ в тексте и выберите переменную из подсказки. Можно добавить несколько переменных рядом с обычным текстом и переносами строк.
5. Сохраните карточку действия, затем изменения бота.

Обязательные поля отмечены звёздочкой. Если поле не заполнено, при сохранении оно подсвечивается и появляется пояснение.

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

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

# Переменные в тексте задачи

Например, сохраните такой текст:

Причина обращения: {{handoff_reason}}
Данные записи: {{booking_note}}

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

Если после подстановки весь текст пустой, задача создаётся с нейтральным текстом «Обращение клиента». Итоговый текст ограничен 4000 символами: если значения переменных увеличили его длину, в задачу попадут первые 4000 символов. Оставшиеся обозначения переменных удаляются.

# Проверка результата

В разделе Тестирование можно проверить ответы бота. Если бот выключен, вызов действия отображается как Пропущено — изменения во внешней системе не выполняются. При включённом боте операции amoCRM в тестовом чате отображаются как Имитация: задачи и другие записи в CRM не создаются.

Ссылка на сделку в сообщении тестового чата не привязывает действие к этой сделке. Для проверки реального создания запустите бота из amoCRM.

Запустите действие на тестовой сделке. В истории ChatRex проверьте результат операции: идентификатор созданной задачи и её исполнителя. Затем откройте сделку в amoCRM и сверьте текст, тип, срок и ответственного. Для текста с переменными проверьте несколько заполненных значений, пустую переменную и два разных диалога: каждая задача должна содержать данные своего клиента.

# Рекомендации

• Для изменения статуса явно укажите в промпте условие перехода.
• Перед записью телефона или email попросите пользователя проверить значение.
• Не очищайте существующие поля пустыми переменными.
• После настройки протестируйте действие на тестовой сделке.