Bitrix24 исходящий вебхук не работает

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

Начальные требования к подготовке

Для успешного изучения курса и овладения мастерством работы с собственными приложениями для Битрикс24 необходимо владеть (хотя бы на начальном уровне):

основами PHP;
основами HTML, CSS;
опытом работы с API и REST API.

Курс учебный, контрольные тесты и сертификация по нему не предусмотрены.

Баллы опыта

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

уроке.

Периодически мы заново оцениваем сложность уроков, увеличивая/уменьшая число баллов, поэтому итоговое количество набранных Вами баллов может отличаться от максимально возможного. Не переживайте! Отличный результат — это если общее число набранных Вами баллов отличается от максимального на 1-2%.

На каждой странице курса авторизованный на сайте посетитель может дать комментарий к содержимому страницы. Комментарий — не форум, там не ведётся обсуждений или разъяснений. Это инструмент для сообщений нам об ошибках, неточностях. Для отправки комментария воспользуйтесь расположенной в правом нижнем углу окна браузера кнопкой:

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

Источник

Быстрая интеграция с Битрикс24 или волшебные вебхуки!

Как вы наверняка знаете, в Битрикс24 существует довольно обширный REST API, который позволяет добавлять функционал в облачный Битрикс24, а также создавать всевозможные интеграции с внешними системами. Используя методы REST вы можете создавать и модифицировать объекты CRM, задачи, публиковать сообщения в живую ленту и вообще, делать практически все, что угодно.

Но до недавнего времени существовало в этой идиллии одно небольшое «но», а именно, необходимость в реализации хитрого протокола авторизации OAuth 2.0. Несмотря на то, что этот протокол существует давно и используется многими игроками рынка, он все еще вызывает у разработчиков сложности в реализации «с нуля», а кроме того, имеет неприятное ограничение – если вам необходим постоянный автоматический обмен данными с Битрикс24 без участия пользователя, то из-за требований OAuth вам придется организовывать периодическое обновление авторизационных токенов, чтобы они «не протухли».

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

Я рад сообщить, что мы внедрили простой механизм интеграций с Битрикс24, который прекрасно подходит для использования in-house. Речь идет о всем известных вебхуках. А даже если и не всем известных, то многим

Это механизм, который позволяет вам использовать практически весь наш богатый REST API, но при этом не заморачиваться с OAuth 2.0.

Показать скрытое содержимое

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

Мы просто идем в раздел Приложения – Вебхуки, нажимаем кнопку «Добавить вебхук»

выбираем тип «Входящий вебхук» (ведь мы хотим из внешнего источника обращаться к Битрикс24, верно?) и видим форму редактирования параметров вебхука.

Указываем понятное нам самим название и описание вебхука, включаем галочку прав к нужному нам модулю Битрикс24. В данном случае нам нужен CRM, поскольку мы собираемся добавлять лиды.

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

Как ни удивительно, но это все, что нам нужно.

Разберем предложенный URL:

Идентификатор пользователя, пользуясь правами которого будет работать вебхук. Очевидно, что вставляется идентификатор пользователя, который вебхук и создал только что.
Код вебхука. Строго секретно. Не стоит публиковать его в Facebook.
Метод REST, который вы хотите выполнить, обращаясь к вебхуку. В качестве примера подставляется базовый метод profile, но нам потребуется метод crm.lead.add

То есть, все сводится к тому, что мы должны «дернуть» с параметрами нужный нам URL, который уже сформировали за нас практически целиком (поменять остается только название метода), вот и вся наука.

Что значит «дернуть»? Например, это можно сделать вот так

Поясню важные моменты. Во-первых, не надо делать веб-формы так, как в этом примере – они будут такие же кривые и небезопасные . Во-вторых, вся интеграция с Битрикс24 сводится к простым шагам: сформировали url в переменной $queryUrl, сформировали параметры для создания лида в переменной $queryData (почитайте описание параметров в документации ) и после нехитрых подготовительных шагов как раз и «дернули Битрикс24» при помощи функции curl_exec. Полученный в виде JSON результат обработали и вот оно счастье. Ничего больше не нужно. Еще раз про три простых шага:

