Работа с CRM
Обновлено
Подключение CRM
Плагин работает с приложением CRM в той же установке Webasyst через его PHP-классы и модели. Адрес внешней CRM, API-ключи и вебхуки для этого подключения не нужны.
Для начала установите CRM, откройте настройки нужной формы в «Заявках» и настройте вкладку «CRM», как описано в первых шагах.
Источник «Заявки»
При первом создании сделки плагин заводит в CRM источник типа «форма» с названием «Заявки» и сохраняет его номер в настройке «Источник в CRM». Следующие сделки используют этот источник.
Если сохранённый источник удалён, при следующей попытке создания сделки плагин создаст новый. При обращении к существующему источнику плагин включает его и разрешает создание сделок, если эти параметры были выключены. Поэтому для остановки автосоздания выключайте «Создавать сделку автоматически» у соответствующих форм.
Какие данные передаются
| Данные | Куда попадают |
|---|---|
| Контакт заявки | В контакт сделки. Без номера контакта создание прекращается. |
| Название формы и номер заявки | В описание и заметку; также могут участвовать в названии сделки. |
| Заполненные поля формы | В описание сделки и отдельную заметку в ленте. Пустые значения и типы html, step, captcha пропускаются. |
| Сумма выбранного поля | В сумму сделки, если значение удалось преобразовать в число. |
| Воронка и этап | В данные сделки по правилам настроек формы и плагина. |
| Номера категорий из «Сегменты для контакта» | Используются для добавления контакта в категории после создания сделки. |
Для описания формируется HTML с названиями полей и значениями, а для заметки — обычный текст с переносами строк. Массивы значений объединяются через запятую. Плагин передаёт значения полей; отдельной загрузки файлов в CRM в нём нет.
Поля копируются при создании сделки. Постоянная синхронизация изменений заявки и сделки в плагине не предусмотрена. При открытии карточки заявки блок «CRM» читает текущие сведения о связанной сделке: название, воронку, этап и сумму.
В ленте сделки видна заметка с названием формы, номером заявки и заполненными полями.
Техническая связь для разработчика
Номер созданной сделки записывается в параметр заявки crm_deal_id. В параметры сделки передаются:
| Параметр | Значение |
|---|---|
requests_app_request_id |
Номер заявки |
requests_field_<ID> |
Непустое значение поля с указанным числовым ID |
Запись параметров полей выполняется отдельно от формирования текста: фильтр типов html, step, captcha из описания здесь не применяется. Если такое поле содержит непустое значение, оно тоже может попасть в параметры.
Собственных инструментов MCP, команд CLI и заданий cron у плагина нет. Создание запускается событием поступления заявки или кнопкой в её карточке. Дополнительный вызов из темы сайта для работы интеграции не требуется.
Доступ сотрудников
Бэкенд-действия плагина проверяют право доступа к бэкенду приложения «Заявки». Список воронок загружается средствами CRM с учётом прав текущего пользователя. Если нужной воронки нет в списке, проверьте доступ сотрудника к ней в CRM.
Диагностика
При ручном создании ошибка возвращается в интерфейс. Ошибки автоматического создания и другие события плагин пишет в журнал requests_crm.log. Разработчик может найти его в каталоге журналов Webasyst wa-log/.
В журнал попадают ошибки доступности CRM, получения источника, создания сделки, добавления заметки и категорий. Ошибка добавления заметки или категории не отменяет уже созданную сделку: при проверке результата смотрите и саму сделку, и её ленту, и категории контакта.