Mēs iesakām izlasīt rakstu Button.

Telegramā varat izmantot gan atbildes pogas (parastās vai tastatūras pogas), gan Inline pogas (pogas tekstā).

Svarīgi: pogu ierobežojumi

Lūdzu, ņemiet vērā šādus platformas ierobežojumus, veidojot pogas:

  • Atbildes pogas (tastatūra): maksimāli 12 pogas rindā.
  • Inline pogas: Maksimāli 8 pogas rindā.
  • Pogas teksts: Ierobežots līdz 32 rakstzīmēm.
  • Pogas krāsa: nevar pielāgot. Pogām tiek izmantots noklusējuma platformas stils.

Kā izveidot pogu blokā

Lai izveidotu jebkuru pogu tērzēšanas robotā, dodieties uz bloka iestatījumiem un noklikšķiniet uz cilnes "Buttons" (Pogas):

Pēc tam tiks atvērti iestatījumi pogas pievienošanai un rediģēšanai. Pēc tam noklikšķiniet uz Add (Pievienot):

Tiks atvērts iestatījumu logs, kas ļauj definēt pogas nosaukumu, darbību un papildu opcijas.

Šādi pogu veidi ir pieejami tikai Telegram robotam:

  • Share button (Kopīgošanas poga) – ļauj lietotājiem kopīgot saturu.
  • Callback button (Atgriezeniskās saites poga) – nosūta klusu atgriezeniskās saites vaicājumu jūsu robotam.
  • Telegram WebApp – atver mini lietojumprogrammu (piemēram, logrīku vai vietni) Telegram ietvaros.
  • Telegram login (Telegram pieteikšanās) – autorizē lietotājus, izmantojot viņu Telegram kontu.

Telegramā ir pieejamas arī citas pogas, piemēram, maksājumu, tālruņa numura vai ģeolokācijas pieprasījuma un saites nosūtīšanas pogas.

Share button (Kopīgošanas poga)

Veidojot pogu, atlasiet "Share (Telegram only)" (Kopīgot (tikai Telegram)) un aizpildiet laukus (neobligāts papildu teksta lauks):

Šī poga ļauj pārsūtīt informāciju, atlasot kontaktpersonu no saraksta.

Ievadiet URL, kuru vēlaties kopīgot, pogas laukā "Share link" (Kopīgošanas saite).

Kad kontaktpersona ir atlasīta, tiks nosūtīts saturs no laukiem "Share link" (Kopīgošanas saite) un "Additional text" (Papildu teksts). Izmantojiet to, lai kopīgotu saites uz Telegram kanālu ierakstiem un citu saturu.

Uzmanību! Dažās iOS ierīcēs tas var nedarboties pareizi.

Website login button (Vietnes pieteikšanās poga)

Lai pieteikšanās poga darbotos, jūsu robots vispirms ir jāautorizē mērķa domēnam. Šī konfigurācija tiek veikta, izmantojot @BotFather.

Konfigurēšanas soļi:

  1. Atveriet tērzēšanu ar @BotFather.
  2. Sarakstā atlasiet savu robotu.
  3. Izvēlieties Bot Settings (Robota iestatījumi) > Domain (Domēns) un pievienojiet savas vietnes domēnu.

Pēc tam noklikšķiniet uz pogas Domain (Domēns):

Piezīme: Poga rādīs Edit domain (Rediģēt domēnu), ja domēns jau pastāv, vai Set domain (Iestatīt domēnu), ja tas ir jāpievieno.

Jums tiks piedāvāts iestatīt domēnu savam robotam:

Pareizs domēna formāts:

Ievadiet savu domēnu kā mavibot.ai vai kā yourdomain.com, ja jums ir vietne, kas savienota ar MaviBot.

Nākamais solis:

Kad jūsu domēns ir verificēts un konfigurēts, varat turpināt autorizācijas pogas izveidi.

Laukā Text (Teksts) ievadiet nosaukumu, kas tiks rādīts uz pogas.

Pēc tam laukā Link (Saite) norādiet lapas URL, kurā notiks autorizācija.

Atlikušie lauki būs nepieciešami, ja autorizācijai tiek izmantots atsevišķs robots (jums ir jāiegūst atļauja sūtīt ziņojumus šim robotam): jo īpaši jums būs jānorāda robota nosaukums.

