Add more Walkthrough sections

Author: rojvv

src/account-auto-deletion.md

@@ -0,0 +1,27 @@
+---
+title: Account Auto-Deletion
+parent: /#walkthrough
+walkthrough:
+  track: user
+  order: 14
+---
+
+User clients can control when an inactive account is automatically deleted.
+
+## Getting the Auto-Deletion Period
+
+Use {{ "getAccountTtl" |> m }} to get the period in days.
+
+```ts
+const dayCount = await client.getAccountTtl();
+
+console.log(dayCount);
+```
+
+## Setting the Auto-Deletion Period
+
+Use {{ "setAccountTtl" |> m }} with the period in days.
+
+```ts
+await client.setAccountTtl(365);
+```

src/bot-commands.md

@@ -23,7 +23,7 @@ This only changes the displayed command list. Register handlers separately with
 
 ## Scoping and Localizing Commands
 
-Pass a `scope` to show a command list only in specific chats. This example sets a command for group administrators.
+Pass a `scope` to show a command list only to specific audiences or in specific chats. This example sets a command for group administrators.
 
 ```ts
 await client.setMyCommands(
@@ -36,8 +36,8 @@ Pass `languageCode` to set a localized command list.
 
 ```ts
 await client.setMyCommands(
-  [{ command: "help", description: "Hilfe anzeigen" }],
-  { languageCode: "de" },
+  [{ command: "help", description: "Показать справку" }],
+  { languageCode: "ru" },
 );
 ```
 

src/bot-write-access.md

@@ -0,0 +1,25 @@
+---
+title: Bot Write Access
+parent: /#walkthrough
+walkthrough:
+  track: bot
+  order: 16
+---
+
+Bots can detect when a user allows them to send messages.
+
+## Handling Write Access
+
+Handle `message:writeAccessAllowed` to receive the service message.
+
+```ts
+client.on("message:writeAccessAllowed", (ctx) => {
+  const { miniAppName } = ctx.msg.writeAccessAllowed;
+
+  console.log(
+    miniAppName ? `Write access granted through ${miniAppName}` : "Write access granted",
+  );
+});
+```
+
+`miniAppName` is present when access was granted through a Mini App.

src/channel-direct-messages.md

@@ -0,0 +1,31 @@
+---
+title: Channel Direct Messages
+parent: /#walkthrough
+walkthrough:
+  track: main
+  order: 19
+---
+
+Bots can reply to messages sent through a channel's direct messages.
+
+## Replying to a Direct Message
+
+Incoming direct messages have a `directMessagesTopicId`. Context reply methods reuse it automatically.
+
+```ts
+client.on("message", async (ctx) => {
+  if (ctx.msg.directMessagesTopicId === undefined) {
+    return;
+  }
+
+  await ctx.reply("Thanks for contacting us.");
+});
+```
+
+When sending outside an update handler, pass the topic ID explicitly.
+
+```ts
+await client.sendMessage(chatId, "Thanks for contacting us.", {
+  directMessagesTopicId,
+});
+```

src/login-buttons.md

@@ -0,0 +1,36 @@
+---
+title: Login Buttons
+parent: /#walkthrough
+walkthrough:
+  track: bot
+  order: 15
+---
+
+Bots can let users sign in to a website with their Telegram account.
+
+## Sending a Login Button
+
+Link the website's domain to the bot through [@BotFather](https://t.me/BotFather), then send a `loginUrl` button with an HTTPS URL.
+
+```ts
+client.command("login", async (ctx) => {
+  await ctx.reply("Sign in to continue:", {
+    replyMarkup: {
+      type: "inlineKeyboard",
+      inlineKeyboard: [
+        [
+          {
+            type: "loginUrl",
+            text: "Sign in",
+            loginUrl: {
+              url: "https://example.com/login",
+            },
+          },
+        ],
+      ],
+    },
+  });
+});
+```
+
+Telegram adds signed authentication data to the URL. Verify it on the server before signing the user in.

src/message-translation.md

@@ -0,0 +1,36 @@
+---
+title: Message Translation
+parent: /#walkthrough
+walkthrough:
+  track: user
+  order: 12
+---
+
+User clients can translate messages and text into another language.
+
+## Translating a Message
+
+Use {{ "translateMessage" |> m }} with the target language code, chat identifier, and message identifier.
+
+```ts
+const translation = await client.translateMessage("en", chatId, messageId);
+
+console.log(translation.text);
+```
+
+Use {{ "translateMessages" |> m }} to translate multiple messages at once.
+
+## Translating Text
+
+Use {{ "translateText" |> m }} with the target language code and a {{ "TextToTranslate" |> t }}.
+
+```ts
+const translation = await client.translateText("en", {
+  text: "Hola",
+  entities: [],
+});
+
+console.log(translation.text);
+```
+
+Use {{ "translateTexts" |> m }} to translate multiple texts at once.

src/paid-media.md

@@ -0,0 +1,19 @@
+---
+title: Paid Media
+parent: /#walkthrough
+walkthrough:
+  track: main
+  order: 20
+---
+
+Bots can require users to pay Telegram Stars before viewing a photo or video.
+
+## Sending Paid Media
+
+Pass `starCount` to {{ "sendPhoto" |> m }} or {{ "sendVideo" |> m }} to set the number of Stars required to unlock the media.
+
+```ts
+await client.sendPhoto(chatId, "./photo.jpg", {
+  starCount: 25,
+});
+```

src/premium-subscription-gifts.md

@@ -0,0 +1,25 @@
+---
+title: Premium Subscription Gifts
+parent: /#walkthrough
+walkthrough:
+  track: bot
+  order: 13
+---
+
+Bots can gift Telegram Premium subscriptions to users with Telegram Stars.
+
+## Gifting a Subscription
+
+Use {{ "giftPremiumSubscription" |> m }} with the user's identifier and a duration of 3, 6, or 12 months.
+
+```ts
+await client.giftPremiumSubscription(userId, 3);
+```
+
+Pass `text` to attach a message to the gift.
+
+```ts
+await client.giftPremiumSubscription(userId, 12, {
+  text: "Thanks for being part of the community!",
+});
+```

src/requesting-users.md

@@ -0,0 +1,45 @@
+---
+title: Requesting Users
+parent: /#walkthrough
+walkthrough:
+  track: bot
+  order: 14
+---
+
+Bots can ask users to select a user through Telegram's user picker.
+
+## Requesting a User
+
+Send a `requestUser` button in a custom keyboard. The `requestId` identifies the request when the user responds.
+
+```ts
+client.command("choose_user", async (ctx) => {
+  await ctx.reply("Choose a user:", {
+    replyMarkup: {
+      type: "keyboard",
+      keyboard: [
+        [
+          {
+            type: "requestUser",
+            text: "Choose a user",
+            requestId: 1,
+          },
+        ],
+      ],
+      isOneTime: true,
+      isResized: true,
+    },
+  });
+});
+```
+
+## Handling the Selection
+
+The bot receives a `userShared` message containing the request ID and selected user ID.
+
+```ts
+client.on("message:userShared", (ctx) => {
+  const { requestId, userId } = ctx.msg.userShared;
+  console.log(requestId, userId);
+});
+```

src/usernames.md

@@ -0,0 +1,59 @@
+---
+title: Usernames
+parent: /#walkthrough
+walkthrough:
+  track: user
+  order: 13
+---
+
+User clients can check and manage the account's usernames.
+
+## Checking a Username
+
+Use {{ "checkUsername" |> m }} to check whether a username is available.
+
+```ts
+const isAvailable = await client.checkUsername("example_username");
+
+console.log(isAvailable);
+```
+
+## Setting a Username
+
+Use {{ "setUsername" |> m }} to set the account's username.
+
+```ts
+await client.setUsername("example_username");
+```
+
+## Showing a Username
+
+Use {{ "showUsername" |> m }} to show a username on the account's profile.
+
+```ts
+await client.showUsername("me", "example_username");
+```
+
+## Hiding a Username
+
+Use {{ "hideUsername" |> m }} to hide a username from the account's profile.
+
+```ts
+await client.hideUsername("me", "example_username");
+```
+
+## Reordering Usernames
+
+Use {{ "reorderUsernames" |> m }} to change the order of the account's usernames.
+
+```ts
+await client.reorderUsernames("me", ["primary_username", "example_username"]);
+```
+
+## Removing a Username
+
+Use {{ "removeUsername" |> m }} to remove the account's username.
+
+```ts
+await client.removeUsername();
+```