Deep Link: Support bot creation link (#7413)

Author: Ajaxy

src/api/gramjs/apiBuilders/appConfig.ts

@@ -29,7 +29,8 @@ type Limit =
   | 'recommended_channels_limit'
   | 'saved_dialogs_pinned_limit'
   | 'reactions_user_max'
-  | 'aicompose_tone_saved_limit';
+  | 'aicompose_tone_saved_limit'
+  | 'bots_create_limit';
 type LimitKey = `${Limit}_${LimitType}`;
 type LimitsConfig = Record<LimitKey, number>;
 
@@ -150,6 +151,7 @@ export interface GramJsAppConfig extends LimitsConfig {
   aicompose_tone_examples_num?: number;
   aicompose_tone_title_length_max?: number;
   aicompose_tone_prompt_length_max?: number;
+  bot_allowed_suffixes?: string[];
 }
 
 function buildEmojiSounds(appConfig: GramJsAppConfig) {
@@ -237,6 +239,7 @@ export function buildAppConfig(json: GramJs.TypeJSONValue, hash: number): ApiApp
       maxReactions: getLimit(appConfig, 'reactions_user_max', 'maxReactions'),
       moreAccounts: DEFAULT_LIMITS.moreAccounts,
       aiComposeToneSaved: getLimit(appConfig, 'aicompose_tone_saved_limit', 'aiComposeToneSaved'),
+      botsCreate: getLimit(appConfig, 'bots_create_limit', 'botsCreate'),
     },
     richMessageLengthLimit: appConfig.rich_message_length_limit ?? DEFAULT_APP_CONFIG.richMessageLengthLimit,
     richMessageMaxBlocks: appConfig.rich_message_max_blocks ?? DEFAULT_APP_CONFIG.richMessageMaxBlocks,
@@ -318,6 +321,7 @@ export function buildAppConfig(json: GramJs.TypeJSONValue, hash: number): ApiApp
     aiComposeToneExamplesNum: appConfig.aicompose_tone_examples_num,
     aiComposeToneTitleLengthMax: appConfig.aicompose_tone_title_length_max,
     aiComposeTonePromptLengthMax: appConfig.aicompose_tone_prompt_length_max,
+    botAllowedSuffixes: appConfig.bot_allowed_suffixes,
   };
 
   return {

src/api/gramjs/apiBuilders/messageActions.ts

@@ -207,6 +207,13 @@ export function buildApiMessageAction(action: GramJs.TypeMessageAction): ApiMess
       peerIds: action.peers.map(getApiChatIdFromMtpPeer),
     };
   }
+  if (action instanceof GramJs.MessageActionManagedBotCreated) {
+    return {
+      mediaType: 'action',
+      type: 'managedBotCreated',
+      botId: buildApiPeerId(action.botId, 'user'),
+    };
+  }
   if (action instanceof GramJs.MessageActionBoostApply) {
     const { boosts } = action;
     return {

src/api/gramjs/apiBuilders/users.ts

@@ -40,7 +40,7 @@ export function buildApiUserFullInfo(mtpUserFull: GramJs.users.UserFull): ApiUse
       botCanManageEmojiStatus, settings, sendPaidMessagesStars, displayGiftsButton, disallowedGifts,
       starsRating, starsMyPendingRating, starsMyPendingRatingDate, mainTab, savedMusic, note,
       noforwardsMyEnabled, noforwardsPeerEnabled, unofficialSecurityRisk, privateForwardName,
-      ttlPeriod,
+      ttlPeriod, botManagerId,
     },
     users,
   } = mtpUserFull;
@@ -87,6 +87,7 @@ export function buildApiUserFullInfo(mtpUserFull: GramJs.users.UserFull): ApiUse
     noForwardsMyEnabled: noforwardsMyEnabled,
     noForwardsPeerEnabled: noforwardsPeerEnabled,
     isUnofficialSecurityRisk: unofficialSecurityRisk,
+    botManagerId: botManagerId !== undefined ? buildApiPeerId(botManagerId, 'user') : undefined,
   };
 }
 
