Токен телеграмма что это

Смена токена Telegram бота

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

Чтобы обезопасить себя, рекомендуем обновлять токены ваших Telegram ботов в следующих случаях:

• смена сервиса для создания ботов,
• после работы сторонних специалистов в ваших аккаунтах,
• после создания нового кабинета на платформе с использованием тех же ботов.

Инструкция по обновлению токена Telegram бота

❗❗❗Важно! Чтобы в работе бота не возникло сбоев из-за обновления токена, сначала полностью изучите данную инструкцию. Обновление токена безопасно для цепочки, если сделать все действия достаточно быстро. Рекомендуем выбрать время, когда в ваших цепочках не планируется массовая отправка сообщений.

Откройте Telegram, проверьте что выбран аккаунт, который является владельцем бота. Найдите бота @BotFather.

Наберите команду /mybots, чтобы увидеть список ваших ботов, и выберете нужный. Нажмите на кнопку API Token, далее Revoke current token. Нажмите на новый токен, чтобы он скопировался.

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

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

Переподключение Telegram бота в BotHelp

Зайдите в ваш кабинет BotHelp в раздел Настройки — Каналы.

Найдите нужного бота. Нажмите на кнопку ⁝ затем Отключить канал

Появится окно с предупреждением, подтвердите действие.

Канал отключен, теперь необходимо подключить его заново.

Нажмите на кнопку Добавить новый канал в появившемся окне выберете Telegram и ниже вставьте новый токен, который предоставил вам бот @BotFater. Нажмите Добавить канал.

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

Если вы не нашли ответ на свой вопрос, задайте его нам в чате внутри кабинета либо напишите на hello@bothelp.io ��

Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp.

Создание Telegram бота на PHP #1: основные понятия для работы с API

Всем привет, это первый урок из курса по разработке ботов для Telegram. В данном курсе, мы с вами разберём как создавать ботов для Telegram на PHP. Я расскажу вам как отправлять текстовые сообщения, как отправлять файлы, как получать и обрабатывать сообщения от пользователей и по итогу мы с вами напишем скрипт для быстрого создания бота для Telegram на PHP.

В первом уроке мы с вами рассмотрим основные понятия связанные с API. Я вам расскажу что такое API методы, хуки, покажу на примере Telegram построение URL для создания запросов и расскажу о том как создаются простые API запросы на PHP.

Полный список всех записей курса находится на сайте или в публикациях на Хабр.

Для отправки и получения запросов через API, вам лучше использовать виртуальный хостинг, так как локальный хостинг не сможет получать данные через хуки.

Основные понятия

Давайте рассмотрим основные понятия для работы с API.

API (Application Programming Interface) — это набор способов и правил, по которым различные программы общаются между собой и обмениваются данными.

Метод API — это определённое действие, которое должно выполнить приложение основываясь на полученных данных (отправить сообщение, вернуть список чатов, отправить картинку и т.д.)

Token (токен) — это уникальный ключ бота, необходимый для отправки запросов.

Как отправлять HTTP запросы на PHP

Для отправки HTTP запросов можно использовать функцию file_get_contents(), где в качестве первого главного параметра указывается ссылка. Данная функция отлично подходит для отправки GET запросов, но к сожалению с помощью функции file_get_contents() нельзя отправлять POST запросы и поэтому для отправки POST запросов мы будем использовать библиотеку Curl.

Curl — это библиотека предназначенная для получения и передачи данных через такие протоколы, как HTTP, FTP, HTTPS.

Подробнее о Curl вы можете почитать на моём сайте.

Виды взаимодействия с приложением через API

Существует 2 вида взаимодействия с приложением через API. Первое это от клиента к серверу, а второе от сервера к клиенту. Клиентом в данном случае является ваше приложение (сайт), а в качестве сервера выступает сайт на который вы отправляете запросы (в нашем случае, это Telegram).

API запрос — это способ общения с программой, по средствам отправки данных от клиента — серверу.

