Подключение бота

Быстрая настройка

Укажите токен и система автоматически определит текущий метод подключения вашего бота (webhook или getUpdates). Если это возможно подключит бота автоматически, либо выдаст вам инструкции для подключения.

Доступно два варианта для подключения бота

1. Проксирование

2. API

Проксирование

Telegram Bot API имеет две схемы работы:

1. webhook - когда пользователь пишет боту, сервер телеграм автоматически отправляет https запрос на адрес вашего бота

2. getUpdates (long polling) - ваш бот самостоятельно запрашивает обновления у сервера телеграм

На схеме выше изображена стандартная схема обмена данными бота с Telegram серверами.

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

Так выглядит схема работы после подключения graspi.

Если бот работает через Webhook

Такие боты в 90% случаев подключаются автоматически через функцию быстрой настройки

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

Если бот работает через getUpdates

В этом случае вам придется добавить немного кода в ваш бот. Так как ваш бот сам обращается к серверу Telegram, вам необходимо изменить URL адрес с https://api.telegram.org на адрес который выдаст вам наша система. Платформа будет проксировать абсолютно все запросы на сервера телеграм.

Большинство библиотек на которых разрабатываются боты, позволяют менять этот адрес. Инструкции для конкретных библиотек вы найдете в этом разделе. Если вашей библиотеки нет в нашем списке или у вас возникли трудности с подключением просим обратиться в поддержку.

API

Вы можете использовать API чтобы подключится к платформе. Это займет несколько минут и потребует написать всего 1 запрос который будет отправлять данные.

В момент когда вы получаете данные от Telegram Bot API вам необходимо отправить эти данные нашей платформе используя один https запрос.

Данные должны отправляться в неизменном виде, соответствующие структуре данных Telegram Bot API.

Подробней о подключении бота через API вы можете прочитать в этом разделе

Конструкторы ботов.

Инструкции подключения для некоторых конструкторов вы найдете в этом разделе

Наша платформа поддерживает работу с конструкторами ботов, но не со всеми. Если ваш бот на конструкторе, то используйте "Быструю настройку", система все сделает за вас и если возможно подключение — выполнит его.

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

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

Как правило, конструкторы работают через метод webhook. Иногда, несмотря на то что после подключения бот функционирует нормально, конструктор проверяет настройки вашего бота и меняют webhook с нашего на свой, вследствие чего наша платформа перестает получать данные и аналитика перестает работать.

С определенной периодичностью наша платформа тоже проверят корректность установленного адреса и если система что webhook был изменен вам придет уведомление о том что аналитика отключена. По умолчанию мы не меняем эти настройки автоматически, но вы можете включить эту функцию и тогда робота аналитики будет восстанавливаться автоматически.