Интеграция с Telegram

Последние изменения: 06.09.2022

Создание телеграм-бота

Подключение телеграм-бота к CRM

Принцип работы интеграции

Чат-бот в CRM

Групповые чаты в Telegram

Интеграция crm с Телеграм позволяет вести переписку с клиентами через мессенджер Телеграм из интерфейса crm. Переписку возможно вести как с одним клиентом, так и с группой.

Подключение возможно осуществить только с Телеграм-ботом, с личным аккаунтом осуществить интеграцию технически нереализуемо (Телеграм не позволяет интеграций с обычными аккаунтами пользователей).

Бота можно подключить как на весь аккаунт crm целиком, так и к каждому/нескольким филиалам отдельно.

Специфика работы Телеграм-бота такова, что он может отправить сообщение клиенту только после того, как клиент написал ему первым (т.е. бот не может первым написать сообщение кому-либо).

Также стоит знать, что Телеграм работает по принципу одно подключение = 1 бот, поэтому, если ваш бот уже подключен к какому-либо сервису, необходимо создать нового бота.

Создание Телеграм-бота

Для создания нового бота перейдите в Телеграм и введите в поле поиска @BotFather - это бот от Телеграм, который создает новых ботов. Обратите внимание, что у официального бота Телеграм будет стоять синий подтверждающий знак возле имени в виде галочки.

ecf4e56eac2e6b10e2e1b06e2e7d713b.png

Далее, выберите из списка или напишите в строке набора текста сообщения команду /newbot

041e49f76c39379c841a775658949433.png

Укажите имя бота — это имя будут видеть клиенты при общении с ботом.

1b7e4c569bef57f597de3743731a5dfa.png

Далее, задайте никнейм бота — по нему можно будет найти бота в Telegram. Никнейм должен быть уникальным и заканчиваться на слово «bot».

Если никнейм уже занят, Телеграм укажет это в ответном сообщении:

cf828503e9dac83d7bf190794fafbb81.png

Нужно придумать другой никнейм для бота и указать его в сообщении. Когда бот успешно создан, Телеграм выдаст следующее сообщение:

a52662146626e3e3d52b73329968ce81.png

Для подключения бота к crm вам понадобится токен, который указан в сообщении об успешном создании бота.

Скопируйте значение токена:

9613b72970fda6aa1eaa61a24608fac1.png

Боту можно загрузить фото профиля с помощью команды /setuserpic:

060ad0824ca7e3470e799fe880f08383.png

Изображение нужно загрузить в чат с BotFather нажатием на иконку скрепки:

771c136868d492fd111430008b8e1058.png

При желании можно задать какое-либо описание бота, воспользовавшись командой /setdescription:

042727303f3cf2460e1d10453c110df0.png

Описание бота также нужно отправить сообщением:

4f46e03654fea3afdd2f58b2cdce9db5.png

Описание бота будет отображаться для всех клиентов в окне переписки:

d83a6938fcf0d67717fdaa897dfcd19c.png

Подключение Телеграм-бота к crm

Если вы подключаете бота на весь аккаунт crm, перейдите в crm в раздел "Настройки" - "Интеграция" - вкладка "Мессенджеры" и выберите из списка Telegram:

6773154792fc10a0092bdfa0c3d4939d.png

Вставьте скопированный токен в одноименное поле в настройках:

7e40f8d5744c521c2bbd776c7cdde7e9.png

Галочка "Активировать чат-бот" включает встроенного бота, который будет спрашивать номер телефона ученика и находить его в базе crm самостоятельно. Подробнее об этом будет описано ниже.

Для проверки соединения и настроек бота можно нажать на кнопку "Инфо" справа от поля для токена. Появится всплывающее окно со следующими данными:

4e2677f248682f4eec31731775fd9f1b.png

Name: Имя бота, заданное при создании

Username: Никнейм бота, заданный при создании

Can read all group messages: Может ли бот видеть сообщения всех участников группы, если добавить его в группу. Подробнее об этом будет описано ниже.

Если вы подключаете бота только на один/некоторые филиалы в crm, токен нужно прописать не в общих настройках, а в карточке каждого филиала, к которому нужно подключить бот. Для этого перейдите в раздел "Компания" - "Филиалы" и кликните на название филиала, к которому необходимо подключить бот.

cc7a0715e9d4d1c4c9886ecef0ffae83.png

В карточке филиала нажмите "Мессенджеры":

dc4f2562af4d6a213758fe6b070ca304.png

Далее вставьте Токен бота в поле в открывшемся окне:

0461b6c460b6e1cb7e8c1fbfb7a938ee.png

Принцип работы интеграции

Переписка с клиентом в Телеграме в crm происходит через интерфейс Чатов. Входящие сообщения клиентов распределяются по менеджерам в соответствии с алгоритмом, о котором можно прочитать в этой статье.

В crm Телеграм клиента закрепляется за его номером телефона. Когда клиент пишет в чат первый раз, в окне чатов у менеджера отображается имя клиента так, как оно указано в Телеграм.

Клиента необходимо идентифицировать, поэтому задача менеджера - уточнить телефон клиента и привязать Телеграм-чат к номеру телефона. Для этого нужно нажать на кнопку "Привязать к телефону":

77678c8b15ab809d76e092dd2ddde33a.png

Далее необходимо вписать номер клиента в одноименном поле и сохранить:

ed8ad56b747c8ca67052f7a294a621c2.png

Если номер телефона есть в CRM, система найдёт такого пользователя и предложит его выбрать:

d06de2b2608db1dd30082b53702c236b.png

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

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

a48f44d6b8303ebf39f06a6f7933552e.png

При добавлении нового лида из окна чата номер телефона автоматически пропишется в карточку лида.

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

20eb816b9bb1db4da8705d9bb2b219e7.png

Чат-бот

Чтобы упростить процесс привязки чата к номеру телефона клиента для менеджеров, в crm настроен специальный чат-бот, который спрашивает номер у клиента автоматически. В этом случае, если клиент указывает номер телефона при переписке с ботом, чат сразу привязывается к этому номеру, а менеджер сразу видит номер телефона клиента в окне чата и списке обращений. Здесь же он может добавить новый лид, если это новый клиент. Если номер клиента указан у какого-либо пользователя в crm, в окне чатов и списке обращений будет указано имя клиента, заданное в его карточке в системе, со ссылкой на карточку.

8cb8e2aba63c1716a124e196e8a11c95.png

Чат-бот задает следующие вопросы:

63711edfdea5335ef301eb111ec149ff.png

Важно: если клиент пообщался с ботом и так и не задал вопроса, сообщение не поступит в crm.

Нюанс: Чат-бот доступен только на русском языке.

При необходимости, чат-бот можно отключить. Для этого снимите галочку "Активировать чат-бот" в настройках подключения Телеграм:

9a1360330bf46c0753358ec7cea31e0d.png

Групповые чаты в Телеграм

Чтобы Телеграм-бот получал сообщения из группы, необходимо в его настройках активировать такую возможность. Для этого в @BotFather выполните команду /setprivacy и выберите "Disable":

22061ac5400c35fbb5cb276d844992fb.png

При групповой переписке в списке обращений вместо ФИО клиента указывается название группы в Телеграм:

7c55a29c16213b008143d6a862e2550d.png

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

b475b05582dd82546726c946d2880ff1.png

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


Помогла ли вам статья?