Hooks (Хуки) — это способ общения с программой, по средствам отправки данных от сервера — клиенту. То есть при определённых изменениях в программе, сервер (приложение) будет отправлять данные на указанный скрипта клиента.

Документация для работы с API Telegram

Все методы и параметры для запросов вы можете найти в официальной документации Telegram.

К данному сайту мы будем ссылаться на протяжение всего курса.

Работа с документацией для Telegram

Документация для создания Telegram ботов разделена на несколько разделов.

В разделе Recent changes вы можете найти информацию об обновлениях Telegram. Здесь описаны версии и нововведения которые были внесены в функционал мессенджера.

Разделы Authorizing your bot и Making requests описывают способы авторизации ботов и способы создания запросов для работы с ботами.

Раздел Getting updates описывает способы получения обновлений взаимодействия с ботами. При взаимодействие пользователя с ботов, все его действия, по стандарту, записываются на сервера Telegram, и для того чтобы получить к ним доступ, необходимо отправить запрос getUpdates.

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

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

Следующий раздел, который нас интересует называется — Available types. Данный раздел описывает все типы данных которые возвращает нам Telegram. Когда ваш скрипт отправляет запрос, то обработав его, Telegram вернёт вам ответ в формате JSON строки, в котором описаны специальные параметры.

Например если вы отправляете сообщение, то Telegram вернёт вам массив в котором указаны id созданного сообщения, id пользователя, дата создания сообщения и много другое. Все эти данные вы можете разобрать и записать в базу данных.

Далее описан раздел, с которым нам придётся работать больше всего — это Available methods, методы для взаимодействия с ботом. Советую вам пройтись по всем методам и изучить все возможности работы с ботами.

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

Ну и в конце у нас описаны методы для работы со стикерами, играми в Telegram, методы для работы с оплатой в Telegram.

Структура URL для отправки запросов в Telegram

API Telegram имеет простую и понятную структуру урлов для отправки запросов.

Вот пример URL для создания запросов к боту:

https://api.telegram.org/bot/

— это уникальный ключ, который выдаётся при создание бота;

— это метод запроса по которому мы будем получать или отправлять определённые данные. В зависимости от названия метода, мы будем выполнять разные действия.

Примеры URL для запросов

Данные примеры используются только для наглядности построения URL, токен указанный в URL не привязан ни к одному боту!

Вот так выглядит отправка сообщений методом GET. Первая часть URL содержит домен api.telegram.org, далее прописываем строку bot с токеном который нам даётся при создание бота, после чего указываем метод sendMessage и перечисляем GET параметры.

https://api.telegram.org/bot546445612928:AAHjk6643OYgWHim_TICgsaF9NDDVXYnKzA/sendMessage?chat_id=&text=

Отправка файлов в чат выглядит аналогично, только метод sendMessage заменяется на sendDocument. И здесь не перечисляются GET параметры, после указания метода, так как мы отправляем данные методом POST.

https://api.telegram.org/bot543264456928:AAHjk6643OYgWHim_TICgsaF9NDDVXYnKzA/sendDocument

Отправка изображений в чат:

https://api.telegram.org/bot546413456928:AAHjk6643OYgWHim_TICgsaF9NDDVXYnKzA/sendPhoto

На этом знакомство с документацией Telegram заканчивается. В следующем уроке, мы с вами создадим первого бота и попробуем отправить простые запросы.

• боты телеграм
• боты для мессенджеров
• боты для социальных сетей
• боты телеграмма
• php
• curl

Как получить токен для Telegram Ads, как его изменить и куда добавить — инструкция

Идентификатор, который иначе называют токеном, присваивается каждому рекламному креативу и дает возможность отчитываться о нем по закону о маркировке. Крупные рекламные системы генерируют токены автоматически, а для Telegram Ads их пока еще нужно получать и добавлять к объявлениям вручную. Показываем, как.

