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

Кастомная интеграция Битрикс24 через API

Когда готового приложения в Маркетплейс нет, а связать системы нужно. Пишем решения, которые обмениваются данными с любым сервисом — если у него есть API и он отдаёт то, что нам требуется. Начинаем с проверки, возможно ли это в принципе.

Главное

Всё упирается в один вопрос: открыта ли дверь

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

Дверь открыта

У сервиса есть публичное API

Лучший вариант: документация открыта, методы описаны, доступ выдаётся самостоятельно. Дальше вопрос только в том, какие именно операции этот API позволяет.

Дверь закрыта, но есть

API не публичный — обращаемся в поддержку

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

Двери нет

API отсутствует или доступ не дают

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

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

Что уже связывали

Примеры задач из наших проектов

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

Таблицы и внешние базы данных

Обмен с Google Таблицами и подобными хранилищами. Обычно нужен там, где часть работы исторически ведётся в таблицах и отказаться от них сразу невозможно, — данные ходят в обе стороны.

Плавный переход без потери привычных инструментов

Аналитика и визуализация

Выгрузка данных в системы бизнес-аналитики — Power BI, Yandex DataLens и другие. Нужна, когда встроенных отчётов Битрикс24 не хватает или данные нужно сводить с другими источниками компании.

Отчётность, которой нет в штатных средствах

Отраслевые и государственные сервисы

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

Профильные данные прямо в CRM

Специализированные сервисы бизнеса

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

Каждый инструмент делает свою работу

Собственная логика на сервере

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

Когда штатных настроек не хватает

Личные кабинеты и сайты

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

Клиент видит то же, что и менеджер
Важная деталь

Наличие API ещё не значит, что можно всё

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

Проверяем не сам факт API, а конкретные методы

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

Получениезабрать данные из сервиса
Созданиезавести новую запись
Изменениеобновить существующую
Удалениеубрать запись

Поэтому формулировка задачи имеет значение. «Связать с таким-то сервисом» — это ещё не задача. Задача выглядит так: «когда в сделке меняется статус, обновить запись в том сервисе». Первое можно пообещать не глядя, второе — только после проверки методов.

Как проходит работа

Четыре этапа, первый из которых может всё остановить

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

  1. Этап 1

    Проверяем возможности API

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

  2. Этап 2

    Описываем логику обмена

    Что происходит, при каком событии и в какую сторону идут данные. Здесь же решаем, что считать источником истины при расхождении и что делать, если сервис недоступен. Эти вопросы важнее самого кода.

  3. Этап 3

    Разрабатываем и подключаем

    Пишем решение и связываем его с порталом через API. Логика выносится наружу, а не собирается нагромождением автоматизаций внутри Битрикс24 — так надёжнее и проще менять правила потом.

  4. Этап 4

    Тестируем на реальных данных

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

Честно

Три вещи, о которых говорим до договора

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

Возможности кастомной интеграции ограничены не нашей квалификацией, а тем, что разрешает вторая сторона. И повлиять на это нельзя.

Второе. Мы не делаем решений, которые имитируют работу человека в чужом интерфейсе. Такое иногда предлагают, когда API нет: программа заходит на сайт и нажимает кнопки вместо сотрудника. Это работает ровно до первого обновления сервиса, после чего ломается без предупреждения — и вы узнаёте об этом, когда данные перестали приходить неделю назад.

Третье. Кастомное решение нужно поддерживать. Сервисы меняют свои API, Битрикс24 обновляется, появляются новые требования. Мы говорим об этом заранее и закладываем в сопровождение: у собственной разработки не бывает состояния «сделали и забыли».

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

Вопросы

Что спрашивают про кастомные интеграции

Можно ли связать Битрикс24 с любым сервисом?

Только если у этого сервиса есть API и он разрешает нужные операции. Возможности самого Битрикс24 здесь почти не ограничивают — вопрос всегда во второй стороне. Если API публичный, работаем сразу. Если закрытый, пишем в поддержку сервиса и выясняем условия: иногда доступ дают бесплатно, иногда за деньги, иногда отказывают. Если API нет вовсе, интеграция невозможна.

Что делать, если у сервиса нет открытого API?

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

Почему вы не делаете парсинг вместо интеграции?

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

Сколько стоит кастомная интеграция?

Зависит от задачи, и назвать цену до разбора невозможно. На стоимость влияют объём передаваемых данных, число сценариев, необходимость двустороннего обмена и качество документации сервиса. Мы оцениваем работу после того, как проверили API и описали логику, — до этого любая цифра была бы выдуманной.

Кто будет поддерживать решение?

Мы, если вы остаётесь на сопровождении. Это не формальность: сервисы меняют свои API, Битрикс24 обновляется, и решение требует внимания. Передать поддержку вашему специалисту тоже можно — мы описываем логику и объясняем устройство, чтобы вы не зависели от нас навсегда.

А может, есть готовое приложение?

Это первое, что мы проверяем. В Маркетплейс Битрикс24 много решений, и часть задач, которые выглядят как разработка, закрываются подключением за час. Мы скажем об этом, даже когда вы пришли именно за кастомной интеграцией: готовое решение дешевле в работе и не требует поддержки с нашей стороны.

Следующий шаг

Проверим, возможна ли ваша интеграция

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