Уведомления в мессенджеры (Telegram и WhatsApp)

Бизнес-процессы позволяют отправлять любые уведомления по любым действиям и изменениям в карточках в личные сообщения внутри CRM, на электронную почту и любые мессенджеры, которые позволяют отправить сообщение, используя POST или GET запрос.

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

Отправка уведомлений сотруднику в Telegram

Для начала настройки вам необходимо создать бота в Telegram. 

Для создания нового бота необходимо зайти в Telegram и написать боту @BotFather команду “/newbot” 

В следующем сообщении для бота @BotFather  после отправки команды вам нужно будет написать название вашего бота. Название бота может быть в формате name_bot или namebot, где name - название для вашего бота.

После успешного создания бота от @BotFather придет сообщение, где будет указана ссылка на вашего бота и token, который необходим для отправки.

Следующим шагом вам необходимо узнать свой ID в Telegram. Самый простой способ это сделать - написать с нужного аккаунта боту @intrumgetid команду “/start”. В ответ от бота вы получите сообщение, которое будет содержать ID вашего аккаунта.  

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

Если вы планируете отправлять персональные уведомление в Telegram каждому сотруднику, то рекомендуется в карточке сотрудника создать дополнительное поле, в которое вы сможете записать ID аккаунта сотрудника в Telegram. 

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

Там создать поле с названием “Telegram ID” с типом “Текст”. 

После создания поле “Telegram ID” необходимо заполнить в карточке всех сотрудников, которые должны получать уведомления. 

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

Для примера сделаем уведомление на создание нового объекта. 

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

<?php
$token = "TelegramTokenBot";
$text = 'Создан новый объект'."\n".'ID Объекта: '.$stockid;
$data = [
    'text' => $text,
    'chat_id' => $telegramid
];
$result = file_get_contents("https://api.telegram.org/bot$token/sendMessage?" . http_build_query($data) );
if($result){
    return true;
} else false;
?>

Вместо “TelegramTokenBot” необходимо вписать Токен своего бота, который вам присыл @BotFather. 

В блок необходимо добавить переменные: $telegramid, $stockid 

Для $telegramid устанавливаем значение из первого блока с событием из Ответственный - Telegram ID.

Для $stockid назначением значение из первого блока с событием - ID - https://i.imgur.com/lirEqlD.png .

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

Для того, чтобы бот смог отправить сообщение агенту на его ID, агенту необходимо предварительно добавить бот в Telegram через поиск или перейти на бот по ссылке и активать диалог с ним командой “/start”. 

Отправка уведомлений сотруднику в WhatsApp.

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

В этом случае в дополнительных полях можно создать поле с названием “Телефон для  WhatsApp” с типом “Текст”. 

Общая схема бизнес-процесса сохраняется, меняется только вычисляемое выражение с отправкой на сервис. 

Рассмотрим несколько примеров под популярные сервисы для отправки сообщений в WhatsApp. 

Отправка сообщений WhatsApp через сервис chat-api.

Пример вычисляемого выражения 

<?php  
$text = 'Создан новый объект ID Объекта:'.$stockid;
 
$data = [
    'phone' => $phone, // Телефон получателя
    'body' => $text, // Сообщение 
];
$json = json_encode($data); 
$url = 'URL+token';
 
$options = stream_context_create(['http' => [
        'method'  => 'POST',
        'header'  => 'Content-type: application/json',
        'content' => $json
    ]
]);
 
$result = file_get_contents($url, false, $options);
return true;
?>

 Для переменной $phone необходимо назначить поле “Телефон для  WhatsApp” из карточки ответственного сотрудника. 

URL+token заменить на свой URL, который предоставляет сервис для вашего аккаунта.

Образец нужного URL от сервиса: https://api.chat-api.com/instance99999/sendMessage?token=qqQ2eXxXxXaeEe

Отправка сообщений WhatsApp через сервис semysms.

<?php
$text = 'Создан новый объект ID Объекта:'.$stockid;
 
  file_get_contents(
    'https://semysms.net/api/3/sms.php' . 
      '?token=XxXYyYXxXYyYXxXYyYyXxYxYxYXx' .
      '&device=999999' . 
      '&phone=' . $phone .
      '&msg=' . rawurlencode($text)
  );
 
return true;
?>

Вместо XxXYyYXxXYyYXxXYyYyXxYxYxYXx' вписать токен, который вы получаете от сервиса semysms, а вместо 999999' необходимо вписать полученный device id. 

Для переменной $phone необходимо назначить поле “Телефон для  WhatsApp” из карточки ответственного сотрудника. 

 

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