Ja jums ir nepieciešama iespēja sūtīt ziņojumus no norādītā robota, noteikti atzīmējiet izvēles rūtiņu "Request permission from the user to send messages from the bot" (Pieprasīt atļauju no lietotāja sūtīt ziņojumus no robota):

Telegram pieteikšanās poga

Callback button (Atgriezeniskās saites poga)

Callback poga ir atgriezeniskās saites poga, kad klients redz vienu lietu, bet robotā mēs saņemam nepieciešamo atgriezenisko saiti, lai palaistu jebkuru piltuves bloku.

To izveidot ir pavisam vienkārši: laukā Buttons (Pogas) noklikšķiniet uz pogas Add (Pievienot). Atvērtajā formā ievadiet tekstu, norādiet veidu - Callback button (Telegram) un ievadiet Callback text (Atgriezeniskās saites teksts), kam jāatgriežas, noklikšķinot uz pogas:

Vizuāli poga izskatās kā parasta inline poga:

Pēc noklikšķināšanas uz pogas klienta kartē redzēsiet konfigurēto Callback (Atgriezenisko saiti):

Tas ir svarīgi!

Telegram neatbalsta Callback tastatūras pogas.

Lūdzu, ņemiet vērā!

Ja ir atlasīts pogas veids "Callback" (Atgriezeniskā saite), poga tiks rādīta kā atgriezeniskā saite tikai tad, ja pogas teksts atšķiras no atgriezeniskās saites teksta.

Telegram Web Application poga

Šī poga ļauj atvērt vietni kā tīmekļa lietojumprogrammu Telegram.

Pievienojot pogu, norādiet tās nosaukumu, atlasiet Telegram Web App pogas veidu un norādiet saiti uz vietni, kas tiks atvērta kā tīmekļa lietojumprogramma:

  • Saiti var norādīt, izmantojot mainīgo:

Mainīgā izmantošana saitei ir ļoti praktiska, ja mērķa lapa vai vietnes adrese bieži mainās.

