Как подключить Telegram-бота

Что подготовить

• Аккаунт Telegram, в котором вы будете управлять ботом магазина.
• Доступ к разделу вашей CRM «Настройки» → «Мессенджеры».
• Название магазина и свободное имя пользователя для бота.
• Компьютер для однократной настройки webhook в шаге 5. CRM должна открываться по публичному адресу с https://.

Покупатели будут писать боту магазина, а менеджер — отвечать из чата заказа. Для связи переписки с заказом используйте специальную ссылку, которую создаёт CRM.

1. Откройте официального @BotFather в Telegram и нажмите «Запустить» / Start.
2. Отправьте команду /newbot.
3. В ответ на запрос имени напишите название, которое увидит покупатель, например «Магазин дверей — поддержка».
4. Затем задайте свободное имя пользователя: латинские буквы, цифры и подчёркивания, от 5 до 32 символов, окончание bot. Например, my_door_store_bot. Если имя занято, придумайте другое.
5. Дождитесь сообщения BotFather с подтверждением создания, ссылкой на бота и токеном.

Порядок создания и требования к имени описаны в документации Telegram.

В сообщении BotFather найдите строку после текста Use this token to access the HTTP API. Скопируйте её целиком: токен содержит цифры, двоеточие и длинную последовательность символов.

Если бот уже создан, отправьте BotFather /mybots, выберите его и откройте API Token. Токен даёт управление ботом: храните его как пароль и не отправляйте покупателям.

Откройте «Настройки» → «Мессенджеры» → «Добавить подключение». Заполните поля по таблице. Проверьте канал и API URL, даже если в форме уже есть значения. На телефоне таблицу можно прокрутить по горизонтали.

Нажмите «Создать подключение». Для одного магазина или общей области допускается одно активное подключение Telegram. Если оно уже есть, откройте его редактирование.

1. Найдите созданное подключение в списке мессенджеров.
2. Откройте меню ⋮ → «Обновить статус».
3. При успешной проверке появится статус «Авторизован».

Проверка статуса подтверждает доступ по токену. Для появления входящих сообщений выполните настройку webhook в следующем шаге.

Webhook — адрес вашей CRM, на который Telegram будет присылать сообщения. Он показан в столбце «Webhook» у созданного подключения. Скопируйте полный адрес именно этой строки. Используйте адрес своей CRM; локальный 127.0.0.1 для этого не подходит.

Настройка выполняется один раз запросом setWebhook. Ниже — способ через настольный Postman с заполнением готовых полей.

1. Скачайте и установите Postman для компьютера.
2. Откройте приложение. На экране входа выберите работу без аккаунта — lightweight API Client. В этом режиме запросы хранятся на вашем компьютере.
3. Выберите New → HTTP или откройте новую вкладку запроса кнопкой +. Затем заполните поля по инструкции ниже.

Описание этого режима: официальная справка Postman. После настройки удалите запросы с токеном из локальной истории и закройте их вкладки.

1. Слева от строки адреса выберите метод POST.
2. В адрес вставьте https://api.telegram.org/botВАШ_API_TOKEN/setWebhook. Замените ВАШ_API_TOKEN токеном BotFather. Слово bot перед токеном должно остаться.
3. Откройте вкладку Body → raw, в списке формата выберите JSON.
4. Вставьте тело запроса ниже. Вместо ВАШ_WEBHOOK_URL вставьте полный адрес из столбца «Webhook» в CRM, сохранив кавычки.

{"url":"ВАШ_WEBHOOK_URL","allowed_updates":["message","edited_message"]}

Нажмите Send. Успешный ответ содержит "ok": true и "result": true. При ошибке прочитайте поле description и исправьте указанную причину.

Проверьте сохранённый адрес

Создайте второй запрос: метод GET, адрес https://api.telegram.org/botВАШ_API_TOKEN/getWebhookInfo. Подставьте тот же токен, нажмите Send. Значение result.url должно полностью совпадать с адресом из CRM. Если есть last_error_message, проверьте доставку новым сообщением.

У одного Telegram-бота один webhook. Настройка этого адреса направляет сообщения в выбранную CRM. Сведения о запросах: setWebhook и getWebhookInfo в Telegram Bot API.

1. Откройте заказ магазина, для которого настроен бот.
2. В общей информации рядом с телефоном покупателя нажмите значок Telegram. Откроется окно «Ссылка для клиента» с адресом и QR-кодом.
3. Нажмите «Скопировать ссылку» и отправьте её покупателю или предложите отсканировать QR-код.
4. Покупатель должен перейти по этой ссылке и нажать «Запустить» / Start в боте. Для проверки выполните это со своего Telegram-аккаунта в тестовом заказе.
5. Отправьте боту тестовое сообщение, например «Проверка подключения».
6. Откройте чат этого заказа в CRM, выберите канал Telegram, дождитесь входящего сообщения и отправьте ответ из CRM. Убедитесь, что ответ пришёл в Telegram.

Используйте ссылку из нужного заказа: она содержит данные для привязки чата. Простой переход на обычную ссылку бота и команда /start без данных заказа не создают такую привязку. Покупатель должен первым запустить бота, прежде чем менеджер сможет ему ответить.

Если не получилось

Официальные инструкции

• Создание и управление ботом через BotFather.
• Telegram Bot API: настройка webhook.
• Как подключить MAX-бота к DoorLine CRM.