Битрикс24 КП. CRM. Как сделать своё правило для обработки писем?

Самая главная проблема КП в том, что проще приспособиться к его алгоритму работы, чем реализовать что-то своё нестандартное )))

Теория, алгоритм

Добавим почтовый ящик с помощью новенького модуля Почта, ссылочку на него можно найти в левом основном меню морды. Не забудем также отметить галочку Связать с CRM, чтобы посмотреть как работает текущий алгоритм и чтобы проверять "наживую".

Теперь потестируем и попопробуем понять как битрикс обрабатывает письма и создаёт Лиды:

1. получается письмо с почтового ящика

2. емейл отправителя этого письма ищется в Контакте, Компании, в Лидах

3. если найден в Компании/Контакте, то ищется Сделка  и... дальше нам пока неинтересно ))) более всего мне интересно было, как создаётся/меняется Лид

4. если найден незакрытый Лид, то письмо (вернее Дело) прикрепляется туда
если Лид в закрытом статусе - то создаётся Повторный Лид

5. ну и если такого емейла не было найдено нигде, то просто создаётся новый Лид

Теперь сопоставляем с тем, как хочет клиент:
1. если найден незакрытый Лид, и письмо является частью цепочки общения из этого Лида, то письмо надо прикреплять к этому Лиду.
2. если письмо не является частью цепочки, то надо создавать новый Лид, а не лепить все письма от одного отправителя в один открытый Лид.

Когда такое нужно, спросите вы? А, например, когда у нас не КП для магазина, а система обработки Обращений в стиле техпода. А теперь подумаем:

* один отправитель может прислать два разных вопроса как на один support-емейл, так и на разные

* один Лид (в наших терминах он уже превратился в Обращение) может иметь в цепочке писем разных сотрудников техпода, обслуживающих этот Лид

* письма от обоих сотрудников техпода должны быть в одной цепочке писем этого Лида, также как и ответы исходного отправителя вопроса

* отправитель может параллельно прислать другой вопрос, и это будет другой Лид, потому что это не ответ на предыдущее письмо от менеджера

Как это сделано

Для получения правил обработки писем модуль Почта использует CMailFilter:: GetFilterList. В этом же методе находится событие OnGetFilterList модуля mail

По коду метода можно увидеть, что возвращаемый массив из вашего обработчика этого события будет подмешан в существующий массив правил из ядра Битрикс и возвращён в качестве результата работы метода CMailFilter:: GetFilterList.

Модуль Почта добавляет туда одно imap правило

То есть непосредственно метод ядра imapEmailMessageAdd и осуществляет распределение по указанному правилу. Данное правило привязано к нашему почтовому ящику, что можно увидеть 

в Администрирование -- Сервисы -- Почта -- Правила. Однаком сменить эту привязку через интерфейс не получается, ибо интерфейс, кажется, работает только с pop3-правилами и ящиками.

DIY

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

Делай два. Из-за невозможности адекватного изменения правил через админку - мы приходим к непосредственному использованию API. Для получения всех почтовых ящиков в системе можно использовать \Bitrix\Mail\MailboxTable, а для работы с привязками правил - \Bitrix\Mail\MailFilterTable

Добавляем к своему ящику новоиспечённое правило.

1. Наше правило должно быть выше остальных для нашего ящика. То есть сортировка должна быть меньше, чем у нижестоящих правил. Ну или можно удалить все остальные правила вообще.

2. Если сохраняете другие правила - полезно поставить ACTION_STOP_EXEC в Y, чтобы последующие правила не выполнялись. Но это, конечно, если вы хотите полностью переделать битриксовый алгоритм работы.

Делай три. Самое "интересное" в данном деле - это разобраться как работает родной метод обработки писем; к сожалению, оставлю это на ваше усмотрение (мой код принадлежит организации, в которой я работаю). Разве что подскажу, что для выполнения описанного выше алгоритма для формирования Обращений полезно будет обратить своё внимание на переменную $forceNewLead внутри родного метода CCrmEmail::imapEmailMessageAdd.

