ћы в Telegram - чате. “ы с нами? :)

ћерион Ќетворкс

ћессенджеры с каждым днем все больше и больше интегрируютс€ в нашу жизнь. Ёто невольно наводит на мысль о Ђбесшовнойї интеграции мгновенных сообщений и бизнес инструментов. –азмышл€€ на этот счет, под наш исследовательский порыв попал попул€рный в –оссии мессенджер Telegram и CRM Ѕитрикс24.

Ќам захотелось присылать информацию о созданном лиде в Ѕитриксе в групповой чат Telegram. ћы написали небольшой скрипт на .php и адаптировали его на Linux Ц машине. „то из этого получилось, спешим рассказать :)


Ѕот в “елеграме

»так, первым делом создаем бота в “елеграме. ¬ нашей базе уже есть пошаговый материал по созданию бота, поэтому, нажмите на кнопку ниже и пройдите по ссылке. ¬ыполните все шаги, которые указаны в пункте Ђ—оздание бота в Telegramї - это займет примерно 5 минут.  ак сделаете, переходим к следующему пункту.


—крипт обработки

¬се ли получилось на этапе ранее? ” вас должен быть токен вида 331754110:AAHkMNalOz5I_Schh2kvj7ONhRcE8HuKV-c и ID (идентификатор) группового чата. ≈сли все на месте, то вашему вниманию предлагаетс€ сам скрипт (комментарии по ходу скрипта после двойного слеша //):

<?php
$token = "¬аш_токен"; // тут вводим ваш токен;
$chat_id = "ID_чата"; // указываем идентификатор группового чата
$lead_name=$_GET['name']; //получает методом GET название лида, ответственного, источник и его идентификатор;
$lead_respons=$_GET['respons'];
$lead_source=$_GET['source'];
$lead_link=$_GET['link'];
$lead_link1 = "https://ваш_домен_битрикс.bitrix24.ru/crm/lead/show/$lead_link/"; // данную конструкцию мы используем дл€ того, чтобы корректно сформировать и отправить ссылку на лида в Telegram;
#ќправл€ем в телеграм
$hello = "<b>«дравствуйте, коллеги!</b>"; // формируем элементы массива (сообщени€), который будем отправл€ть в сторону Telegram Ц API;
$hello_1 = "";
$message = "¬ CRM Ѕитрикс24 добавлен новый лид -  ";
$repons = "ќтветственный - ";
$src= "»сточник - ";
$link = "—сылка - ";
$arr = array( // формируем сам массив;
$hello => $hello_1,
$message => $lead_name,
$repons => $lead_respons,
$src => $lead_source,
$link => $lead_link1,
);
foreach($arr as $key => $value) {
if ($key == "—сылка - ") { $txt .= "".$key." ".$value."%0A";} else {
$txt .= "".$key." ".$value."%0A";
}};
fopen("https://api.telegram.org/bot{$token}/sendMessage?chat_id={$chat_id}&parse_mode=html&text={$txt}","r"); // отправл€ем данные в сторону API “елеграма;
?>

—качать скрипт

ѕосле загрузки скрипта по ссылке, смените его расширение на .php

ѕодставл€ем свои данные, сохран€ем скрипт как bitrixtelegram.php и закидываем его в WEB - директорию вашего сервера (сервера в вашей сети). Ќа нашем сервере мы используем web Ц сервер Apache на базе CentOS Ц наша директори€ /var/www/html/.

¬ажно! —крипт должен быть доступен по web из внешней сети (Ѕитрикс24 будет обращатьс€ к нему из бизнес Ц процесса). ћы рекомендуем использовать https, засекьюрить директорию, внутри которой будет находитьс€ скрипт (например, дать ей им€ v2I7TD9w3zo9QR7vg6ApNwDVvJOj9XbO61OJKdIyxI6d0. “ем самым, полный путь до директории будет /var/www/html/v2I7TD9w3zo9QR7vg6ApNwDVvJOj9XbO61OJKdIyxI6d0). ѕомимо этого, рекомендуем ограничить подключение к этой директории фильтрацией по IP (на уровне web Ц сервера и фаервола/маршрутизатора на уровне L3).

ѕосле этого, в консоли сервера, в случае Linux, даем команды (путь к файлу скрипта у вас может отличатьс€):

chmod 755 /var/www/html/v2I7TD9w3zo9QR7vg6ApNwDVvJOj9XbO61OJKdIyxI6d0/bitrixtelegram.php
dos2unix /var/www/html/v2I7TD9w3zo9QR7vg6ApNwDVvJOj9XbO61OJKdIyxI6d0/bitrixtelegram.php

јдаптаци€ в бизнес Ц процесс в Ѕитрикс24

ƒа Ц да, мы будем использовать вебхуки (Webhook). Ёто отличное средство, которое позвол€ет внедр€ть кастомные сценарии в обработку любой сущности в рамках Ѕитрикс24. ѕо факту, Ѕитрикс просто будет кидать GET - запрос.

ѕереходим к настройке. ќткрываем CRMЌастройкијвтоматизаци€Ѕизнес - процессыЋидƒобавить шаблон:

»нтеграци€ Ѕитрикс24 и Telegram из бизнес - процессов

ƒаем им€ шаблону и указываем параметры запуска Ц Ђѕри добавленииї. ¬нутри самого бизнес процесса, из правой палитры инструментов перетаскиваем элемент Webhook:

ƒобавление Webhook в бизнес Ц процессах Ѕитрикс24

¬ настройка вебхука, в поле в хендлер копируем следующую конструкцию:

https://telegram.merionet.ru/ v2I7TD9w3zo9QR7vg6ApNwDVvJOj9XbO61OJKdIyxI6d0/ bitrixtelegram.php?name={=Document:TITLE}&respons={=Document:ASSIGNED_BY_PRINTABLE}&source={=Document:SOURCE_ID}&link={=Document:ID}

√де:

  1. https://telegram.merionet.ru - хостова€ часть, на которой расположилс€ наш скрипт;
  2. v2I7TD9w3zo9QR7vg6ApNwDVvJOj9XbO61OJKdIyxI6d0 - директори€ в корне web Ц сервера, в которой лежит скрипт;
  3. bitrixtelegram.php - сам скрипт;
  4. ?name={=Document:TITLE}&respons={=Document:ASSIGNED_BY_PRINTABLE}&source={=Document:SOURCE_ID}&link={=Document:ID} - параметры, которые мы будем передавать в скрипт, а именно Ц им€ лида, источник, ответственный и ID - лида;
Ќастроенный Webhook в Ѕитрикс24

ѕровер€ем :) ¬ручную добавл€ем лид в CRM:

ѕроверка интеграции “елеграм и Ѕитрикс

» вот что ждет нас в Telegram:

—ообщение о созданном лиде в Ѕитрикс24 в Telegram

ѕолезна ли ¬ам эта стать€?

–аз в неделю мы отправл€ем дайджест с самыми интересными стать€ми.

P.S. ≈сли укажите свою дату рождени€, то мы об€зательно ¬ас поздравим и подарим небольшой подарок :)

Ќажима€ на кнопку "ѕодписатьс€", вы даете согласие на обработку своих персональных данных