Kā tas darbojas:

  1. Definējiet mainīgo (piemēram, landing_page_url) sava projekta iestatījumos.
  2. Atsaucieties uz šo mainīgo (piemēram, #{landing_page_url}) visās Web App pogās visās plūsmās.

Ieguvums: tā vietā, lai manuāli atjauninātu URL katrā atsevišķā pogas blokā, jums tikai vienreiz jāmaina mainīgā vērtība projekta iestatījumos, un visas pogas tiks automātiski atjauninātas.

Alternatīva: protams, pogas iestatījumos joprojām varat norādīt tiešu, statisku URL.

Kā izveidot pogas Telegram API funkcijām

Lai gan darbs tieši ar Telegram Bot API var būt sarežģīts, īpaši iesācējiem, MaviBot piedāvā daudz pieejamāku alternatīvu.

Metode: izmantot ģenerētu kodu

Varat izmantot iepriekš ģenerētu pogu kodu no papildu iestatījumiem, tādējādi novēršot nepieciešamību rakstīt API izsaukumus manuāli.

Soļi:

  1. Dodieties uz sava bloka iestatījumiem un atveriet sadaļu Buttons (Pogas).
  2. Izmantojiet saskarni, lai pievienotu un konfigurētu visas nepieciešamās pogas (tekstu, saites, funkcijas).
  3. Sistēma automātiski ģenerēs pareizo Telegram API kodu fonā.

Šī pieeja ļauj vizuāli izveidot sarežģītas tastatūras, kamēr platforma apstrādā pamatā esošo tehnisko ieviešanu.

Noklikšķiniet uz "Advanced Settings" (Papildu iestatījumi), lai skatītu ģenerēto Telegram API kodu savām pogām.

Pārbaudiet savas pogas, pēc tam kopējiet ģenerēto kodu no Advanced Settings (Papildu iestatījumi) mainīgajā, piemēram, buttons.

Šī funkcija nosūta ziņojumu, izmantojot Telegram API ar šādiem parametriem: tg_send_message (platform_id, text,client_message_id, reply_markup, sparse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities):

Nododiet pogu mainīgo funkcijai parametrā reply_markup:

Jūsu pogas parādīsies tērzēšanā ar jūsu definēto izkārtojumu un stilu.

Kā dzēst atbildes pogas

Lai gan tastatūras pogas parasti pazūd automātiski, dažreiz tās var palikt redzamas.

Lai piespiedu kārtā notīrītu palikušās atbildes pogas, ievietojiet laukā Advanced Settings (Papildu iestatījumi) šādu kodu:

[{"buttons":[],"one_time":true,"index_in_line":0,"line":0}]

Šī tukšā pogu konfigurācija liek Telegram paslēpt pielāgoto tastatūru.

Tastatūras izvēlnes pogas Telegram

Mēs iesakām šo funkciju izmantot tikai pieredzējušiem lietotājiem!

Tastatūras pogas

Lai varētu izmantot tastatūras pogas (atbildes) kā pastāvīgu Telegram izvēlni, pietiek piešķirt jebkuru vērtību mainīgajam tg_permanent_reply_buttons (mainīgais tiek deklarēts kā projekta konstante).

Mainīgais: tg_permanent_reply_buttons

Mainīgā tg_permanent_reply_buttons iestatīšana sniedz jums pilnīgu manuālu kontroli pār atbildes tastatūras (pogas zem ziņojuma) redzamību. Visa automātiskā slēpšanas uzvedība, ko veic platforma, tiek atspējota.

Darbības joma: šis iestatījums attiecas uz visām atbildes pogām, kas izveidotas robotā, kamēr mainīgais ir aktīvs.

Atgriešanās pie automātiskās uzvedības

Lai atjaunotu standarta automātisko tastatūras slēpšanu:

  1. Noņemiet mainīgo tg_permanent_reply_buttons no sava projekta iestatījumiem.
  2. Pārveidojiet jebkuras atbildes pogas, kas sākotnēji tika izveidotas, kamēr mainīgais bija aktīvs. Pogām, kas izveidotas saskaņā ar "pastāvīgo" noteikumu, šis stāvoklis saglabājas, un tās ir jāpārveido, lai tās pārmantotu jauno, automātisko uzvedību.

Kā izveidot izvēlni Telegram

Tas, kurš izveidoja Telegram robotu, var izveidot šādu izvēlni.

Lai to izdarītu, rakstiet Botfather Telegram.

Ievadiet komandu /mybots, un tiek atvērts jūsu robotu saraksts. Izvēlieties vajadzīgo. Jums tiek atvērta izvēlne. Šeit jums jāizvēlas Edit Bot (Rediģēt robotu) un pēc tam Edit Commands (Rediģēt komandas).

Ievadiet visas komandas un to aprakstus vienā ziņojumā, izmantojot mazos burtus komandu nosaukumiem. Kad saraksts ir atjaunināts, jūs saņemsiet apstiprinājumu.

Tagad varat redzēt un izmantot izvēlni savā Telegram tērzēšanā ar robotu.

Noklikšķinot uz izvēlnes pogas, tiks atvērts komandu saraksts, kas iepriekš tika reģistrētas BotFather:

Pēc tam dodieties uz Mavibot, atveriet projektu, kuram šis telegram robots ir pievienots.

Izveidojiet blokus Start (Sākums) vai Trigger (Triggers), ierakstiet komandas nosacījumos un laukā "Message text" (Ziņojuma teksts) — tekstus, kas tiks saņemti atbildē.

Piemērs:

Kā apvienot divu veidu pogas

Izveidojiet bloku ar atbildes pogu (tastatūru), kuru nepieciešams vizualizēt.

Izveidojiet nākamo bloku (0 sekunžu taimeris) ar inline pogām (pogas tekstā), kuras jānovieto, nenoņemot atbildes pogas. Piemēram: [{"type": "inline", "text": "BUTTON NAME", "line": 0, "index_in_line": 0}]

Lūk, rezultāts:

Svarīgi: pievienojot pogas vienā blokā, jāievēro šāda secība:

  1. Vispirms pievienojiet visas atbildes (tastatūras) pogas.
  2. Pēc tam pievienojiet jebkuras Inline pogas.

Ja šī secība tiek mainīta, atbildes pogas tiks noņemtas, kad tiks nosūtīts nākamais ziņojuma bloks.