CryptoCRM
Все статьи

Подключение Telegram-ботов и вебхуков

CryptoCRM работает с двумя Telegram-ботами. Разделение простое: один общается с клиентами, второй — с вашей командой и курьерами. Настраиваются оба в панели: Настройки → Telegram.

Зачем два бота

  • Клиентский бот — лицо обменника для клиента. Через него идут диалоги в разделе «Чаты» и автоматические уведомления клиенту о статусе его сделки.
  • Командный бот — внутренний. Через него курьеры привязывают свой Telegram и получают задания на доставку, а вы получаете уведомления в командную группу (статусы сделок, напоминания о неотвеченных чатах, алерты о депозитах).

Командный бот необязателен: если отдельный токен не задан, его роль (уведомления в группу) берёт на себя клиентский бот. Но для привязки курьеров нужен именно рабочий бот с вебхуком.

Шаг 1. Получить токен у @BotFather

  1. Откройте в Telegram @BotFather и отправьте /newbot.
  2. Задайте имя и username бота (username должен заканчиваться на bot).
  3. BotFather пришлёт токен вида 123456789:AA... — это ключ доступа к боту.

Повторите для второго бота, если хотите отдельный командный.

Шаг 2. Вставить токен и подключить вебхук

  1. В панели откройте Настройки → Telegram.
  2. Вставьте токен клиентского бота в поле «Токен бота» и сохраните.
  3. Нажмите «Подключить вебхук».

Вебхук — это адрес, по которому Telegram доставляет боту входящие сообщения. Без него сообщения клиентов просто не дойдут до панели, и «Чаты» останутся пустыми.

Вебхук регистрируется на вашем собственном домене, а не на общем адресе. Поэтому у каждого обменника — свой бот и свои сообщения, ничего не смешивается.

Аналогично заполните секцию «Telegram: бот для команды», если используете отдельный командный бот, и подключите вебхук для него.

Что дальше

  • Клиент пишет вашему клиентскому боту — в панели появляется диалог. Подробнее: Чаты с клиентами.
  • Курьер привязывает Telegram через командный бот. Подробнее: Курьеры.
  • Настройте, в какую группу слать статусы и алерты. Подробнее: Уведомления в группу.

Если что-то не работает

  • «Чаты» пустые, хотя клиент писал — проверьте, что вебхук подключён (кнопка в настройках) и токен верный.
  • Уведомления не приходят в группу — добавьте бота в группу и укажите её chat id в настройках (см. Уведомления в группу).