Telegram талаптары мен шектеулері

1. Хабарлама шектеулері

  • Тек мәтіндік хабарлама: Ең көбі 4 096 таңба.
  • Суреті бар хабарлама: Ең көбі 1 024 таңба (1080x1080 px сурет үшін).

2. Суретке қойылатын талаптар

  • Пішімі: Шаршы суреттерге артықшылық беріледі.
  • Оңтайлы өлшемі: 900x900 пиксель, ең көбі 5 МБ.

3. Файлдарға қойылатын талаптар

Telegram API жүктелген файлдарға арнайы талаптар қояды:

  • Боттар 2 ГБ дейінгі файлдарды жібере алады.
  • Бұрын жүктелген файлдармен жұмыс істеу үшін file_id пайдалануға болады. Бұл жағдайда файл шектеулері Telegram құжаттамасына сәйкес келеді.
  • Файлдарды URL арқылы жіберуге болады (бот жүктеп алып, жібереді):
    • Фотосуреттер: ≤ 5 МБ
    • Басқа файлдар: ≤ 20 МБ
  • Жариялау үшін әртүрлі шектеулер қолданылады:
    • Фотосуреттер: 10 МБ
    • Басқа файлдар: 2 ГБ

Түпнұсқа дереккөзде толығырақ оқыңыз

Telegram ботын құру

Telegram боты BotFather арқылы жасалады, бұл Telegram-ның ресми боттарды басқару жүйесі. Бұл тексерілген құрал (көк белгіше арқылы көрсетілген) бағдарламалау білімінсіз бот жасауға мүмкіндік береді және сізді жалған еліктеушілерден қорғайды.

Құру қадамдары:

  1. BotFather ботпен сөйлесуді бастаңыз.
  2. /newbot пәрменін жіберіңіз.
  3. Ботыңызға ат таңдаңыз (бұл пайдаланушыларға көрсетілетін атау).
  4. Ботыңызға пайдаланушы атын таңдаңыз. Ол міндетті түрде bot немесе _bot әріптерімен аяқталуы керек (мысалы, my_test_bot).

Егер пайдаланушы аты қолжетімді болса, BotFather сізге API қол жеткізуге арналған бірегей кілт — "токен" бар растау хабарламасын жібереді.

Маңызды: Бұл токен сіздің ботыңыздың құпия сөзі болып табылады. Оны қауіпсіз сақтаңыз және ешкіммен бөліспеңіз.

Messengers бөліміне өтіп, Telegram таңдаңыз және ботыңыздың токенін берілген өріске қойыңыз.

Ботты орнатуды аяқтау және жобаңызға қосылымды белсендіру үшін Done түймесін басыңыз.

Telegram топтарымен/арналарымен жұмыс

Пайдалы ақпарат

Telegram тобы — бұл қатысушылар арасындағы байланыс арнасы: онда барлық қатысушылар жаза алады.

Telegram арнасы — бұл бір бағытты байланыс құралы. Тек иесі немесе әкімшілер хабарлама жібере алады, ал қалған қатысушылар оларды тек көре алады және пікір қалдыра алады.

Telegram тобына/арнасына ботты қалай қосуға болады

Бот үшін бұл мүмкіндік BotFather-да қосылған:

1-қадам. Бот параметрлеріне өтіңіз:

2-қадам. "Allow Groups?" түймесін басыңыз.

3-қадам. Қосулы күйі болуы керек.

Топқа/арнаға ботты әкімші ретінде қосу

Чаттар мен арналардағы жұмысты автоматтандыру үшін өз ботыңызды Әкімші ретінде қосуыңыз керек.

Мұны қалай жасауға болады?

1-қадам. Топты/Арнаны басқаруға өтіп, Administrators қойындысын таңдаңыз.

2-қадам. "Add Admin" түймесін басыңыз.

3-қадам. Іздеу өрісіне ботыңыздың пайдаланушы атын енгізіңіз.

4-қадам. Толық функционалдылық үшін боттың хабарламаларды оқу және жою құқықтары бар екеніне көз жеткізіңіз.

Чаттарда жұмыс істеуге арналған айнымалылар

Назар аударыңыз!

