Соединение с ботом

Схема соединения бота с экземпляром SimpleOne:

1. Для создания Telegram-бота, администратор системы отправляет команду в Telegram @BotFather. После успешного создания бота, генерируется токен бота.
2. Администратор создает заранее конечную точку в таблице Действия API. При подключении экземпляра SimpleOne к боту на соответствующей странице используется сгенерированный ранее токен бота и задается конечная точка.
3. После сохранения, отправляется запрос в Telegram-бот с методом setWebhook для установки соединения. В запросе передается URL конечной точки.

Аутентификация пользователей

---

Алгоритм подключения пользователей к Telegram-боту выглядит следующим образом:

1. Пользователь пишет Telegram-боту, на конечную точку приходит запрос.

Пример тела ответа

{"update_id":301617650,
    "message":{
        "message_id":34235,
        "from":{
            "id":1344171102,
            "is_bot":false,
            "first_name":"John",
            "last_name":"Doe",
            "username":"john.doe",
            "language_code":"en"
            },
        "chat":{
            "id":1322171102,
            "first_name":"John",
            "last_name":"Doe",
            "username":"john.doe",
            "type":"private"
            },
        "date":1676130018,
        "text":start"
    }
}

2. По ID чата на экземпляре проверяется наличие записи с привязкой пользователя и чата в таблице Связи чатов Telegram и пользователей (itsm_telegram_chat_bindings_with_users) table.
   • Если соответсвующая запись есть, то бот работает дальше по скрипту.
3. Если записи нет, то в Telegram появляется кнопка Share your phone number, после нажатия на которую на конечную точку приходит запрос с ключом contact и phone_number По номеру телефона в базе данных находится запись пользователя, после создается запись в таблице Связи чатов Telegram и пользователей (itsm_telegram_chat_bindings_with_users).

примечание

Если на экземпляре не удалось найти пользователя по номеру телефона, указанному в Telegram, бот выдаст следующее сообщение: Номер не зарегистрирован в системе. Авторизуйтесь с другого номера или свяжитесь со службой поддержки {почта поддержки}

Если учетная запись пользователя неактивна или заблокирована, бот выдаст следующее сообщение: Учетная запись не активна. Свяжитесь со службой поддержки {почта поддержки}