Как получать уведомления о криптотранзакциях в Telegram

Чтобы получать сообщения о поступлениях на кошелёк в Telegram, добавьте адрес в мониторинг Cryptanio, подключите чат к аккаунту и выберите его в уведомлениях нужного проекта. Собственный бот и программирование не нужны. Средства поступают на указанный кошелёк, а Cryptanio сообщает об обнаруженных переводах и изменениях их состояния.

Разберём обычный сценарий: вы принимаете USDT и хотите узнавать о новых поступлениях, не открывая каждый раз обозреватель блокчейна. По той же схеме можно настроить уведомления для другого поддерживаемого актива.

Что понадобится

Нужны аккаунт Cryptanio с правом изменять настройки, Telegram и публичный адрес кошелька в доступной для мониторинга сети. Для USDT также понадобится идентификатор токена в выбранной сети. Например, для токенов с адресом контракта именно этот адрес отличает нужный актив от других токенов с похожим названием. Идентификаторы USD₮ опубликованы в официальном справочнике Tether.

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

Выберите проект и добавьте адрес

Откройте Monitoring в кабинете Cryptanio и перейдите в проект, к которому относится кошелёк. Проект помогает держать адреса и уведомления одного сайта или направления работы вместе.

Если адрес ещё не добавлен, нажмите Добавить адреса. Выберите сеть, вставьте публичный адрес получателя и проверьте, что он относится именно к этой сети. При желании добавьте понятное имя, например «Оплаты за консультации».

Для USDT выберите «Один ассет» и в поле «Актив» укажите поддерживаемый идентификатор токена для выбранной сети. Каталог также распознаёт поддерживаемые обозначения вроде USDT. Пустое поле означает нативную монету сети, а не USDT. Сохраните адрес и убедитесь, что наблюдение активно.

Для уведомлений только о поступлениях включите «Входящие», а «Исходящие» оставьте выключенным. Для обоих направлений отметьте оба пункта, если исходящие переводы доступны для выбранной сети и режима.

Откройте настройки уведомлений проекта

Откройте «Уведомления» нужного проекта. Проверьте его название, чтобы направлять в чат события правильного набора адресов.

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

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

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

Откройте «Настройки» → «Уведомления» и вкладку Telegram. Нажмите «Подключить Telegram», затем «Открыть Telegram» и подтвердите запуск бота в Telegram. Если вместо ссылки кабинет показывает команду, отправьте её боту целиком.

Код привязки действует один раз и в течение 15 минут. Не отправляйте его другим людям: он предназначен для подключения вашего чата. Если код истёк, получите новый через кабинет.

Бот подтвердит подключение к аккаунту. Команда /whoami показывает, к какому аккаунту подключён чат, а не выбирает проект. Вернитесь в кабинет и нажмите «Проверить подключение». Открывайте бота из кабинета, чтобы использовать ссылку, подготовленную для вашего подключения.

Включите Telegram для проекта

Если маршрут уже добавлен, переходите к выбору событий; кнопку с плюсом нажимайте только при отсутствии маршрута. Вернитесь в «Уведомления» проекта с собственными настройками. В карточке Telegram найдите подключённый чат и нажмите кнопку с плюсом «Использовать … для этого проекта». Для обычных поступлений выберите «Подтверждённые платежи», а для подтверждений вместе с откатами — «Подтверждённые платежи и откаты». Маршрут и выбор событий сохраняются при изменении.

Подключение определяет получателя, а маршрут — какие события проекта ему отправлять. Отдельно включать Telegram флажком у адреса не требуется. В настройках аккаунта у подключения можно нажать «Проверить»: тестовое сообщение ставится в очередь, но не создаёт криптоперевод и не проверяет мониторинг адреса.

Если нужны исходящие переводы, используйте «Выбрать типы событий» и включите «Исходящий перевод подтверждён»: политика подтверждённых платежей не включает их автоматически. В правилах адреса тоже должно быть разрешено нужное направление, а сеть и актив должны соответствовать переводу.

Проверьте результат на новом переводе

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

Найдите операцию в События и сопоставьте её с сообщением в Telegram. Проверьте сумму, актив, сеть и идентификатор транзакции. В сообщении доступен статус события; для некоторых сетей есть ссылка на транзакцию в обозревателе.

Обнаруженный и подтверждённый перевод — разные этапы одной операции. Если пришли сообщения о смене состояния, это не обязательно два платежа. При откате транзакции состояние тоже может измениться. Решение о выполнении оплаченного заказа принимайте по подтверждённой оплате и её текущему состоянию.

Если сообщения не приходят

Сначала проверьте, появилась ли операция в «События». Если её нет, проверьте сеть, актив, направление и состояние наблюдения. Если событие есть, проверьте проект, наследование, выбранный чат, политику событий и паузы маршрута и подключения. Данные об отправках доступны в «Доставки».

Если бот был заглушён командой /mute, отправьте /unmute. Заглушение сохраняет привязку и не прекращает регистрацию событий. Также проверьте, не заблокирован ли бот в Telegram и разрешены ли уведомления самого приложения на телефоне.

Последние события смотрите в кабинете: команда /last для новых подключений аккаунта недоступна. Команда /unlink отсоединяет чат от аккаунта и прекращает отправку через это подключение, в том числе для использовавших его проектов. Наблюдение за адресами и другие каналы сохраняются.