Чатқа қосылу, чаттан шығу, жаңа лайк сияқты оқиғалар үшін топтық чаттарда айнымалыларды сақтау қолжетімсіз.

Айнымалылар тек жұмыс істеген блоктың ішінде ғана қолжетімді болады. Жұмысты бақылау үшін бұл айнымалыларды блокта шығаруға болады.

Бұл чат-боттардың жұмысына ЕШҚАНДАЙ әсер етпейді, клиенттер бөлімінде кімнің кіргені/шыққанын бақылау мүмкін болмайды.

  • Хабарлама авторы туралы ақпараты бар айнымалылар

message_from - хабарлама авторының идентификаторы

message_from_name - хабарлама авторының аты

message_from_username - хабарлама авторының Telegram-дағы лақап аты

  • Қайта жіберілген хабарлама туралы ақпараты бар айнымалылар

reply_message_id - қайта жіберілетін хабарламаның нөмірі

reply_from - қайта жіберілген хабарламаның авторы кім

reply_from_name - хабарламасы қайта жіберілетін адамның аты

reply_from_username - хабарламасы қайта жіберілетін адамның лақап аты

reply_from_chat_id - хабарлама қайта жіберілген диалогтың нөмірі

  • Топқа қосу және топтан шығару

Бұл жағдайда new_chat_member және left_chat_member кері шақырулары іске қосылады (айнымалылар клиент картасында сақталмайды):

chat_member_name - пайдаланушы аты

chat_member_username - пайдаланушының лақап аты

chat_member_id - пайдаланушының нөмірі

Telegram-дағы кері шақырулар

client_unsubscribed - клиент жазылудан бас тартты, ботты бұғаттады

client_returned - клиент ботты бұғаттаудан шығарды

Топтардағы/арналардағы кері шақырулар

new_chat_member - жаңа пайдаланушы қосылды

left_chat_member - пайдаланушы арнадан шықты

kicked_chat_member - пайдаланушы әкімшімен жойылды

chat_join_request - арнаға қосу туралы сұрау алынды

edited_channel_post - арнадағы жазба өңделді (edited_channel_post + өңдеу күні мен уақыты)

Кері шақырулар Clients бөлімінде көрсетіледі

bot_added_to_group - бот чатқа қосылды (қайсысы маңызды емес, ол кез келгеніне жауап береді, тіпті қосылған боттың өзі топқа қосылса да);

bot_left_group - ұқсас кері шақыру ботты арнадан шығару;

new_like - жазбаға лайк басылды

like_deleted - жазбадан лайк жойылды

Кері шақырудағы сан (new_like; like_deleted) - жауап берілген немесе жойылған хабарламаның идентификаторы.

Назар аударыңыз!

  • Реакцияларға арналған кері шақырулар Telegram арналарында көрсетілмейді! Реакцияларға арналған кері шақырулар тек топтарда келеді.
  • Егер бір адам бірнеше лайк басып, содан кейін оның 1-ін жойса, қайсысы жойылғаны көрсетілмейді.

Топтарда реакциялары бар кері шақырулар пайда болғанда, блокта айнымалылар қолжетімді болады:

reaction_on_message_id - жауап берілген хабарламаның идентификаторын қамтиды

reaction_from - реакция болған адамның идентификаторы

message_from_username - реакция болған адамның пайдаланушы аты (бар болса)

reaction_from_name - реакция болған адамның аты

Сондай-ақ, егер Telegram хабарламаға жауап берсе, картадағы reply_text айнымалысы жауап берілген хабарламаның толық мәтінін қамтиды.

Егер хабарлама жауап ретінде жіберілсе (алдыңғы хабарламаны келтіре отырып), жүйе сонымен қатар келтірілген мәтінді қамтитын tg_quote айнымалысын жасайды.

Boost кері шақырулары

  • chat_boost_from user #{id_user} - чатқа (немесе арнаға) boost берді:

Бұл кері шақыру іске қосылғанда, айнымалылар жасалады:

  • remove_boost_from user #{id_user} - чаттан (немесе арнадан) boost алды:

