История с хэппи-эндом: интеграция «Битрикс24» с Asterisk. Битрикс интеграция

Описание одной интеграции 1С и Битрикс, и почему я не рекомендую своим клиентам использовать такую интеграцию

Сроду такого не было, и опять то же самое. В.С. Черномырдин.

Я уже говорил об обмене данными между программными продуктами семейства 1С и Битрикс-сайтами в статье Интеграция программного обеспечения. Описание процесса от бизнес консультанта. Но тогда я рассказал исключительно об общих принципах работы. В другой статье я написал о проблемах 1С и Битрикса.

Сегодня я постараюсь не просто описать проблему интеграции сайтов на Битрикс и программных продуктов 1С, но расскажу подробно о возможных «подводных камнях», с которыми сталкиваются специалисты, опишу конкретные проблемы, а также возможные пути их решения.

Я уже говорил и не один раз, что программные продукты семейства 1С отличаются большим числом багов, требуют регулярных обновлений, но после их установки очень часто приходится заново настраивать работу конфигурации, а также все плагины, надстройки и обмен данными с другими компонентами, программами, системами. Именно с такой проблемой ко мне обратился не так давно клиент, представитель веб-студии. Вот так выглядело его предложение о сотрудничестве:

Здравствуйте! Нужно срочно доделать синхронизацию сайта и 1С, точнее – выполнить выгрузку товаров, цен и фото из 1С 8.3 (последняя версия) на сайт. Помощь нужна срочно, если вы свободны, напишите мне, как с вами связаться, чтобы рассказать о проблеме подробнее. Заранее благодарен

Как и многие коллеги, я также зарегистрирован на фриланс-биржах, а потому подобные запросы меня не удивляют. Время у меня было свободное. И хотя пришел этот запрос далеко за полночь, я все же решил взяться за эту задачу.

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

Итак, исходные данные следующие:

Имеется 1С Управления торговли. По словам клиента – последняя версия
Перестала работать интеграция. Сразу после обновлений.
Клиент утверждал, что обновился полностью.
Битрикс последней версии
Что делать?! Все пропало

Шаг первый. Версия конфигурации

Первое, что я делаю всегда, это проверяю информацию, которую мне предоставляет клиент. А в случае с 1С – обязательно самостоятельно проверяю текущую версию.

В данном случае релиз действующей конфигурации оказался 11.1.9.5. Это означало, что конфигурация не обновилась, версия не является последней.

Естественно, что я сообщил об этой ошибке клиенту, после чего самостоятельно установил обновления. Конфигурация обновилась. Интеграция так и не заработала.

При работе с 1С всегда перепроверяйте версию платформы и конфигурации! Это очень важно! Напомню, что в Управлении Торговлей 11 заявлен стандартный модуль обмена данными между УТ.11 и Битрикс. Это стандартный встроенный модуль, который должен работать без каких-то дополнительных настроек. Но в моем случае после обновлений он так и не заработал. При запуске обмена просто не происходило ничего.

Шаг второй. Проверка платформы

Тогда я проверил релиз платформы. В принципе, его стоит проверять сразу. Лично я советую обязательно всегда самостоятельно проверять релизы и платформы, и конфигурации. Это настолько важно, что я не боюсь написать об этом повторно.

Проверяйте актуальность всех релизов самостоятельно!

В моем случае с платформой было все в порядке, релиз оказался последним, номер 8.3.5.1248, который вышел 31.10.14. (кстати пока я писал эту статью вышло еще одно обновление платформы ).

Итак, версии платформы и конфигурации в порядке, но обмен не работает.

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

Шаг третий. Проверяем целостность базы данных

Так, первым делом я отправился на сайт Битрикс. Я перешел на следующую страницу:

http://1c.1c-bitrix.ru/ecommerce/download.php

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

Как и многие коллеги в подобной ситуации, я обратился за помощью к Интернету. На одном из форумов (mista.ru) я нашел информацию о том, что если не идет какой-то из видов обмена, обязательно нужно исключить из перечня возможных проблем нарушение целостности структуры базы данных. Для того чтобы выполнить это действие, в 1С существует встроенный инструмент: тестирование и исправление базы данных.

Итак, программа 1С провела большую и достаточно длительную работу, так как в данном случае база данных была на файловой основе, было исправлено много ошибок. Общее время работы тестирования и исправления – 40 минут. Ждать, конечно, пришлось долго. Но все когда-то оканчивается. И вот, после тестирования, мы с надеждой на лучшее запускаем обмен. Снова нет никаких результатов.

Шаг четвертый. Специальный модуль: поможет ли альтернативное решение?

После того, как не помогла и проверка базы данных, я вспомнил о том, что также прочитал на одном из форумов, что кто-то из Битрикс-специалистов устанавливал специальный модуль обмена и всем его рекомендовал. Ну, что ж. Я также отправился в интернет, искать этот модуль и выяснять, зачем он нужен.