Согласно закону № 347-ФЗ, почти любая реклама, которая транслируется в digital, подлежит регистрации с последующей отчетностью. По закону на каждый рекламный креатив нужно получать токен у ОРД, оператора рекламных данных, а потом каждый месяц отправлять отчеты об открутках креативов в ЕРИР, Единый реестр интернет-рекламы.

Токен, или идентификатор — это уникальное цифровое обозначение, которое присваивается каждому креативу до запуска рекламы. Токен подтверждает, что реклама зарегистрирована в ЕРИР, обеспечивает ее прослеживаемость и позволяет о ней отчитаться по закону о маркировке.

Крупные рекламные системы, например, Яндекс Директ и VK Реклама, по API интегрируются с ОРД и автоматически генерируют токены. У Telegram Ads такой интеграции нет, и чтобы соблюдать закон, рекламодатель должен сам получать токен на каждый креатив и добавлять его в рекламный кабинет. Мы в eLama первыми на рынке разработали инструмент для удобной маркировки объявлений Telegram Ads и отчетности по ним.

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

• получить токены на креативы для Telegram Ads;
• добавить статистику по промаркированным креативам;
• заполнить отчет по откруткам в Telegram Ads и отправить его в ЕРИР.

Важно, что всё это делается в общем интерфейсе маркировки для всех рекламных систем. Это особенно удобно, если вы отправляете для себя или своих клиентов отчетность по нескольким рекламным системам. Но даже если нет, eLama упростит вам задачу за счет подсказок по пути и поддержки Службы Заботы.

Общий порядок действий в этом случае таков:

1. Прикрепите аккаунт Telegram Ads к карточке рекламодателя.
2. Создайте креативы.
3. Получите для них токены.
4. Запустите с этими креативами рекламную кампанию.

Идентификатор получается на еще не опубликованное объявление с конкретным текстом — его нужно будет указать. Токен можно получить для уже работающей рекламы, но будьте готовы, что после его добавления объявления в Telegram Ads снова отправятся на модерацию.

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

Получаем токен в кабинете eLama

Зайдите в раздел «Закон о рекламе». Вы окажетесь во вкладке «Аккаунты». Для получения токена к аккаунту должна быть привязана карточка рекламодателя.

Карточка содержит данные о конечном рекламодателе, исполнителе и их договоре, которые передаются в рекламные кабинеты и ОРД автоматически. Она нужна чтобы маркировать рекламу в разных системах без необходимости вводить данные в каждом рекламном кабинете.

Подробности о том, как создать карточку рекламодателя — в наших чек-листах для участников рынка.

После того как карточка привязана к аккаунту, нажмите кнопку «Получить токен» в строке аккаунта в столбце «Токены креативов». Кнопка «Получить токен» — это знак, что пока ни одного токена не получено.

Если в строке рекламного аккаунта написано «Получен автоматически», получать токен не надо.

Заполняем форму токена

В открывшемся окне будет указан рекламодатель из данных основной карточки рекламодателя. Если нужно указать другого, поменяйте у аккаунта основную карточку. Если у рекламодателя нет гражданства РФ, токен получить нельзя. В этом случае поменяйте основную карточку или обратитесь в Службу Заботы.

Чтобы выбрать другую карточку рекламодателя как основную, измените основного рекламодателя во вкладке «Аккаунты». В ОРД данные рекламодателя будут также изменены — мы всегда передаем в ОРД данные основной карточки. Узнайте, как сделать основной другую карточку рекламодателя.

Выберите коды ОКВЭД и нажмите «Далее». Коды ОКВЭД должны относиться к лицу конечного рекламодателя.

На следующем шаге укажите данные о креативе:

• Название рекламного объявления: впишите любое название, по которому сможете быстро найти объявление. Мы не передаем его в ОРД, это поле для вашего удобства.
• Тип рекламной кампании: для Telegram Ads автоматически проставится CPM.
• Целевая ссылка: ссылка на канал или бот, от имени которых вы выкладываете рекламные посты.
• Укажите, относится ли креатив к социальной или политической рекламе.
• Форма распространения рекламы: текстовый.

