Совсем недавно мы интегрировали собственный сайт с Битрикс24 (облако). Мы хотели, чтобы заявки с сайта приходили и конвертировались в лиды в Битрикс24. Это можно сделать множеством разных способов. И этому даже посвящена целая статья от самих создателей. Поэтому на этом зацикливаться не будем. После нескольких тестов, мы заметили, что лиды то приходят, а вот уведомлений нет. Возник вопрос, а как уведомить о новом лиде в Битрикс24 то? Ведь, если брать стандартные формы системы, все происходит автоматически. Начали смотреть API и поняли, что на уведомления существует отдельный метод, который также требуется задействовать.
Создаем токен или вэбхук.
Для начала нам требуется создать токен или вэбхук. Мы будем рассматривать на примере вэбхука, но отличий между ними так таковых нет. Единственное, токен имеет срок жизни, а вэбхук создается в самой системе Битрикс24 в разделе «Приложения». Ну, приступим
- Находим в левом боковом меню — Приложения.
- В открывшейся вкладке в табуляции (или дополнительном верхнем меню по разделу) находим — Вебхуки
- Далее нам нужно добавить новый входящий вэбхук с правами доступа к «Чат и уведомления»
Если приглядеться, то рядом с названием прав вы увидите в скобочках латинские буквы. В нашем случае (im). Это название включаемого метода в Битрикс API.
После сохранения появится код для авторизации вебхука
Вы даже можете открыть пример URL у себя в браузере и уже получите первый ответ.
В данном запросе нас интересует окончание uri «profile/». Как вы понимаете это название применяемого метода в запросе. Данный метод позволяет получить базовую информации о текущем пользователе, т.е. о вас. О важности сохранения данного кода в конфиденциальности, надеемся, говорить нет смысла.
Со всеми методами вы можете ознакомиться по данной ссылке. Нас же, как уже упоминалось, интересует метод im.notify.
Открыв ссылку нас будет интересовать только таблица и параметры, с которыми работает данный метод. Примеры вас только смутят. Как видно из описания to — это id пользователя, который будет получать уведомление, message — само сообщение, ну и type — от кого сообщение (система или другой пользователь).
Давайте модернизируем немного наш пример URL и подставим в него наш метод, вместо profile, и наши параметры. Запись параметров осуществляется следующим образом. После названия метода мы ставим знак вопроса, вместо слэша, и перечисляем наши параметры с присвоенными значениями. Например, /rest/1/какой-то код/im.notify?to=1&message=Hello%20world&type=SYSTEM
В ответ сервер вам выдаст результат вида {«result»:7876,»time»: .., а в самом Б24 тот, кого вы указали в to (в данном случае пользователь с id = 1), получит Hello world.
Немного, но кодим
Поскольку я знаю php, буду писать на нем. Ничего сложного нет. Нам нужно просто осуществить данный запрос через сценарий, например, за счет функции file_get_contents.
Теперь каждый раз выполняя этот сценарий в вашу систему для пользователя to будет приходить уведомление от системы с текстом «Добавлен новый лид». В уведомлениях, кстати поддерживаются BB-коды (HTML не поддерживается). BB-коды вы можете найти в самом же Б24 в той же форме написания комментариев к задачам или просто в редакторе сообщения в чате