Получили практически готовый URL из формы добавления вебхука прямо в своем Битрикс24.
Указали в этом URL нужный метод REST API и сформировали параметры с данными.
Запросили Битрикс24 по сформированному URL

Зайдите на форму, заполните все поля и после сохранения вы обнаружите в своем Битрикс24 новый лид (или получите сообщение об ошибке прямо над формой).

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

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

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

В обработчике пишем исключительно простой код – тупо логируем все, что к нам приходит.

Если теперь мы откроем любую сделку на редактирование и сохраним изменения, то обнаружим в логе вот такую историю:

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

Вебхуки представляются нам настолько простыми и полезными для решения оперативных вопросов, что мы включили этот функционал еще и в CRM-роботов!

Идем в настройки CRM, выбираем пункт Автоматизация и там нажимаем в кнопку «Сделки».

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

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

Для простоты давайте передадим туда в явном виде стадию сделки

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

Источник

Bitrix24 исходящий вебхук не работает

Начальные требования к подготовке

основами PHP;
основами HTML, CSS;
опытом работы с API и REST API.

Курс учебный, контрольные тесты и сертификация по нему не предусмотрены.

Баллы опыта

уроке.

Источник

Вебхуки Битрикс24

В Bitrix24 присутствует достаточно просторный REST API, позволяющий расширить типовой функционал облачного Битрикса и производить различные интеграции со сторонними системами. Взаимодействуя с его методами у вас есть возможность создания и различной модификации объектов CRM, задач, публикаций сообщений в «живой ленте» и, фактически, реализации всего, что угодно.

Любая современная организация прибегает к интеграции с внешними сервисами.

Самый бесхитростный путь создания качественной связи – это интеграция собственного корпоративного портала. Вопрос лишь в том, как правильно это осуществить? Конечно, для таких целей есть REST API, позволяющий дополнять функционал облачного Bitrix, но взаимодействие с ним — задача далеко не из лёгких и требует достаточной квалификации со стороны разработчиков.

Однако у вас есть отличная возможность организовать единую связь портала Bitrix с внешними сервисами или отдельными формами без огромных затрат на программирование. Производить трансляцию отчётов из ваших складских систем прямиком в «живую ленту» можно при помощи webhook Битрикс24!

Это простой вариант REST-команд и событий, который не требует дополнительного написания приложений.

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

Создание вебхуков Битрикс24

Примеры для входящих и исходящих. Для создания webhooks нужно перейти во вкладку «Приложения» (в левом меню), затем выбрать «Вебхуки».

Создание входящих webhooks

Необходимо нажать на «Добавить вебхук» и выбрать «Входящий вебхук».
В появившемся окне нужно заполнить все необходимые поля:

— «Название» и «Описание»;

— «Права доступа» — необходимо указать, к каким модулями Webhook должен получать доступ.

При сохранении будет доступен код авторизации.

Комбинация авторизации должна находиться в строгой конфиденциальности!

Помимо кода вам будет предоставлен пример URL, для вызова REST:

Более подробно:

******* — наименование корпоративного портала.

/rest/ — подтверждение того, что этот адрес относиться к Битрикс24 вебхукам.

/313/ — определитель пользователя, который создал webhook.

/seycsj9qf5hbgrua/ — секретный код.

/profile/ — метод REST, выполняемый вами, когда вы прибегаете к использованию webhooks. Разработчик должен самостоятельно заняться подбором данного метода. Он будет напрямую зависеть от конечной цели создания webhook Битрикс24.

Необходимо подать программное обращение со стороны другой системы по введённому адресу на Bitrix.

Создание исходящих webhooks

Необходимо нажать на «Добавить вебхук» и выбрать «Исходящий вебхук».
В появившемся окне нужно заполнить все необходимые поля:

— «Адрес обработчика» — Наименование страницы стороннего ресурса, куда будет направлен webhook;

— «Название» и «Описание»;

— «Тип событий» — Здесь необходимо прописать то событие, на котором будет запускаться вебхук.

При сохранении будет доступен код авторизации.

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

Если после прочтения данной статьи у вас остались вопросы – то наша команда с радостью ответит на них в чате или по номеру (812) 363-17-87. Также у нас на сайте вы сможете найти более подробную информацию о наших услугах по внедрению Битрикс24.

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

Источник