Далее заполните описание креатива.

• Текст: скопируйте полностью текст креатива.
• Общее описание объекта рекламирования: опишите канал, бота или группу, от имени которых выкладываете рекламные посты.
• Целевая аудитория: укажите пол, возраст и территорию проживания. Это не обязательный пункт, потому что в Telegram Ads нет таких таргетингов.

Нажмите кнопку «Получить токен». На открывшейся странице вы увидите статус токена. Передача данных займет некоторое время.

Пока токен генерируется, страницу получения можно закрыть. Вернуться на страницу можно по кнопке «К токенам» во вкладке «Аккаунты» раздела «Закон о рекламе».

Иногда случается так, что ОРД не может сгенерировать токен. Если это произойдет, мы вас уведомим. Чтобы завершить процесс, обратитесь в Службу Заботы.

Что означают статусы токенов

Что можно сделать с токеном

Нажмите на номер токена. Вы попадете на страницу со всеми данными по креативу. Здесь можно скачать файлы креатива, скопировать его номер или убрать токен в архив.

Чтобы скопировать токен, нажмите на иконку «Скопировать» рядом с номером.

Если вы сняли с рекламы промаркированные креативы, их токены можно заархивировать. Тогда они не будут подтягиваться в отчет.

Чтобы заархивировать токен:

1. Зайдите на страницу токенов рекламного аккаунта — кнопка «К токенам».
2. Выберите токен и нажмите на иконку «Отправить в архив».

Все архивные токены лежат в строке поиска за фильтром «В архиве».

Если токену меньше года, вы можете его разархивировать. Для этого:

• зайдите на страницу токенов рекламного аккаунта;
• выберите токен и нажмите «Вернуть из архива».

Про редактирование токена

Отредактировать токен можно, если:

• Если вы нашли грамматическую ошибку или небольшую неточность в данных креатива.
• Содержание креатива не поменялось.

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

Чтобы отредактировать токен:

1. Зайдите на страницу токенов рекламного аккаунта.
2. Нажмите на номер идентификатора, который хотите отредактировать.
3. Нажмите «Редактировать данные».

Вы можете изменить данные в зависимости от выбранной формы распространения. На первом шаге вы можете изменить рекламодателя, если после получения токена вы изменили признак основной карточки, и коды ОКВЭД.

На втором шаге вы можете изменить:

• название рекламного объявления;
• целевую ссылку (URL);
• признак социальной рекламы;
• признак политической рекламы.

На третьем шаге вы можете изменить:

• общее описание объекта рекламирования;
• параметры целевой аудитории рекламы;
• текстовые данные креатива.

Когда правки внесены, нажмите «Сохранить».

Для передачи обновленных данных потребуется время. Обычно — несколько секунд, иногда больше.

После завершения передачи данных в ОРД статус токена изменится на «Активен». Если данные не удастся передать в ОРД, статус токена изменится на «Данные токена не были обновлены». В этом случае обратитесь в Службу Заботы, она поможет завершить процесс редактирования.

Куда добавлять номер токена

Если объявление ведет сайт, то идентификатор нужно добавить прямо к ссылке на посадочную страницу в формате site.ru?erid=XXXXXXX. Токен может быть добавлен до или после UTM-меток через амперсанд &, например: http://try.elama.ru/telegram_ads?utm_source=telegram&utm_medium=cpc&utm_content=topics&erid=LatgBpVGr. Помните, что в ссылке должен быть один вопросительный знак, но может быть несколько амперсандов, которые будут связывать разные метки.

Кроме того, токен нужно добавить в поле Other Information. Чтобы оно появилось, в рекламном кабинете нужно добавить информацию о конечном рекламодателе в графу Advertiser’s legal name. Для этого перейдите в Edit Account Info на вкладку Info.

В поле Advertiser’s legal name введите название юрлица или ИП и ИНН.