Удачи вам в ваших свершениях!

P.S. Большое спасибо за помощь в освоении данной темы хочу выразить Рыкову Ивану, который дал мне начальный пинок "куда смотреть" )

Битрикс и D7. Товары в Отгрузке.

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

Сегодняшняя задача такая: получить Отгрузки указанного Заказа и понять, какие Товары в каждой из этих Отгрузок.

Не совсем Битрикс, но для него. Пакетная перекодировка файлов.

В очередной раз сокрушаясь, что модули надо писать в CP1251 (прошлый век, ну честное слово), а разрабатывать всё-таки удобнее в UTF-8, сделала я попытку найти перекодировщик, чтобы тыкнул и - бац - перекодировалось.

Ну ленивая я, чесслово, да и путать стала, где у меня CP1251, а где UTF-8.

Сегодня пакетно перекодируем файлы из UTF-8 в CP1251, но не все, а только те, которые надо. Разжёвано - дальше некуда, но я же не заставляю читать =)

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

Из лени встроенной поискала что-нибудь с интерфейсом, потом поняла, что легче разобраться в баше и написать свои пару строчек.

Кажется, я всё-таки скоро отращу бороду и свитер.

Jira REST API и Битрикс КП. Учимся разговаривать с Jira, синхронизация с Битрикс КП.

Как-то у нас исторически сложилось, что Менеджеры сидят в Битрикс КП, а Разработчики - в Jira. Менеджеры привыкли ставить и решать задачи через КП, Разработчики - через Джиру. Отсюда пришла мне крайне узкоспециализированная, но крайне интересная задача по частичной синхронизации Джиры и Битрикс КП.

Мне не разрешили выкладывать готовый код, но я могу описать здесь все проблемы, с которыми столкнулась.
Ахтунг! Букавмнога, очень многа!

Что требовалось:

1. При создании задачи в КП, если отмечена галочка синхронизации, - создавать задачу и в Джире.
2. Опять же, если отмечена галочка синхронизации, то стягивать потраченное время из задач Джиры в задачи КП.
3. Для уже существующих задач в КП иметь возможность выставить задачу из Джиры ручками, чтобы синхронизовать время.
4. Стягивание времени осуществляется по соответствующему агенту (у нас они естественно на кроне).
5. Для уже существующих задач КП иметь возможность создавать задачу в Джире.

PHP и Битрикс: Пошаговое выполнение процесса

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

Примеры таких задач в битриксе - импорт разнообразных типов, или, как это было у меня - удаление задач в КП по определённому условию. Запускаются такие процессы из браузера по желанию юзверя и должны выполняться, показывая текущий статус обработки.

Оставим оформительскую красоту для дизайнеров и реализуем счётчик и простенький прогресс-бар.

Сначала понимаем, что надо сделать на первом шаге, затем что на втором, и что на шаге n-1 и n. Находим точку повторения и точку окончания. Итого:

1. на странице есть кнопка запуска, информационный блок со статистикой и js-обработчики: запуска процесса и обработки результата
2. по клику на кнопке передаём номер шага (и/или другие необходимые параметры)
3. ajax-приёмник обрабатывает шаг, формирует json с необходимой информацией для статуса и возвращает его вызывающей функции.
4. функция обработки результата парсит инфу, выводит статус, решает, надо ли запускать следующий шаг и, соответственно, запускает следующий шаг или заканчивает работу процесса

Прогресс бар реализую с помощью тега progress. Управлять им очень просто:
* максимальное значение задаётся атрибутом max
* текущее значение задаётся атрибутом value
* можно управлять внешним видом с помощью стилей
* минус у него один - это HTML5 и не всеми он поддерживается. Но я показываю его для примера, так что можете реализовать прогресс-бар по старинке - на дивах =)

