
Отправка данных из форм
Настройка
Убедитесь, что заполнены системные настройки:
- amobridge.enabled — интеграция включена
- amobridge.form_pipeline_id — ID воронки для форм (если пусто, используется
amobridge.default_pipeline_id) - amobridge.form_status_id — ID статуса для новых сделок из форм
Хук amoBridgeHook
Для отправки данных из формы добавьте хук amoBridgeHook в вызов FormIt:
modx
[[!FormIt?
&hooks=`email,amoBridgeHook`
&amoFormName=`callback`
&validate=`name:required,phone:required,email:email:required`
&successMessage=`Спасибо, ваша заявка отправлена!`
]]Параметры хука
| Параметр | Описание |
|---|---|
| &amoFormName | Имя формы для идентификации в amoCRM. Используется в названии сделки |
| &amoLeadName | Шаблон названия сделки (переопределяет системную настройку amobridge.form_lead_name_tpl) |
| &amoPipelineId | ID воронки (переопределяет системную настройку) |
| &amoStatusId | ID статуса (переопределяет системную настройку) |
| &amoTags | Теги через запятую (переопределяет системную настройку) |
Маппинг полей
Компонент автоматически распознает стандартные поля формы:
- email — по паттерну
emailв имени поля - phone — по паттерну
phone,tel,mobile - name — по паттерну
name,fullname,fio
Для кастомных полей настройте маппинг в CMP (вкладка «Маппинг полей», контекст form).
Поведение
- Хук всегда возвращает
true— ошибки amoCRM не блокируют отправку формы - При наличии email или телефона выполняется дедупликация контактов
- К сделке добавляется примечание со всеми полями формы
- Если включен Scheduler — отправка выполняется асинхронно