@@ -123,7 +124,7 @@ export function buildApiUser(mtpUser: GramJs.TypeUser): ApiUser | undefined {
     id, firstName, lastName, fake, scam, support, closeFriend, storiesUnavailable,
     botActiveUsers, botVerificationIcon, botInlinePlaceholder, botAttachMenu, botCanEdit,
     sendPaidMessagesStars, profileColor, botForumView, botForumCanManageTopics, botGuestchat,
-    botGuard,
+    botGuard, botCanManageBots,
   } = mtpUser;
   const storiesMaxId = mtpUser.storiesMaxId?.maxId;
   const hasVideoAvatar = mtpUser.photo instanceof GramJs.UserProfilePhoto ? Boolean(mtpUser.photo.hasVideo) : undefined;
@@ -169,6 +170,7 @@ export function buildApiUser(mtpUser: GramJs.TypeUser): ApiUser | undefined {
     paidMessagesStars: toJSNumber(sendPaidMessagesStars),
     isBotForum: botForumView,
     canManageBotForumTopics: botForumCanManageTopics,
+    canManageBots: botCanManageBots,
     isGuestChatBot: botGuestchat,
     isGuardBot: botGuard || undefined,
   };

src/api/gramjs/methods/bots.ts

@@ -41,13 +41,16 @@ import {
   addDocumentToLocalDb,
   addInlineBotRepairInfo,
   addPhotoToLocalDb,
+  addUserToLocalDb,
   addWebDocumentToLocalDb,
 } from '../helpers/localDb';
-import { deserializeBytes } from '../helpers/misc';
+import { checkErrorType, deserializeBytes, wrapError } from '../helpers/misc';
 import { sendApiUpdate } from '../updates/apiUpdateEmitter';
 import { invokeRequest } from './client';
 import { returnTonConnectOauthSession, takeTonConnectOauthSession } from './tonConnect';
 