Json легко парсит функция JSON.parse, превращающая его в объект, с которым уже можно работать дальше.


Пошаговая заготовка из статьи

Дока по тегу progress
Дока по объекту JSON
И ещё про JSON для тех, кому совсем интересно

Битрикс. Похожие товары.

Как известно, формулировка "похожести" у каждого заказчика своя. В данном варианте от меня требовалось создать компонент, возвращающий айдишки продуктов, "похожих" по следующим условиям:

1. цена хотя бы одного торгового предложения искомого продукта не должна отличаться более чем PRICE_INTERVAL от цены исходного продукта
2. искомый продукт должен лежать в той же секции, что и исходный продукт

Битрикс и Инстаграм. Собираем фотки по хештегу для конкурса.

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

Составляем в мозгу логику действий
1. Создание ИБ Конкурсов и ИБ Фоток для конкурсов.
2. Конкурсы создаются ручками операторов. Свойствами конкурсов являются Название, Активность, Время начала действия, Время окончания действия, Хештег, Описание, Результат, Разрешение работы скрипта.
3. Фотки получаются скриптом для конкурса методом обращения к Инстаграм API и сохраняются в базе (ссылки на фотки).


И если с первым и вторым пунктом справятся контент-менеджеры, то с третьим пунктом у них возникнут сложности. И тут на сцену выходит разработчик.

Битрикс КП. Импорт задач из XLSX файла.

Ранее в одном из наших КП добавление задач обрабатывалось бизнес-процессами, сейчас задач стало столько, что бизнес-процессы стали неуместны, и понадобился инструмент для массовой заливки задач на КП.

Итак, есть xlsx файл со списком задач. Из него можно узнать

• TITLE
• DESCRIPTION
• RESPONSIBLE_ID
• CREATED_BY
• START_DATE_PLAN
• END_DATE_PLAN

а также можно вычислить GROUP_ID и несколько свойств, которые были добавлены к задачам.

Сегодня:

• загружаем файл без перезагрузки страницы
• обрабатываем xlsx файл с помощью сторонней библиотеки
• добавляем свои свойства к задачам
• добавляем задачи в базу КП по конкретным группам

Битрикс. Раздаём заказы нескольким операторам.

Пришла задача написать системку распределения заказов для операторов. Первоначальное задание:
1. Нужна страничка с одной кнопкой. Оператор нажимает эту кнопочку и получает заказ на обработку.
2. Оператор может:

• Отказаться от заказа (например, не дозвонились пользователю). В этом случае заказ спит некоторое время, а потом возвращается.
• Отменить заказ штатной кнопочкой Отменить - у нас это равносильно по смыслу удалению заказа (удалять заказы операторам нельзя)
• Изменить статус заказа, чем снимает с себя обязательства по обработке заказа, закрывает заказ.
• И пограничный случай - если заказ заблокирован кем-то ещё, то оператор может снять с себя этот заказ. Пример - создание тестовых заказов, которые обрабатываются непосредственно теми, кто тестирует. В этом случае заказ оператору может попасть, но будет перехвачен из реального списка тестировщиком.

После некоторых дебатов, было решено делать это всё отдельным модулем, чтобы удобнее дополнять, внедрять и весь код был в одном месте.

Версия модуля предварительная, доработок там требуется ещё с тонну. Код - жестокая смесь двух стилей - стандартного битриксового и D7. Где получалось - исправила на D7. Вообще, возможностей нового ядра пока чуток не хватает (про документацию лучше помолчу).
Итак, сегодня в статье микс из описаний использованных решений и самой схемы работы модуля.

Битрикс КП. Получаем список задач с комментариями.

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

Задача на сегодня: быстренько написать инструмент, позволяющий получать отчёты, пригодные для чтения табличными редакторами. Инструмент должен содержать фильтр по социальным группам (к ним можно привязывать таски), период выбора задач (по дате создания задачи) и фильтр по статусу задачи.