Бұл кері шақыру іске қосылғанда, айнымалылар жасалады:

  • chat_boost from giveaway - арнада жұлдыздарды ойнату кезінде беріледі
  • remove_chat_boost from giveaway - арнада жұлдыздарды ойнатуға арналған boost мерзімі аяқталды

Топтардағы жүйелік хабарландыруларды жоюды қалай автоматтандыруға болады

Барлық жүйелік хабарламаларды автоматты түрде жою үшін del_tg_system_messages айнымалысына кез келген мәнді тағайындау жеткілікті (айнымалы жоба тұрақтысы да, транзакция айнымалысы да бола алады) және ботқа хабарламаларды жоюға рұқсат беру керек.

del_tg_system_messages айнымалысын тек топтарда пайдалануға болады. Арналарда бұл айнымалыға кез келген мәнді тағайындау ешқандай нәтижеге әкелмейді.

Telegram тобы параметрлеріндегі әкімші құқықтары

Жүйелік хабарландырулардың келесі түрлері жойылады:

- Топтың аты өзгертілді

- Топтың фотосы өзгертілді

- Топтың фотосы жойылды

- Хабарлама бекітілді

- Пайдаланушы топқа қосылды

- Пайдаланушы топтан шықты

Егер сіз жүйелік хабарландырулардың тек таңдаулы түрлерін жойғыңыз келсе, онда del_tg_system_messages айнымалысының орнына del_tg_chosen_messages айнымалысын жасаңыз және оған үтірмен бөлінген жойылатын хабарландыру түрлерінің массивін салыңыз.

Назар аударыңыз!

Бұл айнымалылар тек Telegram топтары үшін жұмыс істейді, бірақ арналар үшін емес.

Жүйелік хабарландыру опциялары:

  • 'new_chat_member' – пайдаланушы топқа қосылды,
  • 'left_chat_member' – пайдаланушы топтан шықты,
  • 'pinned_message' – хабарлама бекітілді,
  • 'delete_chat_photo' – топтың фотосы жойылды,
  • 'new_chat_photo' – топтың фотосы өзгертілді,
  • 'new_chat_title' – топтың аты өзгертілді

Мысалы, топқа қосылудан басқа жүйелік хабарламалардың барлық түрлерін жою қажет; содан кейін жоба айнымалысына (тұрақтысына) "new_chat_member"-ден басқа кері шақырулардың барлық түрлерін қосу керек.

Назар аударыңыз!

Жүйелік хабарландыруларды жою кері шақыруларға әсер етпейді. Тек Telegram диалогындағы жүйелік хабарлама ғана жойылады.

Telegram-дағы форум

Форум — бұл талқылау үшін жеке тақырыптар жасауға болатын топ. Форумда стандартты функцияларды пайдалануға болады: медиа файлдарды тіркеу, сауалнамаларды орналастыру және хабарландыруларды орнату. Сондай-ақ хабарламаларды бекітуге және әрбір чатқа жеке боттарды қосуға болады.

Форумның негізгі мақсаты — үлкен қауымдастық ішінде қарым-қатынасты құрылымдау.

Көптеген қатысушылары бар стандартты топтық чатта әңгімелерді қадағалау және сәйкес хабарламаларды табу қиынға соғады. Форумдар мұны талқылауларды арнайы, тақырыптық талқылауларға бөлу арқылы шешеді. Бұл қауымдастықты тақырып пен қызығушылық бойынша автоматты түрде сегменттейді, байланысты неғұрлым бағытталған және басқарылатын етеді.

Топта 100-ден астам мүше болса, тек топ иесі тақырып жасай алады. Егер топ арнамен байланыстырылса, онда тақырып жасай алмайсыз. Тақырыптар Топ параметрлерінде қосылады:

Әкімші ретінде сіз форум тобының параметрлерінде тақырып жасай аласыз:

Тақырыптарды қосқаннан кейін аватар дөңгелектен шаршыға өзгереді, бұл форумды басқа Telegram чаттарынан ажыратуға мүмкіндік береді:

Telegram-клиент пен веб-сайт байламын қалай конфигурациялауға болады?

Telegram клиенті мен веб-сайттағы клиентті сәтті төлемнен кейін қалай байланыстыру туралы толығырақ мына жерден оқыңыз.