+const BOT_USERNAME_ERRORS = new Set(['USERNAME_OCCUPIED', 'USERNAME_INVALID', 'USERNAME_SUFFIX_MISSING']);
+
 export async function answerCallbackButton({
   chatId, accessHash, messageId, data, isGame,
 }: {
@@ -749,6 +752,51 @@ export async function fetchBotsRecommendations({ user }: { user: ApiChat }) {
   };
 }
 
+export async function checkBotUsername({ username }: { username: string }) {
+  try {
+    const result = await invokeRequest(new GramJs.bots.CheckUsername({ username }), {
+      shouldThrow: true,
+    });
+
+    return { result, error: undefined };
+  } catch (err: unknown) {
+    if (err instanceof RPCError && BOT_USERNAME_ERRORS.has(err.errorMessage)) {
+      return { result: false, error: err.errorMessage };
+    }
+
+    throw err;
+  }
+}
+
+export async function createBot({
+  manager, name, username, isViaDeepLink,
+}: {
+  manager: ApiUser;
+  name: string;
+  username: string;
+  isViaDeepLink?: true;
+}) {
+  try {
+    const result = await invokeRequest(new GramJs.bots.CreateBot({
+      managerId: buildInputUser(manager.id, manager.accessHash),
+      name,
+      username,
+      viaDeeplink: isViaDeepLink,
+    }), {
+      shouldThrow: true,
+    });
+
+    if (!(result instanceof GramJs.User)) return undefined;
+
+    addUserToLocalDb(result);
+
+    return buildApiUser(result);
+  } catch (err) {
+    if (!checkErrorType(err)) return undefined;
+    return wrapError(err);
+  }
+}
+
 async function invokeUrlAuthRequest(
   request: GramJs.messages.RequestUrlAuth | GramJs.messages.AcceptUrlAuth,
 ): Promise<ApiUrlAuthResult | undefined> {

src/api/types/messageActions.ts

@@ -128,6 +128,11 @@ export interface ApiMessageActionRequestedPeer extends ActionMediaType {
   peerIds: string[];
 }
 
+export interface ApiMessageActionManagedBotCreated extends ActionMediaType {
+  type: 'managedBotCreated';
+  botId: string;
+}
+
 export interface ApiMessageActionContactSignUp extends ActionMediaType {
   type: 'contactSignUp';
 }
@@ -443,7 +448,7 @@ export type ApiMessageAction = ApiMessageActionUnsupported | ApiMessageActionCha
   | ApiMessageActionGameScore | ApiMessageActionPaymentSent | ApiMessageActionPhoneCall
   | ApiMessageActionScreenshotTaken | ApiMessageActionCustomAction | ApiMessageActionBotAllowed
   | ApiMessageActionBoostApply | ApiMessageActionContactSignUp | ApiMessageActionExpiredContent
-  | ApiMessageActionRequestedPeer
+  | ApiMessageActionRequestedPeer | ApiMessageActionManagedBotCreated
   | ApiMessageActionGroupCall | ApiMessageActionInviteToGroupCall | ApiMessageActionGroupCallScheduled
   | ApiMessageActionChatJoinedByRequest | ApiMessageActionChatJoinedViaCommunity
   | ApiMessageActionWebViewDataSent | ApiMessageActionGiftPremium

src/api/types/misc.ts

@@ -377,6 +377,7 @@ export interface ApiAppConfig {
   aiComposeToneExamplesNum?: number;
   aiComposeToneTitleLengthMax?: number;
   aiComposeTonePromptLengthMax?: number;
+  botAllowedSuffixes?: string[];
 }
 
 export interface ApiConfig {
@@ -511,17 +512,18 @@ export type ApiLimitType =
   | 'savedDialogsPinned'
   | 'maxReactions'
   | 'moreAccounts'
-  | 'aiComposeToneSaved';
+  | 'aiComposeToneSaved'
+  | 'botsCreate';
 
 export type ApiLimitTypeWithModal = Exclude<ApiLimitType, (
   'messageLength' | 'captionLength' | 'aboutLength' | 'stickersFaved' | 'savedGifs' | 'recommendedChannels'
   | 'moreAccounts'
-  | 'maxReactions' | 'aiComposeToneSaved'
+  | 'maxReactions' | 'aiComposeToneSaved' | 'botsCreate'
 )>;
 
 export type ApiLimitTypeForPromo = Exclude<ApiLimitType,
   'uploadMaxFileparts' | 'messageLength' | 'chatlistInvites' | 'chatlistJoined' | 'savedDialogsPinned'
-  | 'maxReactions' | 'aiComposeToneSaved'
+  | 'maxReactions' | 'aiComposeToneSaved' | 'botsCreate'
 >;
 
 export type ApiPeerNotifySettings = {

src/api/types/users.ts

@@ -49,6 +49,7 @@ export interface ApiUser {
   paidMessagesStars?: number;
   isBotForum?: boolean;
   canManageBotForumTopics?: boolean;
+  canManageBots?: boolean;
   isGuestChatBot?: boolean;
   isGuardBot?: boolean;
 }
@@ -93,6 +94,7 @@ export interface ApiUserFullInfo {
   noForwardsMyEnabled?: boolean;
   noForwardsPeerEnabled?: boolean;
   isUnofficialSecurityRisk?: boolean;
+  botManagerId?: string;
 }
 
 export type ApiUserType = 'userTypeBot' | 'userTypeRegular' | 'userTypeDeleted' | 'userTypeUnknown';

src/assets/localization/fallback.strings

@@ -263,12 +263,44 @@
 "RequestPeerChooseChannel_one" = "Choose a Channel";
 "RequestPeerChooseChannel_other" = "Choose Channels";
 "ActionRequestedPeer" = "You shared {peer} with {bot}";
+"ProfileBotManagedBy" = "Created and managed by {bot}";
+"ActionManagedBotCreated" = "{from} created {bot}";
+"ActionManagedBotCreatedYou" = "You created {bot}";
 "RequestPeerConfirm" = "Are you sure you want to send **{peer}** to **{bot}**?";
 "RequestPeerConfirmAddBot" = "This will also add **{bot}** to **{peer}**.";
 "RequestPeerConfirmBotRights" = "This will also add **{bot}** to **{peer}** with the following admin rights: {rights}.";
 "RequestPeerSelectLimit_one" = "You can select up to {count}.";
 "RequestPeerSelectLimit_other" = "You can select up to {count}.";
 "RequestPeerRequirements" = "Requirements";
+"RequestPeerReqPremium" = "The user should have a Premium subscription.";
+"RequestPeerReqNoPremium" = "The user should not have a Premium subscription.";
+"RequestPeerReqPublicChannel" = "The channel should be public.";
+"RequestPeerReqPrivateChannel" = "The channel should be private.";
+"RequestPeerReqPublicGroup" = "The group should be public.";
+"RequestPeerReqPrivateGroup" = "The group should be private.";
+"RequestPeerReqForum" = "The group should have topics turned on.";
+"RequestPeerReqNoForum" = "The group should have topics turned off.";
+"RequestPeerReqOwnerChannel" = "You should be the owner of the channel.";
+"RequestPeerReqOwnerGroup" = "You should be the owner of the group.";
+"RequestPeerReqAdminRights" = "You should have these admin rights: {rights}.";
+"RequestPeerReqBotMember" = "Bot should be in the group.";
+"CreateBotTitle" = "Create Bot";
+"CreateBotText" = "{bot} would like to create and manage a chatbot on your behalf.";
+"CreateBotName" = "Bot Name";
+"CreateBotUsername" = "Bot Username";
+"CreateBotUsernameChecking" = "Checking...";
+"CreateBotUsernameSuffix" = "Sorry, the username must end in 'bot'.";
+"CreateBotUsernameHint" = "Must end in 'bot' – or {suffixes} with {premium}.";
+"CreateBotUsernamePremium" = "Usernames ending in '{suffix}' require Telegram Premium. {link}";
+"CreateBotUsernameSubscribe" = "Subscribe";
+"CreateBotUsernameHelp" = "Choose a username for your bot. It must end in 'bot'. Like this, for example: TetrisBot or tetris_bot.";
+"CreateBotCreatedTitle" = "{name} created!";
+"CreateBotCreatedText" = "**{bot}** will manage this bot for you.";
+"CreateBotUnsupported" = "**{bot}** doesn't support Bot Management mode.";
+"CreateBotLimitTitle" = "Bot Limit Exceeded";
+"CreateBotLimitText_one" = "You can create up to {count} bot, or delete your current ones via @BotFather";
+"CreateBotLimitText_other" = "You can create up to {count} bots, or delete your current ones via @BotFather";
+"CreateBotLimitTextPremium" = "Subscribe to **Premium** to create up to {premiumLimit} bots, or delete one of your {limit} bots via @BotFather";
 "RequestPeerReqPremium" = "The user must have a Premium subscription.";
 "RequestPeerReqNoPremium" = "The user must not have a Premium subscription.";
 "RequestPeerReqPublicChannel" = "The channel must be public.";
@@ -1298,6 +1330,11 @@
 "AttachGiveawayResults" = "Giveaway Results";
 "ServiceNotifications" = "service notifications";
 "Bot" = "bot";
+"BotStatusApp" = "App";
+"BotStatusAgent" = "Agent";
+"BotStatusAi" = "AI";
+"BotStatusGame" = "Game";
+"BotStatusNonBinary" = "Non-binary";
 "ALongTimeAgo" = "last seen a long time ago";
 "WithinAMonth" = "last seen within a month";
 "WithinAWeek" = "last seen within a week";

src/bundles/extra.ts

@@ -123,4 +123,5 @@ export { default as LeaveGroupModal } from '../components/modals/leaveGroup/Leav
 export { default as TwoFaCheckModal } from '../components/modals/twoFaCheck/TwoFaCheckModal';
 export { default as QuickChatPickerModal } from '../components/modals/quickChatPicker/QuickChatPickerModal';
 export { default as RequestPeerModal } from '../components/modals/requestPeer/RequestPeerModal';
+export { default as BotCreationModal } from '../components/modals/botCreation/BotCreationModal';
 export { default as CocoonModal } from '../components/modals/cocoon/CocoonModal';

src/components/common/profile/ChatExtra.module.scss

@@ -56,6 +56,15 @@
   @include mixins.with-vt-type('chatExtra');
 }
 
+.botManager {
+  @include mixins.with-vt-type('chatExtra');
+}
+
+.botManagerIcon {
+  margin-inline-end: 0.25rem;
+  vertical-align: -0.125rem;
+}
+
 .botVerificationIcon {
   --custom-emoji-size: 1rem;