Подключение Telegram
Интеграция crm с Телеграм позволяет вести переписку с клиентами через мессенджер Телеграм из интерфейса crm. Переписку возможно вести как с одним клиентом, так и с группой.
Подключение возможно осуществить только с Телеграм-ботом, с личным аккаунтом осуществить интеграцию технически нереализуемо (Телеграм не позволяет интеграций с обычными аккаунтами пользователей).
Бота можно подключить как на весь аккаунт crm целиком, так и к каждому/нескольким филиалам отдельно.
Специфика работы Телеграм-бота такова, что он может отправить сообщение клиенту только после того, как клиент написал ему первым (т.е. бот не может первым написать сообщение кому-либо), либо подписался на бота.
Также стоит знать, что Телеграм работает по принципу одно подключение = 1 бот, поэтому, если ваш бот уже подключен к какому-либо сервису, необходимо создать нового бота.
Создание Телеграм-бота
Для создания нового бота перейдите в Телеграм и введите в поле поиска @BotFather - это бот от Телеграм, который создает новых ботов. Обратите внимание, что у официального бота Телеграм будет стоять синий подтверждающий знак возле имени в виде галочки.
![ecf4e56eac2e6b10e2e1b06e2e7d713b.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/ecf4e56eac2e6b10e2e1b06e2e7d713b.png)
Далее, выберите из списка или напишите в строке набора текста сообщения команду /newbot
![041e49f76c39379c841a775658949433.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/041e49f76c39379c841a775658949433.png)
Укажите имя бота — это имя будут видеть клиенты при общении с ботом.
![1b7e4c569bef57f597de3743731a5dfa.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/1b7e4c569bef57f597de3743731a5dfa.png)
Далее, задайте никнейм бота — по нему можно будет найти бота в Telegram. Никнейм должен быть уникальным и заканчиваться на слово «bot».
Если никнейм уже занят, Телеграм укажет это в ответном сообщении:
![cf828503e9dac83d7bf190794fafbb81.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/cf828503e9dac83d7bf190794fafbb81.png)
Нужно придумать другой никнейм для бота и указать его в сообщении. Когда бот успешно создан, Телеграм выдаст следующее сообщение:
![a52662146626e3e3d52b73329968ce81.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/a52662146626e3e3d52b73329968ce81.png)
Для подключения бота к crm вам понадобится токен, который указан в сообщении об успешном создании бота.
Скопируйте значение токена:
![9613b72970fda6aa1eaa61a24608fac1.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/9613b72970fda6aa1eaa61a24608fac1.png)
Боту можно загрузить фото профиля с помощью команды /setuserpic:
![060ad0824ca7e3470e799fe880f08383.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/060ad0824ca7e3470e799fe880f08383.png)
Изображение нужно загрузить в чат с BotFather нажатием на иконку скрепки:
![771c136868d492fd111430008b8e1058.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/771c136868d492fd111430008b8e1058.png)
При желании можно задать какое-либо описание бота, воспользовавшись командой /setdescription:
![042727303f3cf2460e1d10453c110df0.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/042727303f3cf2460e1d10453c110df0.png)
Описание бота также нужно отправить сообщением:
![4f46e03654fea3afdd2f58b2cdce9db5.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/4f46e03654fea3afdd2f58b2cdce9db5.png)
Описание бота будет отображаться для всех клиентов в окне переписки:
![d83a6938fcf0d67717fdaa897dfcd19c.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/d83a6938fcf0d67717fdaa897dfcd19c.png)
Подключение Телеграм-бота к crm
Если вы подключаете бота на весь аккаунт crm, перейдите в crm в раздел "Настройки" - "Интеграция" - вкладка "Мессенджеры" и выберите из списка Telegram:
![6773154792fc10a0092bdfa0c3d4939d.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/6773154792fc10a0092bdfa0c3d4939d.png)
Вставьте скопированный токен в одноименное поле в настройках:
![7e40f8d5744c521c2bbd776c7cdde7e9.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/7e40f8d5744c521c2bbd776c7cdde7e9.png)
Галочка "Активировать чат-бот" включает встроенного бота, который будет спрашивать номер телефона ученика и находить его в базе crm самостоятельно. Подробнее об этом будет описано ниже.
Для проверки соединения и настроек бота можно нажать на кнопку "Инфо" справа от поля для токена. Появится всплывающее окно со следующими данными:
![4e2677f248682f4eec31731775fd9f1b.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/4e2677f248682f4eec31731775fd9f1b.png)
Name: Имя бота, заданное при создании
Username: Никнейм бота, заданный при создании
Can read all group messages: Может ли бот видеть сообщения всех участников группы, если добавить его в группу. Подробнее об этом будет описано ниже.
Если вы подключаете бота только на один/некоторые филиалы в crm, токен нужно прописать не в общих настройках, а в карточке каждого филиала, к которому нужно подключить бот. Для этого перейдите в раздел "Компания" - "Филиалы" и кликните на название филиала, к которому необходимо подключить бот.
![cc7a0715e9d4d1c4c9886ecef0ffae83.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/cc7a0715e9d4d1c4c9886ecef0ffae83.png)
В карточке филиала нажмите "Мессенджеры":
![dc4f2562af4d6a213758fe6b070ca304.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/dc4f2562af4d6a213758fe6b070ca304.png)
Далее вставьте Токен бота в поле в открывшемся окне:
![0461b6c460b6e1cb7e8c1fbfb7a938ee.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/0461b6c460b6e1cb7e8c1fbfb7a938ee.png)
Принцип работы интеграции
Переписка с клиентом в Телеграме в crm происходит через интерфейс Чатов. Входящие сообщения клиентов распределяются по менеджерам в соответствии с алгоритмом, о котором можно прочитать в этой статье.
В crm Телеграм клиента закрепляется за его номером телефона. Когда клиент пишет в чат первый раз, в окне чатов у менеджера отображается имя клиента так, как оно указано в Телеграм.
Клиента необходимо идентифицировать, поэтому задача менеджера - уточнить телефон клиента и привязать Телеграм-чат к номеру телефона. Для этого нужно нажать на кнопку "Привязать к телефону":
![77678c8b15ab809d76e092dd2ddde33a.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/77678c8b15ab809d76e092dd2ddde33a.png)
Далее необходимо вписать номер клиента в одноименном поле и сохранить:
![ed8ad56b747c8ca67052f7a294a621c2.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/ed8ad56b747c8ca67052f7a294a621c2.png)
Если номер телефона есть в CRM, система найдёт такого пользователя и предложит его выбрать:
![d06de2b2608db1dd30082b53702c236b.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/d06de2b2608db1dd30082b53702c236b.png)
Чтобы привязать переписку в Telegram без номера телефона к существующему ученику, нужно будет тоже нажать "Привязать к телефону" и ввести мобильный номер этого существующего ученика.
Если данного номера не указано ни у одного пользователя в crm, система предложит создать новый лид:
![a48f44d6b8303ebf39f06a6f7933552e.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/a48f44d6b8303ebf39f06a6f7933552e.png)
При добавлении нового лида из окна чата номер телефона автоматически пропишется в карточку лида.
Если номер уже указан у одного или нескольких пользователей в crm, то в окне чата справа будет приведен список пользователей с данным номером телефона:
![20eb816b9bb1db4da8705d9bb2b219e7.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/20eb816b9bb1db4da8705d9bb2b219e7.png)
Чат-бот
Чтобы упростить процесс привязки чата к номеру телефона клиента для менеджеров, в crm настроен специальный чат-бот, который спрашивает номер у клиента автоматически. В этом случае, если клиент указывает номер телефона при переписке с ботом, чат сразу привязывается к этому номеру, а менеджер сразу видит номер телефона клиента в окне чата и списке обращений. Здесь же он может добавить новый лид, если это новый клиент. Если номер клиента указан у какого-либо пользователя в crm, в окне чатов и списке обращений будет указано имя клиента, заданное в его карточке в системе, со ссылкой на карточку.
![8cb8e2aba63c1716a124e196e8a11c95.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/8cb8e2aba63c1716a124e196e8a11c95.png)
Чат-бот задает следующие вопросы:
![63711edfdea5335ef301eb111ec149ff.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/63711edfdea5335ef301eb111ec149ff.png)
Важно: если клиент пообщался с ботом и так и не задал вопроса, сообщение не поступит в crm.
Нюанс: Чат-бот доступен только на русском языке.
При необходимости, чат-бот можно отключить. Для этого снимите галочку "Активировать чат-бот" в настройках подключения Телеграм:
![9a1360330bf46c0753358ec7cea31e0d.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/9a1360330bf46c0753358ec7cea31e0d.png)
Групповые чаты в Телеграм
Чтобы Телеграм-бот получал сообщения из группы, необходимо в его настройках активировать такую возможность. Для этого в @BotFather выполните команду /setprivacy и выберите "Disable":
![22061ac5400c35fbb5cb276d844992fb.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/22061ac5400c35fbb5cb276d844992fb.png)
При групповой переписке в списке обращений вместо ФИО клиента указывается название группы в Телеграм:
![7c55a29c16213b008143d6a862e2550d.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/7c55a29c16213b008143d6a862e2550d.png)
В окне чатов название группы в Телеграм будет отображаться в заголовке, имена учеников в чате также получаются из Телеграм:
![b475b05582dd82546726c946d2880ff1.png](https://138018.selcdn.ru/KB_images/omnideskru/8101/256038/b475b05582dd82546726c946d2880ff1.png)
Так как в групповом чате для бота действуют те же правила, что и при личной переписке, написать самое первое сообщение в группе бот не имеет возможности. После первого сообщения в чате бот сможет писать туда в любой момент.