После этого при создании рекламного объявления появится дополнительное поле Other information, в которое можно добавить токен.

Важно! При добавлении информации о рекламодателе все объявления перейдут в режим Review, в том числе старые. После внесения токена изменить его будет нельзя — только завести новое объявление с новым токеном.

Почему инструменты eLama для маркировки — это удобно

1. Отчитываться быстро и с низкой вероятностью ошибок.
2. Заполнять и отправлять отчетность по разным рекламным системам в одном окне. Это актуально для агентств, которые размещают через eLama рекламу для своих клиентов, маркируют креативы автоматически и ежемесячно передают информацию в ЕРИР.
3. При необходимости — редактировать данные креативов и статистики, а также уже переданные в ОРД отчеты.
4. Обращаться за помощью в Службу Заботы по любым вопросам запуска и маркировки рекламы в Telegram Ads.
5. Отладить процессы отчетности, чтобы снизить риск штрафов от Роскомнадзора.

Почему не стоит откладывать маркировку до введения штрафов — объясняет наш эксперт Никита Кравченко. Подписывайтесь на Telegram-канал, посвященный маркировке, чтобы всегда оставаться в курсе новостей.

Чем еще полезна eLama

eLama — это платформа для управления рекламой, где вы найдете:

• 15+ систем интернет-рекламы и сервисов аналитики и коллтрекинга в одном кабинете: Яндекс Директ, VK Реклама, Авито, Яндекс Бизнес, Яндекс Навигатор и другие;
• оплату с единого счета и общий комплект закрывающих документов для бухгалтерии;
• бесплатный маркетплейс инструментов, которые упрощают работу с рекламой и отчетностью и помогают экономить время и бюджет;
• постоплату на рекламу от 300 000 руб. без комиссий и процентов;
• партнерскую программу для агентств и фрилансеров с ежемесячным вознаграждением;
• Службу Заботы, которая всегда приходит на помощь и остается на вашей стороне, в том числе и в вопросах модерации.

Как получить токен телеграм и создать бота?

Токен — это ключ, состоящий из набора символов, и используется для связи webhook-у и сервера мессенджера telegram.

Для того чтобы получить токен и создать чат-бот, нужно в мессенджере телеграмм найти бота с названием BotFather. Это главный бот телеграмм, который позволяет управлять настройками созданных вами ботов, а также создавать новые.

. Важно. Максимальное количество токен, которые могут быть сделаны для одного аккаунта, телеграмму составляет 20.

В боте BotFather необходимо написать команду /newbot . После этого BotFather предложит Вам ввести:

• название Вашего бота, которое будут видеть пользователи;
• uri бота, то есть ссылка на бота, которая будет добавлена в ссылку https://t.me/.

После того, как данные введены и они прошли валидацию (верно введено uri бота), BotFather предоставит ответное сообщение, которое будет содержать API токен созданного бота.

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

• установить webhook для чат-бота (web ссылка, через которую будет идти обмен сообщениями с телеграмм сервером);
• создать логику бота, то есть последовательность действий, которые будет выполнять чат-бота в ответ на действия пользователя.

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

Еще нет собственного бота? Считаете, что создать чат-бота сложно?

Зарегистрируйтесь сейчас в конструкторы чат-ботов Gerabot и создайте собственного чат-бота за 15 минут!

Попробовать бесплатно

Также, Вы можете просмотреть видео инструкцию по созданию токена бота, а также настройке его логики в конструкторе Gerabot.

Также, в боте BotFather, Вы можете не только создавать ботов, но и управлять их основными настройками, например:

• изменять название бота;
• добавлять описание, которое будет отображаться до того, как пользователь подписался на бота;
• добавлять логотип бота;
• подключать платежные системы.

Для того, чтобы изменить данные бота, в BotFather необходимо написать /mybots< /strong> , после чего вы увидите список созданных в вашем аккаунте ботов. Нажав на любое из них, с помощью диалогового меню, вы можете переходить в соответствующие разделы настроек бота.