Нашел я только один вариант релиза этого модуля, предназначенный для версии 4.0.5.1. Я подумал, решил все же попробовать и скачал этот модуль интеграции. При скачивании я заметил, что версия этого файла у меня на сайте далеко не первая.

Мой файл после скачивания назывался так:

4.0.5.1_ UT_11.1.2(3).zip

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

Далее я все же установил этот модуль. В архиве к нему идет небольшая брошюра, что оказалось очень кстати. Но самая версия файла мне не давала покоя. И я решил спросить у клиента, какой я по счету? В ответ услышал, что я уже 5 или 6 специалист, который пытается решить эту проблему.

У меня уже появился спортивный интерес. Обратите внимание: уже прошло более часа, как я начал решать, казалось бы, простую задачу, но проблема до сих пор не только не была решена, но и пути ее решения все еще не были определены.

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

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

Кроме того, все эти действия не принесли никакой пользы. Проверяйте версию модуля обмена данных 1С и Битрикс. Их может быть несколько одновременно: несколько версий, а также несколько разных конфигураций.

После попыток установить дополнительный модуль, я обратил внимание на такую надпись вверху экрана:

После прочтения этой надписи, я думал, что это и есть последняя, самая новая конфигурация. Но это было моей ошибкой. Только позже я разобрался, что есть более свежая версия и где ее скачать.

Кроме того, очень внимательно нужно следить за выбором модуля. Лично я поначалу запутался в этих модулях для России:

В общем, что я получил в итоге всех действий и проверок:

Есть обмен стандартный, который выходит в 1С. Он не работает.
Есть модуль обмена данных «Для России». Он также не заработал.
Внизу есть еще один модуль обмена. Но и он не работает.

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

Что меня еще сбило с толку. Если вы нажмете кнопку «Требования 1С», то увидите такую таблицу:

1c.1c-bitrix.ru/ecommerce/require_1C.php

Здесь также приходится угадывать, что и как скачивать.

Новый модуль обмена: особенности установки

Итак, я все же скачал новый модуль обмена и внедрил его в Управление Торговли. Естественно, при этом я снял конфигурацию с поддержки. Как ни странно, но факт:

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

При этом на сайте и в документации присутствуют предупреждения, которые могут даже испугать. Вам не забывают напомнить, что в случае какой-либо вашей ошибки, конфигурация вообще может перестать работать.

Не забывайте делать Backup!

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

Итак, я внедрил новый модуль, все проверил, все сделал аккуратно и точно. В результате – обмен не работает.

Появляется следующая ошибка:

Невосстановимая ошибка Ошибка при выполнении запроса POST к ресурсу /e1cib/logForm: по причине: Ошибка СУБД: Ошибка SQL: Несовместимые типы в выражении по причине: Ошибка SQL: Несовместимые типы в выражении

Что это значит? О чем говорит данная информация? Мне было не понятно.

Для начала я решил просмотреть отладчик. На поиск этой ошибки я потратил около получаса и не нашел вообще ничего. Честно говоря, тогда у меня закрались сомнения, что я вообще справлюсь с поставленной задачей. Я пошел искать больше информации по теме.

И нашел форум, на котором наткнулся на такую ветку:

http://dev.1c-bitrix.ru/community/forums/forum26/topic19114/?PAGEN_1=65

Информацию об ошибке я благополучно нашел на 65 странице темы.

Ответ модераторов был следующим. Они давали ссылку на другую тему, при этом поясняли, что там уже есть решение этой проблемы, а также можно найти много интересного по этой теме.

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

Разработчик об этом писал следующее:

