Интеграция почты и telegram
Telegram появился в 2013 году и вскоре завоевал заслуженную популярность как один из наиболее безопасных, быстрых и удобных мессенджеров. Онлайн-консультант Webim поддерживает возможность интеграции с Telegram на уровне каналов общения (communication channels).
Зачем нужна интеграция
Используя интеграцию сервисов Telegram и Webim, можно создать бота в сервисе Telegram, который будет представлять Вашу организацию в этом сервисе, а все диалоги, которые Ваши пользователи ведут с ним, будут отображаться и обслуживаться операторами и администраторами в привычной Панели управления Webim.
Таким образом, те клиенты, которые предпочитают использовать мессенджер Telegram, добавят новый контакт в адресной книге и продолжат использовать привычный и комфортный для них коммуникатор, а Вашим операторам не придётся параллельно мониторить чаты в сервисах Telegram и Webim, все диалоги будут попадать в общую очередь и в общий интерфейс.
Инструкция по настройке
Чтобы включить интеграцию c сервисом Telegram на Вашем аккаунте Webim, выполните следующие шаги:
Подключение к Telegram BotFather:
Создание бота и получение его токена API:
Настройки Webim каналов общения через Telegram:
Если Вы не наблюдаете такого раздела в Панели управления, то вернитесь к проверке версии Webim (пункты 1-3).
Форма для подключения бота Telegram к Webim:
Сохранение настроек бота Telegram в Webim:
Интеграция сервисов Telegram и Webim закончена.
Теперь любой посетитель Вашего сайта, который предпочитает общаться через Telegram, сможет воспользоваться ею и появиться в очереди пользователей в личном кабинете сервиса Webim.
Как использовать интеграцию
После успешной настройки канала в Панели управления в сервисе Webim появился новый посетитель, представляющий собой Вашего пользователя в мессенджере Telegram. Вы можете найти его, как и посетителей сайта, на странице Рабочее место оператора в очереди пользователей, ожидающих ответа, либо в случае, если включено Автоназначение, он может быть назначен на Вас.
Обращение будет перемещено в раздел В диалоге с Вами после того, как оператор возьмёт его в обработку. В качестве точки входа в карточке предпросмотра диалога, а также в разделе РМО Информация о посещении будет указана страница Telegram.
Видно, что вместо информации о геолокации, браузере, адресе IP и прочих параметрах обычного посетителя у этого пользователя выводится информация о его учётной записи Telegram (см. правую часть страницы).
Выберите этого пользователя в очереди и начните с ним диалог:
Начало диалога оператора Webim с пользователем Telegram:
Информация о посетителе будет отображена в РМО в одноименном разделе. Telegram передаёт следующие поля о посетителе:
- Имя. Здесь отобразится имя, указанное пользователем в Telegram. Если данное имя не соответствует настоящему имени посетителя и Вы хотите его поменять, это можно сделать при помощи кнопки Изменить информацию о посетителе. После введения нового имени оно заменит имя, переданное Telegram, в соответствующем поле.
- ID пользователя в канале. Данное поле отображает уникальный 9-значный численный ID пользователя в Telegram, который присваивается профилю в момент регистрации. Данный ID в профиле не отображается, его можно узнать при помощи специального бота в Telegram.
Указанные выше поля передаются по умолчанию.
Уже несколько лет Telegram – символ свободы и безопасности общения. Надежное шифрование клиент-сервер/сервер-клиент или вообще сквозное, в обход серверов не дает спать по ночам Роспотребнадзору, ФСБ и прочим аббревиатурам. Мессенджер нравится еще и за простоту использования, высокую скорость передачи данных и мультиязычность. Существует даже UZ Telegram kanal, т.е. аналог ресурса на узбекском со своими каналами.
Достоинства Телеграмма пришлись по нраву деловым людям. Внушительная часть деловой переписки перешла в Телеграмм чаты. Однако необходимость высылать письма по электронке еще есть. Поэтому Google создали бота, который позволит читать и отправлять письма Gmail с Telegram.
Что нужно делать, чтобы пользоваться почтой Gmail и Telegram
1. Находим @GmailBot в Телеграмм.
2. Нажимаем /start и авторизуемся под нужным аккаунтом Google.
3. Командуем: /setting — настройки бота; /stop — перестать получать почту в Telegram; /start — возобновить получение почты в Telegram; /new — написать новое письмо.
Как видите, ничего сложного нет. Международность (если есть такое слово) и Телеграмма, и Гугла позволяют вести деловую переписку хоть владельцу какого-то UZ Telegram kanal, хоть обладателю «Незыгаря» легко.
Gmail и Telegram увеличиваем число клиентов
Синий кружок с белой стрелочкой/самолетиком (Telegram символ) значительно упростил ведение переписки. Ну не сам значок, конечно же, а приложение. И для бизнеса это отлично. А знаете, что еще хорошо для него? Как можно больше клиентов. И здесь тоже есть отличный помощник – онлайн сервис накрутки ВТопе. Ресурс быстро и бесплатно добавит столько подписчиков, сколько необходимо для дела, будь то монетизация трафика, получение прибыли за размещение рекламных блоков и т.д., и т.п. А после этого можно смело общаться по электронке с новыми клиентами.
Свяжите IMAP и Телеграм за 5 минут.
Без программистов. Готовы начать прямо сейчас?
Создайте интеграцию IMAP и Телеграм самостоятельно, без программистов
Другие готовые интеграции
Как интегрировать IMAP и Телеграм
c помощью ApiX Drive
Теперь Вам не нужно привлекать программистов или интеграторов для автоматизации IMAP и Телеграм.
С ApiX-Drive вы свяжете и автоматизируете работу этих систем за 5 минут, самостоятельно.
Укажите какие действия будут происходить между системами
Возможности автоматизации
IMAP и Телеграм
Настройте один раз правила, по которым будут работать системы.
С заданным интервалом передавайте данные из IMAP в Телеграм.
Популярные вопросы про интеграцию IMAP и Телеграм
Как происходит интеграция IMAP и Телеграм?
- Для начала нужно зарегистрироваться в ApiX-Drive
- Выбираете какие данные передавать из IMAP в Телеграм
- Включаете автообновление
- Теперь данные будут автоматически передаваться из IMAP в Телеграм
Сколько времени нужно на интеграцию?
В зависимости от системы, с которой вы будете делать интеграцию, время настройки может отличаться и составлять от 5-ти до 30-минут. В среднем настройка занимает 10-15 минут.
Сколько стоит интеграция IMAP с Телеграм?
За саму интеграцию ничего платить не нужно и на всех тарифах доступен полностью весь функционал. Вы оплачиваете только количество данных, которые по факту передаются из одной вашей системы в другую через наш сервис. Если у вас количество данных в месяц небольшое, можете смело пользоваться бесплатным тарифом или перейти на платный, при необходимости. Подробнее о тарифах.
Сколько всего готовых интеграций доступно в Apix-Drive?
На данный момент у нас готово 312+ интеграций помимо IMAP и Телеграм
Часто с новыми инструментами и возможностями появляется желание поэкспериментировать и реализовать что-то не совсем обычное, чего раньше ещё никогда не делал. Идея создать свой сервис временной почты в виде телеграм бота показалась мне достаточно интересной.
Не так давно я переехал с обычного хостинга на VPS и так получилось, что спустя месяц или чуть больше мне снова пришлось переезжать уже на другой VPS. В обоих случаях у меня был самый дешёвый тарифный план и Ubuntu 16.04. Так как последний раз на тот момент с терминалом я сталкивался в университете, что было равносильно полному отсутствию опыта, для настройки своего VPS я использовал прекрасные пошаговые инструкции от DigitalOcean (часть из них переведена на русский язык для тех, кто, как и я, недостаточно знает английский). И да, мой первый VPS был на DO, а переехать снова пришлось в основном потому, что часть его IP адресов попала под раздачу РКН. Повторив пару раз процедуру настройки LAMP, я немного привык к терминалу VPS и в рамках его дальнейшего освоения решил перейти к необычным экспериментам – к созданию своего сервиса временной почты например.Получение входящей почты
Затем я настроил домен. DNS записи:
Чтобы обрабатывать входящую почту php-скриптом, в файл /etc/aliases добавил строку vasya: "|php -q /home/vasya/mail.php" .
Проведя несколько тестов и убедившись, что входящая почта передаётся в php скрипт, я мог заняться её обработкой.
Получение сырой входящей почты, направленной в php выше описанным способом, реализуется в коде крайне просто:
Начало php скрипта для обработки входящей почты с использованием библиотеки zbateson/mail-mime-parser выглядит так:
Так как временная почта на мой взгляд не предполагает несколько получателей, достаточно взять только первого из возможных:
Для получения контента входящих писем в библиотеке есть соответствующие методы:
Телеграм бот
Что должен уметь телеграм бот временной почты в первую очередь?
- Выдавать новый временный email адрес по запросу
- Присылать в чат входящие письма для этого email, пока почтовый адрес действителен
- Продлевать действие email-адреса
Генерация временных email адресов по сути является выдачей следующего адреса по порядку. Я создал таблицу для email адресов в базе данных, где id типа int с автоинкрементом однозначно определяет получателя. Превращение числового id в строковый адрес осуществляется как перевод числа в другую систему счисления, где в качестве «цифр» доступен весь латинский алфавит. 26 букв по сравнению с цифрами дают неплохое сокращение длины идентификатора. Наверное, я мог бы использовать также большие буквы, цифры и некоторые символы без проблем для ещё большего сокращения длины выдаваемых адресов, но я оставил лишь маленькие латинские буквы.
Функции перевода числового id в строковый и обратно:
Одно из ключевых преимуществ использования сервиса временной почты — отсутствие спама. Но если адреса идут по порядку, можно составить список ближайших адресов, которые будут выданы и успешно делать рассылку. Для решения этой проблемы я добавил некоторую случайную строку к идентификатору получателя. Для различия id и случайной составляющей в адресе я решил всегда начинать случайную компоненту с цифры.
Случайную строку выдаваемого email адреса записываем в БД вместе с id получателя, id пользователя в телеграме и временем выдачи почтового ящика.
Хоть и с большим запозданием, публикую шпаргалку по telegram bot api, может, будет полезна.
Прикладываю официальную документацию, и готовый набор методов для работы с telegram. Обработку тестировал на 8.3.15.1747.
В тексте я буду давать ссылки на вторую документацию т.к. для ее просмотра не нужны премудрости для обхода блокировок.
В клиенте telegram ищем бота BotFather
Далее отправляем ему команды
/start
/newbot
Представление имени моего бота
unikalnoe_imya_bot
После этого бот выдаст нам данные для подключения, а именно токен вида 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
Скринами
Соединение
В документации написано:
Код создания соединения :
Прокси
Есть огромное количество сайтов предоставляющий список таких бесплатных прокси, я использую getMe
Я специально буду повторять блоки кода, дабы Вы копировали сразу рабочий вариант, конечно это все нужно обернуть в функции и процедуры
Метод getMe вернет в теле ответа JSON структуру
"ok":true - Означает, что авторизация прошла успешно и Ваш токен валидный.
Short polling - это классическая схема, когда отправляя запрос мы сразу получаем результат его выполнения.
т.е. вы заводите РС с обработанными update_id и каждый раз анализируете - обработан полученный id или нет. Можно завести константу с последним обработанным update_id и сравнивать ее на < или > с полученным
Для работы в такой схеме необходимо договориться с сервером - какой таймаут считать допустимым, для этого у метода
Для переключения режима обмена на вебхуки существует метод InlineKeyboardMarkup
Загрузка полученных файлов
Для этого существует GET-метод
Ответ сервиса getFile
При этом запросе сервер ответит, что все Ок
Показ привью отправленной ссылки можно отключить с помощью параметра disable_web_page_preview
Для этого нужно к запросу добавить строку &disable_web_page_preview=true
Кнопки (клавиатуры)
У метода sendMessage есть еще один очень интересный параметр - reply_markup, который отвечает за быстрые ответы.
Кнопка - это объект InlineKeyboardButton, у которого только одно обязательное поле - text
Есть еще ряд полей, основное из которых - callback_data. Это данные, которые будут отправлены после нажатия кнопки пользователем. Сюда можно записывать идентификаторы из 1С (документа или справочника), числа и т.д. для последующей обработки.
Второй полезный параметр - url, в котором указывается ссылка, которая будет открыта при нажатии на кнопку
Пример JSON-описания клавиатуры
KeyboardButton с основным полем text, данный объект можно не использовать и сразу формировать массив строк.
Еще один важный параметр клавиатуры, но не обязательным, является resize_keyboard, который отвечает за "авто высоту" кнопок.
По умолчанию данный параметр установлен в false и клавиатура растягивается на высоту основной клавиатуры, что выглядит громоздко (см. скрин в примере).
Еще один опциональный параметр - one_time_keyboard, который при установке в true скрывает клавиатуру после нажатия кнопки.
ReplyKeyboardHide - Своего рода команда управления видимостью для клавиатуры
Отправка контактов
Метод похож на sendMessage за исключением нескольких обязательных полей:
phone_number - строковое представление телефонного номера
first_name - Имя контакта
Отправка документов (файлов)
За отправку файлов отвечает POST-метод
Со строковыми значениями вопросов не возникает - делаем СтрЗаменить и все, но есть еще и содержимое файла, которое нужно в итоговый запрос подсунуть.
Для решения этой проблемы у 1С есть метод ОбъединитьФайлы, который объединяет переданный в него массив файлов в один.
Разделим шаблон на части - певая это текст до %СодержимоеФайла%, а вторая это текст после %СодержимоеФайла%. Запишем эти 2 текста в файлы и используем ОбъединитьФайлы подсунув между текстовиками отправляемый файл.
Читайте также: