Как создать Telegram-бота для доставки?

Важно: для домена нужен SSL сертификат.

Шаги для создания бота

  1. В Telegram в списке пользователей найдите BotFather.
  2. Введите команду /newbot.
  3. BotFather попросит ввести имя бота (оно будет отображаться в списке).
  4. Далее нужно ввести username вашего бота. Он должен заканчиваться на _bot (например, MySuperBot_bot).
  5. BotFather пришлет информацию о созданном боте, включая токен, который необходимо прописать в настройках сайта.

Регистрация webhook'а

Затем нужно зарегистрировать endpoint бота в Telegram.

Webhook нужен для добавления в бот пользователей, которым будут приходить заказы.

Для установки или регистрации webhook'а выполните следующий HTTP запрос (можно просто открыть этот URL в браузере):

https://api.telegram.org/botYOUR-TOKEN/setWebhook?url=https://YOUR.DOMAIN/WEBHOOKADDRESS/

Проверить статус webhook'а можно таким запросом:

https://api.telegram.org/botYOUR-TOKEN/getWebhookInfo

WEBHOOKADDRESS — это адрес для хука, который можно посмотреть в примере (например, /telegram/1/webhook).

Настройка в базе данных

В базе данных (таблица: options, поле: tekegramApiKey) замените доступы для Telegram.

Примеры запросов

  • Для сайта fujisushi:
    https://api.telegram.org/bot<Токен>/setWebhook?url=https://fujisushi.ru/telegram/1/webhook?terminal=d2166d16-a7c9-5d51-0182-211b49e3cc8
  • Для API версии 2 (мобильное приложение) fuji:
    https://api.telegram.org/bot<Токен>/setWebhook?url=https://api-v2.fuji.ru/api/v1/telegram/callback
  • Для API версии 3 (сайт) fuji:
    https://api.telegram.org/bot<Токен>/setWebhook?url=https://api-v3.fuji.ru/api/v1/telegram/callback