Наш модуль обмена сейчас несовместим с платформой 8.3.5.1248. В этой платформе, похоже, изменили что-то нехорошее. Для того, чтобы модуль заработал — нужно заменить строчки кода: |КОГДА ВариантыКомплектацииНоменклатурыТовары.Характеристика ЕСТЬ NULL |ТОГДА """"

На |КОГДА ВариантыКомплектацииНоменклатурыТовары.Характеристика ЕСТЬ NULL |ТОГДА НЕОПРЕДЕЛЕНО В следующей версии модуля будут внесены соответствующие изменения.

Что это значит?

Администратор сайта 1С Битрикс практически признал, что ошибка находится в платформе 1С.

После того, как я нашел эту информацию, ошибка была исправлена и обмен, в общем, заработал. Но конкретно все — нет.

При выгрузке мы обнаружили, что фото и номенклатура передаются, а цены – нет. К счастью, что делать с этой проблемой, я уже знал. На стороне Битрикс, хоть он, казалось бы, и не работает при обмене, надо провести одно изменение, а именно – в справочнике с ценами поставить галочку «Доступен внешним пользователям».

Также странная недоработка, я считаю. Почему-то об этом нюансе в документации не написано ни слова. И в свое время я решение этой проблемы искал аналогичным методом, т.е. на ощупь.

Что получилось в итоге?

Задача была решена успешно. Мы с клиентом все настроили, обмен данными начал работать так, как и должен. Мы отработали со стороны 1С, специалист по Битрикс настроил работу с данными со своей стороны. В результате потребовалось 3 часа напряженной работы.

На что было потрачено это время?

Каждое действие требует определенных временных затрат. Обновления занимают от 10 до 15 минут, индексация и исправление базы данных – 40 минут, каждая попытка обмена – от 15 до 18 минут (если запускать полный обмен). В результате мы потратили очень много времени для того, чтобы заново настроить то, что прекрасно работало перед обновлением конфигурации и платформы 1С.

Выводы

На собственном опыте, а также на основе внимательного чтения той самой ветки форума с проблемами интеграции и их решениями, я сделал такие выводы:

Битрикс – никак или плохо взаимодействует с компанией 1С. Надпись 1С Битрикс ничего не значит, кроме того, что у этих программных продуктов общие владельцы.
Настройка, казалось бы, типового обмена требует недюжинных усилий, при этом всегда есть риск напороться на ошибки с непредсказуемой стороны. Т.е. при обновлении нужно очень четко понимать, какая используется конфигурация, платформа, какая версия модуля применяется, а также надо проверять, нет ли ошибок для этого модуля.

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

И еще немного интересного из моего личного опыта

Сейчас я работаю над другим проектом, и столкнулся также с любопытной ситуацией. Я и специалисты, с которыми я сотрудничаю, отвечаем за интеграцию сайта со стороны 1С, а на стороне Битрикс работает сторонний специалист. В принципе, мы с самого начала договаривались о том, что они напишут нам отдельную загрузку для 1С. Но в процессе работы специалисты Битрикс нам сообщили, что выполнить эту договоренность невозможно и предложили использовать типовой обмен.

Что получается в итоге:

Нам нужно выгружать доработанные нашими силами справочники и данные в типовом виде. Таким образом, имеем явное противоречие. Конечно, проблему мы обязательно решим и в этот раз, и в другой. Здесь важно понимать, что подобные накладки и противоречия – постоянные спутники каждого, кто занимается интеграцией 1С и Битрикс.

Если вы решились применять типовой обмен

Первое, что вам нужно понимать, что обмен, который вам предлагают, универсален, а потому сам модуль очень сложен. Кроме того, даже на этой странице v8.1c.ru/edi/edi_stnd/90/92.htm вы увидите, что имеется несколько версий этого обмена, причем, они регулярно меняются. А для полноценной настройки работы подобного обмена и, тем более, для доработки его под ваши потребности, вам придется очень четко понимать, как он работает.

Для примера:

Формат выгружаемых данных из УТ 11.1.9.56

Формат выгружаемых данных из УТ 11.1.9.56 с помощью модуля от Битрикс:

То есть имеем несогласованность форматов выгрузки от 1С и Битрикса для одной и той же версии платформы и конфигурации.

Взаимодействие продуктов 1С и 1С-Битрикс реализуется на базе процедур двунаправленного обмена данными. Обмен данными выполняется с использованием основанного на XML открытого Стандарта обмена коммерческой информацией – CommerceML 2.0.

Если вы почитаете, что представляет собой CommerceML 2.0, вы так же, как и я, поразитесь тому, насколько этот стандарт сложен по сравнению с другими. Даже просто описание, т.е. сам файл схемы описаний в формате txt занимает 107 килобайт!

И любая ваша ошибка, скорей всего, окончится тем, что обмен вообще перестанет работать.

При использовании типового обмена вы вынуждены «подсаживать» и себя и клиента на постоянный мониторинг изменений, которые происходят как на стороне 1С, так и на стороне Битрикс. При каждом обновлении вы рискуете потерять все изменения, которые вносили в обмен. В итоге, вы получите сложный, очень «глючный» и работающий практически независимо от вас механизм. А если к этому добавить еще и постоянные обновления 1С и Битрикс, то вместо работающего обмена вас ожидает постоянная «головная боль».

Как делать интеграцию?

Я уже давал этот совет и дам еще раз: обмен нужно писать самому. Кроме интеграционных механизмов, у вас может возникнуть и другая проблема: сам модуль опирается на определенным образом заполненные данные. И эти правила также могут меняться и регулярно меняются.

Итак, в процессе «борьбы с обновлениями» вы справились с платформой, с модулем, а потом натыкаетесь еще и на ошибку, которая идет от неверного формата данных. Оказывается, заполнять их также надо определенным, причем, неявным образом. Вспомните, как я в своем примере указывал необходимость поставить «галочку» на стороне 1С Битрикс, о которой я, к счастью, знал. А иначе бы время работы над настройкой обмена еще больше затянулось бы. И нигде в документации об этой самой «галочке» не сказано ни слова!

В принципе, если вы используете типовой обмен, то стоит прислушаться к тому, что говорит сам 1С Битрикс словами администратора: – не обновляйтесь (в то время как 1с говорит – обновляйтесь)

Если вы хотите все-таки использовать типовой модуль, последовательность ваших действий должна быть такой:

Проверили версию платформу
Проверили версию конфигурации
Проверили версию модуля.
Проверили все базы данных, убедились, что данные подхватываются.
Проверили соответствие версий 1С Битрикс и программного продукта 1С.
Проверили целостность баз данных, если они файловые.

Скорей всего, в процессе выполнения этих действий обнаружится ошибка. Кроме того, очень важно помнить:Ни в коем случае не дорабатывайте типовой обмен.

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

Как видите, интеграция программных продуктов 1С и сайтов Битрикс – занятие достаточно сложное, требующее внимательности, чаще всего, опыта, и даже он не всегда помогает. К сожалению, помощь по новым багам, которые достаточно стабильно приходят взамен старым, реально найти только на форумах. Именно по этой причине я предпочитаю писать обмен самостоятельно. Но если необходимость возникает, то и решение найдется (я надеюсь).

habr.com

Интеграция Битрикс24 с 1С, сайтом или другими системами

Что	Для чего	Как	Трудоёмкость	Ограничения
Выгрузка товаров из 1С в CRM	Товары и цены в Bitrix24 всегда актуальны. Не надо переносить их «руками».	«Из коробки». Установка дополнительных модулей в 1С или Bitrix24 не требуется	2 – 4 часа	Начиная с тарифа «Команда»
Выгрузка остатков товаров из 1С в CRM	Чтобы менеджеры в Б24 видели актуальные остатки	Через дополнительные реквизиты у товаров. Понадобится написание обработки со стороны 1С	2 – 4 часа	Начиная с тарифа «Команда», стоимость написания обработки уточнять у 1С-программиста
Выгрузка контрагентов из 1С в Битрикс24	Быстрый перенос базы клиентов в Б24 Можно настроить регулярную выгрузку	С помощью модуля «1С:Треккер Битрикс24»	8 – 10 часов	Потребуется установка и настройка модуля «1С:Треккер Битрикс24» в вашу 1С
Выгрузка контрагентов из 1С в CRM с помощью .csv	Быстрый перенос базы клиентов в Битрикс24		4 – 8 часов	Ручной механизм
Обмен счетами между 1С:Бухгалтерия и Битрикс24. Передача статусов счетов.	Менеджеры работают в CRM, бухгалтерия в 1С. Обмен счетами происходит автоматически.	Внешняя обработка для 1С.	25 000 руб.4 - 8 часов на внедрение	Частичная оплата не поддерживается. Только начиная с тарифа «Команда»
Загрузка «оффлайн» заказов из 1С в Bitrix24	Чтобы менеджеры видели данные об «оффлайновых» продажах или других операциях	С помощью модуля «1С:Треккер Битрикс24» Выгрузка в Дела CRM	4 – 8 часов	Потребуется установка модуля в 1С
Выгрузка структуры компании и сотрудников из 1С в Б24	Быстрый перенос структуры компании и сотрудников в коробочную версию корпоративного портала Б24	Модуль обмена		Реализована в модуле обмена для 1С-ЗУП и 1С-Комплексная автоматизация. Выгрузка только в коробочную редакцию корпоративного портала Потребуется установка модуля обмена в 1С
Выгрузка произвольных отчётов из 1С в ленту Б24	Отчёты о поступлении товара, задолженности клиентов и другая информация для руководителей и сотрудников	Модуль «1С + Битрикс24»	2 – 4 часа	Начиная с тарифа «Команда» Потребуется установка модуля в 1С
Любые нестандартные интеграции	Загрузка заказов в 1С; Выгрузка из 1С компаний, контрагентов и сделок с сохранением связей; Выгрузка контрагентов в 1С из Bitrix24; Обмен любыми справочниками и сущностями между 1С и Б24;	«Вебхуки» и программирование на стороне 1С с использованием REST Api Bitrix24	От 20 часов

www.intervolga.ru

Интеграция с Битрикс24

Битрикс24 — полный комплект инструментов для организации работы компании. В нем вы можете хранить всю информацию о ваших клиентах и заказах, объединять все каналы коммуникации с ними и анализировать результаты работы. А чтобы вы не потеряли ни одну заявку с вашего сайта, мы реализовали простую и легкую интеграцию решений Аспро с CRM-системой.

Внимание! Функционал доступен только для редакции 1С-Битрикс: Стандарт.

Примечание: Передавать файлы с сайта в CRM-систему нет возможности — этот функционал не реализован в 1С-Битрикс. Вопрос передан специалистам 1С-Битрикс и рассматривается для реализации в обновлении.

Благодаря интеграции с Битрикс24 вы можете передавать в CRM все заполненные веб-формы:

заказа звонка
запроса консультации
отправленного резюме
заданного вопроса
заказа услуги
заказа проекта
заказа продукта
сообщения директору
оформления заказа.

Настройка займет всего пару минут, а навыки программирования не потребуются.

Чтобы связать решение Аспро: Корпоративный сайт 2.0 с Битрикс24, достаточно настроить веб-формы, с которых нужно переправлять данные в CRM. Рассмотрим алгоритм настройки на примере формы заказа обратного звонка.

Перейдите в Рабочий стол → Сервисы → Веб-формы → Настройка форм. Для редактирования существующей формы вызовите меню кнопки «Гамбургер» и нажмите «Изменить».

Перейдите на вкладку «CRM». Здесь мы создадим новый список для веб-форм, которые будут передавать данные в Битрикс24. Это достаточно сделать один раз — при настройке остальных форм созданный список будет отображаться в перечне автоматически.

В перечне «CRM» выберите пункт «настроить новый».

В открывшемся окне укажите:

Название для нового списка (1);
Сервер CRM (2);

Параметры авторизации: логин и пароль (3).

Проверьте, установлено ли соединение. Для этого нажмите «Настроить список».

В настройках списка нажмите «Проверить соединение».

Если соединение установлено, в колонке «Авторизация» отобразится «ОК».

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

После того, как вы убедились в том, что соединение с CRM работает нормально, вернитесь на предыдущую страницу, где мы создавали список (нажмите кнопку «Назад» в меню браузера).

Определите способ отсылки данных с формы (1) – ручной или автоматический, и настройте связанные поля.

Ручной способ: рекомендуется использовать для снижения нагрузки на сайт. При таком способе отправлять данные в Битрикс24 нужно будет вручную. Как это сделать, написано ниже.

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

Связанные поля настраиваются следующим образом: в правой колонке (3) нужно выбрать, из какого поля формы будет отправлена запись в CRM, а в левой колонке (2) — какое поле CRM ее примет.

Сохраните изменения. Для проверки корректности настроек заполните и отправьте соответствующую форму из публичной части сайта. В нашем случае — это форма заказа звонка.

Если вы настроили отправку форм «вручную», то перед тем, как зайти в Битрикс24, просмотрите раздел «Результаты» в Рабочий стол → Сервисы → Веб-формы. Откройте список нужной формы.

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

Найдите строку с тестовыми данными (с данными формы, которые вы только что заполнили) и вызовите меню кнопки «Гамбургер» для отправки формы в CRM. После успешной отправки записи в колонке «Отправлено» метка сменит цвет с красного на зеленый.

Если вы автоматически отправляете информацию о заполненных формах в CRM, сразу перейдите в Битрикс24. Здесь в левом меню на вкладке «CRM» (1) появится новый лид (2).

В подробной информации вы увидите данные, которые указали на сайте.

Остальные веб-формы настраиваются аналогично.

aspro.ru

Интеграция Битрикс24 с сервисами

54 сервисов, которые можно подключить к Битрикс24.

Сервисы email рассылок

Управление контекстной рекламой

Коллтрекинг сервисы

Онлайн-консультанты

Почтовые сервисы

Документы и файлы

Платежные системы

Сервисы приема платежей

Сервисы для учета времени

Социальные сети

Конструкторы сайтов

Рейтинг лучших систем управления взаимоотношениями с клиентами.

crmindex.ru

интеграция «Битрикс24» с Asterisk / Блог компании 1С-Битрикс / Хабр

Сегодня жизненно необходима интеграция CRM и телефонии. Если клиент слишком долго слушает автоматическое приветствие или вы не перезваниваете по оставленной им на сайте заявке — вы его потеряете.

Как мы, компания-интегратор informUnity, пришли к созданию массового продукта для интеграции «Битрикс24» и Asterisk под управлением FreePBX, и что из этого вышло — под катом.

Предыстория

К концу 2016 года у нас было практически готовое решение для контакт-центров на базе коробочного «Битрикс24» и Asterisk. Практически — потому что используемый для обработки WebRTC в браузере форк SIPML5 еще не был отлажен.

Мы уже планировали финальное тестирование и запуск тиражируемого продукта, когда в декабре появилась поддержка телефонии в REST API «Битрикс24». А вместе с ней коллегам понадобилось интегрировать Asterisk и «Битрикс24» с помощью новых REST-методов.

Тем временем потребность в такой интеграции как раз назрела. Связка через VoxImplant включала лишнее звено, требовала «танцев с бубном» в настройке и лишала «астерискеров» свободы. Так как часть логики обработки звонка вместе с SIP трафиком отдавалась во внешнюю систему.

Мы решили, что контакт-центры подождут. Мы выполняем конкретный заказ. По результатам которого готовим продукт по интеграции для всех желающих.

MVP

Оказалось, что у коллег используется целых три Asterisk:

один с кастомными контекстами
два подключенных к первому

Это затрудняло по сути несложную задачу:

определить ответственного
открыть карточку
записать звонок в CRM

Действительно несложная, — скажете вы. Часа на четыре работы. Так и есть: если пишете для себя, то можно ограничиться только нужными вам сценариями. Но любой шаг в сторону добавляет очередные четыре часа. Однако, мы делали для всех. Значит наша цель — не легкий путь для разработчика. А легкий путь для пользователя. За основу решения выбрали фреймворк FreePBX v.13. Он самый популярный среди аналогов на сегодняшний день. Активно развивается и включает все необходимое для нашего решения.

Основную часть мы оформили как модуль для FreePBX.

Плюсы тринадцатой версии FreePBX:

современный интерфейс
удобные оповещения при настройке модуля
поддержка AJAX и
простой процесс обновления модуля с изменением структуры таблиц

Самое важное для работы модуля —определить соответствующие контексты для интеграции. Ведь у каждого клиента своя схема обработки вызовов.

Сегодня основная работа идет с контекстами ext-did-001, ext-did-002 и macro-dial-one для входящих звонков и outrt-, macro-dialout-trunk — для исходящих.

За два месяца Asterisk и «Битрикс24» были интегрированы. CRM «Битрикс24» теперь следит всевидящим оком за входящими и исходящими звонками.

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

Первые результаты

Создавая MVP, мы ориентировались на простую и прозрачную логику. Например, время начала и конца разговора привязано к каналу внешнего абонента (при входящем — первый открывшийся канал, при исходящем — канал, на котором находится вызываемый номер). В беклог MVP не вошла поддержка Ring Groups и FollowMe. Но это не повлияло на функциональность, так как они заменяются на Queues. Результат не заставил себя долго ждать: с первых дней мы получаем 15–20 установок в день. Для нас это была проверка гипотезы. Первая бета-версия представляла из себя достаточно сырой MVP. Поэтому такой результат придал нам сил и уверенности. А вместе с уверенностью пришел и шквал вопросов на первую линию.

С заботой о пользователях

Большинство установок Asterisk отрезаны от мира и спокойно работают за NAT. Тем не менее, получать от сисадминов десятки вопросов о том, как настраивать Firewall для интеграции, было весьма удивительно.

«Проброс портов? Конечно слышали. А что пробрасывать? Куда? Зачем?».

Проблема оказалась не в квалификации пользователей. А в подаче информации. И поправками в инструкцию тут не отделаешься. Подобные вопросы практически прекратились после переработки интерфейса. Считается, что сисадмину не важно, с каким интерфейсом работать. Эта точка зрения не выдержала проверки практикой. Неважно, кто пользователь — сисадмин или домохозяйка. Чем проще и понятней интерфейс, тем больше лояльности к приложению. При этом сделать интерфейс простым — невероятно сложно. Особенно с учётом регулярных изменений. В период бета-тестирования мы старались выпускать не меньше одного обновления в неделю.

Эволюция интерфейса модуля Каждую неделю добавлялась новая функциональность, изменялась внутренняя логика. Продукт развивался невероятно быстро. Собранная за неделю аналитика становилась неактуальной с выходом новой версии. Иногда технические нововведения опережали изменения в интерфейсе. Тогда приходилось править или полностью пересматривать пользовательские сценарии. Это приводило к серьёзным изменениям интерфейса.

Высокая динамика разработки накладывает ограничения на проектирование интерфейсов. Мы поставили перед собой амбициозную задачу — сделать удобное приложение для связки «Битрикс24» с Asterisk. И мы справились — теперь «подружить» их сможет любой желающий.

Вместо послесловия

За полтора месяца бета-тестирования мы проверили множество гипотез и реализовали десятки сценариев. Это заслуга службы поддержки. Мы сразу отказались от тикетов и электронной почты. Такая переписка не предполагает быстрой реакции. А рассмотрение одного простого вопроса может затянуться на несколько дней.

Нам очень помогли открытые линии в «Битрикс24». И мы, и клиенты пользуемся одним продуктом. Клиент всегда может найти нашу открытую линию в списке своих чатов и посмотреть всю историю переписки. Мы получаем задачи, внутренние коммуникации и общение с клиентом в одной экосистеме. Благодаря такому формату клиенты получают ответ на обращение в среднем в течение трёх минут. А клиент доволен поддержкой и охотно делится не только проблемами, но и идеями по улучшению продукта. С выходом stable-версии нам пришлось искусственно снижать динамику в пользу качества: ответственность перед коммерческими пользователями не дает экспериментировать в прежних масштабах.

Сборку и тестирование, а также установку и работу модуля в Docker-контейнерах, автоматизировали на базе GitLab CI (об этом планируем написать отдельно). Обновления стараемся выпускать раз в неделю, но все эксперименты вынесли в ветку beta. Кстати, приглашаем к сотрудничеству бета-тестеров.

На этом и сказке конец, но история нашего решения только начинается. Сам продукт: ссылка.

habr.com

Интеграция онлайн-консультанта Webim с Битрикс24

Битрикс24 - это популярный российский онлайн-сервис для управления мелкими и средними предприятиями, полностью находящийся "в облаке" и расширяемый с помощью дополнительных "приложений". Одним из основных механизмов Битрикс24 является собственная служба CRM ("Управление продажами").

Сервис Webim умеет интегрироваться со службой CRM Битрикс24.

Содержание:

Зачем нужна интеграция

Интеграция лежит в плоскости службы CRM этой популярной платформы. Результатом интеграции становится автоматическое добавление посетителей Вашего веб-сайта и история диалогов с ними из сервиса Webim в качестве контактов и лидов системы Управления продажами Битрикс24 (CRM).

Если у Вас есть учётная запись в сервисах Webim и Битрикс24, интеграция подключена и настроена, то Ваши операторы и администраторы могут использовать Битрикс24 CRM как единый интерфейс, в котором будут собраны потенциальные клиенты, привлечённые как через чат Webim, так и по другим каналам.

Функциональность интеграции Webim с Битрикс24 доступна всем нашим пользователям, работает без дополнительной платы, на всех тарифах, никаких специальных запросов в службу поддержки отправлять не нужно.

Инструкция по настройке

Для успешной интеграции сервисов Webim и Битрикс24 выполните следующую последовательность шагов:

Проверьте, что у Вас есть действующие учётные записи в обоих сервисах.
Откройте личный кабинет сервиса Битрикс24.
Проверьте, что в Битрикс24 подключена функциональность CRM ("Управление продажами"): Служба управления продажами (CRM) Битрикс24:
Выберите в меню слева пункт Приложения: Переход к дополнительным приложениям Битрикс24:
В строке поиска приложений наберите Webim. Поиск выдаст виджет с приложением сервиса Webim: Виджет с приложением Webim в Битрикс24:

Вы также можете перейти к нашему приложению по прямой постоянной ссылке.
Выберите виджет Webim и нажмите Установить: Установка виджета Webim:
Откроется форма настроек Webim. Оставьте значения по умолчанию и нажмите Установить: Форма настроек приложения Webim:
На странице Приложения / Покупки появится приложение Webim: Приложение Webim среди покупок в Битрикс24:
Теперь откройте в другой вкладке браузера административный интерфейс администратора сервиса Webim. Выберите блок Общие настройки, раздел Интеграция / Битрикс24: Настройки интеграции Webim и Битрикс24:
В поле Доменное имя Вашего портала Bitrix24 введите свой домен на Битрикс24 в формате mycompany.bitrix24.ru. Мы также рекомендуем установить флажок Сохранять чаты.
Нажмите кнопку Авторизация. Webim начнёт процесс подключения к Вашему порталу на Битрикс24. Это может занять несколько минут.В случае успеха страница настроек интеграции закроется и откроется страница настроек компании.В случае ошибки откроется сообщение об ошибке:

Ошибка авторизации Webim на портале Битрикс24:

Теперь после завершения диалога в сервисе Webim контактная информация и сообщения из чата будут переправляться в сервис Битрикс24 и сохраняться в базе данных.

Как использовать интеграцию

После того как интеграция настроена, можно будет увидеть все события, которые произошли в сервисе Webim (новые диалоги, контакты и т. п.) в интерфейсе CRM Битрикс24 в ленте:

Лента CRM Битрикс24 с событиями из Webim:

и в истории:

История CRM Битрикс24 с событиями из Webim:

Подробную информацию можно увидеть в Лидах и Контактах:

Список лидов Битрикс24 с данными из Webim:

Лиды, сохраняемые в разделе CRM Битрикс24 сервисом Webim, все имеют название Webim Chat. Источник лидов, зарегистрированных через Webim, указывается как Веб-сайт:

Подробно лид в CRM Битрикс24 из сервиса Webim:

Данные лида обновляются по окончании диалога.

Контакты CRM Битрикс24 содержат сведения о посетителях Вашего сайта, общавшихся с операторами через веб- или мобильный чат через Webim:

Контакты Битрикс24 c данными пользователей из Webim:

В базе данных Битрикс24 сохраняется следующая информация (если она оказалась доступна сервису Webim):

имя посетителя (Контакт - Имя),
адрес электронной почты (Контакт - E-mail),
контактный телефон (Контакт - Телефон),
имя оператора, общавшегося с посетителем,
история диалога, включая произошедшие события, геоинформацию, адреса открытых страниц и текст переписки.

Информация из последних пунктов этого списка сохраняется внутри поля Контакт - Комментарий.

Подробная информация внутри контактов:

Подробности контакта в Битрикс24:

Данные контактов в Битрикс24 обновляются сразу после получения новой информации о пользователе сервисом Webim.

Битрикс24 будет показывать уведомления о новых лидах, поступивших из Webim, примерно в таком виде:

Уведомления Битрикс24 о новых лидах из Webim:

Вернуться к главной странице документации

webim.ru

Интеграция с CRM Битрикс24

В релизе новой версии программы нами была добавлена функция интеграции онлайн- консультанта JivoSite с Битрикс24: CRM. Такая интеграция позволяет не только связывать контактные данные пользователя и подгружать их из базы данных, но и экспортировать все диалоги с пользователями в CRM.

Как настроить интеграцию JivoSite и Битрикс24: CRM

Первоначально вам необходимо зайти в свой аккаунт Битрикс24, перейти к вкладке «Все приложения» и установить приложение JivoSite. Его можно найти через поиск, это абсолютно бесплатно.

Yntegratsyia_s_crm_bytryks241

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

Yntegratsyia_s_crm_bytryks242

При нажатии на клавишу «Подключить» система предложит ввести ваш аккаунт Битрикс24. Аккаунт вводится следующим образом: https://tester.bitrix24.ru. Убедитесь, что вы удалили «/» в конце URL.

Yntegratsyia_s_crm_bytryks243

После связывания аккаунта JivoSite и аккаунта Битрикс24 вы получите уведомление с надписью «Подключено».

Yntegratsyia_s_crm_bytryks244

Yntegratsyia_s_crm_bytryks245

Как связать клиента с CRM

Когда вам пишет пользователь, в правом углу приложения оператора у вас появляется кнопка «LINK TO CRM». При нажатии на неё, вам будет предложено вставить ссылку на карточку клиента из CRM.

Вам необходимо открыть Битрикс24, перейти в раздел «CRM – Лиды». Далее открыть карточку существующего клиента либо создать нового клиента (лида) и скопировать его URL из CRM.

Yntegratsyia_s_crm_bytryks246

Также есть автоматическое создание карточки клиента (лида), если посетитель указал email или номер телефона во время чата с оператором.

После того, как вы вставите данный URL в приложение оператора, релевантные данные загрузятся из карточки клиента Битрикс24: CRM.

Yntegratsyia_s_crm_bytryks247 В конце беседы данный диалог сохранится в карточке клиента в ленте событий.

Yntegratsyia_s_crm_bytryks248

Альтернативная версия интеграции

Наши партнеры из компании Косас сделали альтернативную интеграцию Битрикс24 с сервисом JivoSite. Более подробно ознакомиться с ней можно на сайте партнера

Данное приложение автоматически передаёт историю разговора оператора чата JivoSite в CRM-систему Битрикс24. Решение является очень глубокой интеграцией данных систем с использованием “искусственного интеллекта”, который будет предотвращать нештатные ситуации и помогать сохранять беседу с клиентом в нужное место.

Для кого данное приложение

Для компаний, которые выстраивают техподдержку пользователей с помощью Jivosite;
Для компаний, которые контролируют все контакты с клиентами и хотят собирать данные в CRM-системе для последующего анализа;
Для тех, кто собирает всю статистику обращений из разных источников в компанию в CRM системе Битрикс24;
Для тех кто, устал от ручных манипуляций и хочет МАКСИМАЛЬНОЙ и умной автоматизации.

Установка приложения

После нажатия кнопки “Попробовать” в Маркеплейсе Битрикс24, приложение автоматически установится на ваш портал.

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

1.Откройте приложение “Продуктивный Jivosite” в Вашем Битрикс24 ископируйте (CTRL+C) ссылку из поля “Ссылка для WebHooks JivoSite”.

2.После этого, зайдите в административную часть сайта Jivosite и произведите настройку интеграции с установленным приложением.

3.Для этого, в разделе “Настройки интеграции для разработчиков” вставьте (CTRL+V) ранее скопированную ссылку в два поля “Безопасный URL” и “URL для Webhooks”.

4.Обязательно включите Webhooks.

5.Сохраните настройки.

Теперь работа с существующей клиентской базой станет удобней.