Подключение и возможности интеграции с Telegram (персональный)
Как подключить Telegram и собственного бота в Albato
Теперь можно пользоваться не только Telegram-ботом Albato, но и создавать и подключать собственного. А ещё запускать связку, когда бот получил сообщение или сообщение появилось в группе, где находится бот.
При подключении твоего Telegram-бота к Albato, мы пропишем в него свой webhook, и бот будет отправлять все события к нам. То есть, если бот уже подключен к какой-то другой системе и использует сторонний функционал, то он отключится и начнет использовать только функционал Albato.
Как создать бота и получить API ключ
🎬 Смотри видеоинструкцию по настройке) на нашем YouTube-канале.
Не забудь подписаться! Там мы выкладываем полезные видео про автоматизацию, записи вебинаров и видеоинструкции по настройкам.
Перед подключением бота к Albato, нужно его создать или выбрать существующего у специального системного бота @BotFather):
Напиши ему команду /start.
Если у тебя уже есть боты и нужно получить их API ключ, отправь команду /mybots.
Выбери из списка нужного бота и запроси API ключ, который потребуется для подключения:
![](https://storage.crisp.chat/users/helpdesk/website/ac6dec3b49634800/a54dc107-f704-45f3-9f65-ad4185_j2oyhf.png)
Или напиши команду /newbot, для того что бы его создать.
После этого напиши имя твоего бота. Оно будет видно всем.
Затем укажи имя пользователя. Оно будет идти после символа «@» и обязательно должно заканчиваться на bot. Например, «youNamebot» или «youName_bot».
После этого тебе станет доступен API ключ созданного бота и его можно подключать к Albato:
![](https://storage.crisp.chat/users/helpdesk/website/8b07bce8c9914000/c825b8e8-599c-4063-8dc8-6bfddd_picoaf.png)
Как создать подключение
Зайди в раздел «Подключения».
Нажми на кнопку «Добавить подключение».
Выбери сервис «Telegram (персональный)»:
![](https://storage.crisp.chat/users/helpdesk/website/751617b684f2680/eb8da7a1-befb-42d6-9a29-b09b81_nqqvuk.png)
В поле «Ключ API» вставь скопированный у @BotFather) API ключ:
![](https://storage.crisp.chat/users/helpdesk/website/c593993deb322000/7417f296-8755-401b-8221-2e5572_mq3vqv.png)
Подключение готово!
Как пользоваться ботом
После подключения бота, любой пользователь который напишет ему команду /start, автоматически попадет в список ID чатов. А если эту команду написать в группе, когда бот находится там, он спарсит ID текущей группы/канала.
Для того что бы отправить сообщение в Telegram, нужно знать ID чата, куда будет передаваться сообщение. Использовать логин или номер телефона нельзя по правилам API Telegram.
Поэтому если ты хочешь что-то написать пользователю или в группу, сначала нужно, чтобы боту в нужном чате отправили команду /start. После получения ID чата ты сможешь выбрать его в списке и использовать чат в действии «Отправка сообщения».
Как работает триггер «Входящее сообщение»
Триггер «Входящее сообщение» будет запускаться каждый раз, когда любой пользователь напишет боту сообщение, либо появится новое сообщение в группе/канале где находится подключенный бот. Любые команды, которые начинаются с символа «/» (например, /start ) игнорируются триггером и не запускают связку, даже если после команды есть часть текста.
Но триггеру можно разрешить часть команд. Для этого нужно открыть параметры триггера:
![](https://storage.crisp.chat/users/helpdesk/website/53dc45749f205800/e20e1d31-4fe3-4303-85d5-81227b_14ey0v8.png)
Здесь ты можешь прописать список разрешенных команд:
![](https://storage.crisp.chat/users/helpdesk/website/6bc32cd584370000/399dfe0f-7926-46b8-afe0-16cc4f_jmkp4.png)
В итоге, если бот получит сообщение с командой и текстом, это также запустит триггер. Например, передаст в связку текст /youCommand Hello полностью.
Триггер, помимо самого текста сообщения, получает множество других данных. Например, имя и ID пользователя, который отправил сообщение и ID чата откуда пришло сообщение:
![](https://storage.crisp.chat/users/helpdesk/website/783297ae09d0e800/a848ca24-c572-45db-9683-a94734_15zpig0.png)
Таким образом, ты можешь дополнительно настроить фильтр у триггера, чтобы он запускался:
Только от определённого текста.
Только когда напишет определённый пользователь в группе.
Когда получит сообщения из определённого чата.
![](https://storage.crisp.chat/users/helpdesk/website/b5d87dc2b3c61800/d59d8c8f-4198-46aa-ae8d-612749_1sma2dz.png)
В данном случае, поле «Откуда» — это данные о том, кто конкретно отправил сообщение (полезно использовать, когда сообщения приходят из группы). А поле «Чат» — данные самого чата (личка с ботом/группа/канал).
Обязательно используй фильтры, если твой бот будет в нескольких чатах.
Подробнее про настройку фильтра — в этой инструкции.
Как работает действие «Отправить сообщение»
Действие «Отправить сообщение» позволяет передать текст в выбранный чат, используя при этом любой триггер в Albato. Функционал похож на нашего бота описанный тут.
Отличия в том, что определённый чат больше не привязывается к конкретному подключению, его нужно выбрать из списка в поле действия:
![](https://storage.crisp.chat/users/helpdesk/website/5f96dddf880c0c00/4bcc4bb9-7e70-4504-b198-29af6b_1ukcdxy.png)
Далее можно выбрать тип разметки:
![](https://storage.crisp.chat/users/helpdesk/website/c9441702f6e93800/31ab61f3-48ef-4a05-afcb-c62b5c_13ajsje.png)
Также можно сформировать небольшой формат текста, например HTML, с картинками и ссылками.
После этого останется только заполнить поле текста и запустить связку:
![](https://storage.crisp.chat/users/helpdesk/website/c8fea842303fd800/3abca8d6-9fb6-40b0-bf31-2d651e_ngw51s.png)
Ты можешь использовать это действие вместе с инструментом «Табличная замена». Например, ты распределишь, кому отправлять оповещение из CRM о новой сделке. Это поможет не собирать всех сотрудников в одном канале и не отвлекать их лишний раз.
Будет работать так:
Из amoCRM срабатывает триггер «Новая задача».
С помощью табличной замены Albato смотрит на имя ответственного пользователя и заменяет это имя на ID чата.
Конкретному человеку уходит уведомление в Telegram.
![](https://storage.crisp.chat/users/helpdesk/website/c382b0888ae3c800/1aef0562-d409-4f10-b704-c1e42f_16fgda4.png)
В действии, в поле ID чата, будет результат табличной замены:
![](https://storage.crisp.chat/users/helpdesk/website/6cd2be933734e800/edbe86ef-6aec-4acc-8012-c4f56c_1wo959f.png)
*
Примеры сценариев
Если тебе нужно создать задачу, например в YouTrack. Ты можешь написать боту произвольный текст, который создаст эту задачу автоматически:
![](https://storage.crisp.chat/users/helpdesk/website/6178a01ab9d07800/4a7e3095-f546-41a5-87f2-c77219_by2qtn.png)
![](https://storage.crisp.chat/users/helpdesk/website/ae4510d06caef000/f306d2ca-3540-4e6e-a657-021c9f_xeyxzk.png)
*
Если тебе нужно ловить из чата пользователей, которые написали сообщение с определенной фразой. Для этого настрой фильтр триггера на поле «Текст» с оператором «Содержит» и укажи нужную фразу:
![](https://storage.crisp.chat/users/helpdesk/website/914f7b1fa92c780/90a5d092-c238-49f0-af32-0e8445_1nfrybf.png)
Затем используй в связке действие, которое создаёт лида, сделку в CRM системе или запись в Google Sheets. Таким образом ты не пропустишь ни одно сообщение, даже при большом спаме от пользователей.
Последнее изменение: 27/06/2023
Спасибо!