BFF 聚合层：bff.bff（27 个 RPC 模块，268 个 handler）#

概述#

bff.bff 是 Telegram RPC 的主要实现层。它本质上是一个 go-zero zrpc gRPC server，注册了多个 mtproto.RegisterRPCxxxServer。

27 个模块总览与 handler 数量#

modulehandlers说明account8账户TTL/换手机号/删除账户authorization29登录/注册/二步验证/邮箱验证autodownload2自动下载设置chatinvites14聊天邀请链接/加群请求chats23群组管理/创建/迁移/管理员configuration11帮助/配置/国家列表/更新检查contacts23联系人管理/搜索/屏蔽/导入dialogs15对话列表/置顶/标记未读/输入状态drafts3消息草稿files12文件上传/下载/CDNmessages33消息发送/编辑/删除/搜索/转发/置顶miscellaneous2测试/日志notification7通知设置/设备注册nsfw2内容设置passkey6Passkey 认证passport11Telegram Passportpremium5Premium/支付privacysettings8隐私设置/全局隐私qrcode3QR 码登录savedmessagedialogs9保存的消息对话sponsoredmessages11赞助消息tos2服务条款updates3获取状态/差异/频道差异userchannelprofiles18用户资料/头像/频道资料usernames5用户名管理users4用户查询

全量 Handler 清单#

account (8)#

• AccountSetAccountTTL
• AccountSendChangePhoneCode
• AccountResetAuthorization
• AccountGetAccountTTL
• AccountSendConfirmPhoneCode
• AccountConfirmPhone
• AccountChangePhone
• AccountDeleteAccount

authorization (29)#

• AuthToggleBan
• AuthSignIn
• AuthSendCode / authSendCode
• AuthResetLoginEmail
• AuthResetAuthorizations
• AuthResendCode
• AuthRequestPasswordRecovery
• AuthRequestFirebaseSms
• AuthReportMissingCode
• AuthRecoverPassword
• AuthImportWebTokenAuthorization
• AuthImportBotAuthorization
• AuthImportAuthorization
• AuthExportAuthorization
• AuthDropTempAuthKeys
• AuthCheckRecoveryPassword
• AuthCheckPassword
• AuthCheckPaidAuth
• AuthCancelCode
• AuthBindTempAuthKey
• AccountVerifyEmailECBA39DB
• AccountVerifyEmail32DA4CF
• AccountSetAuthorizationTTL
• AccountSendVerifyEmailCode
• AccountResetPassword
• AccountInvalidateSignInCodes
• AccountChangeAuthorizationSettings
• AuthSignUp
• onContactSignUp
• AuthLogOut

autodownload (2)#

• AccountSaveAutoDownloadSettings
• AccountGetAutoDownloadSettings

chatinvites (14)#

• MessagesImportChatInvite
• MessagesHideAllChatJoinRequests
• MessagesGetExportedChatInvites
• MessagesGetExportedChatInvite
• MessagesGetChatInviteImporters
• MessagesGetAdminsWithInvites
• MessagesExportChatInvite
• MessagesEditExportedChatInvite
• MessagesDeleteRevokedExportedChatInvites
• MessagesDeleteExportedChatInvite
• MessagesCheckChatInvite
• ChannelsToggleJoinRequest
• MessagesHideChatJoinRequest
• ChannelsToggleJoinToSend

chats (23)#

• MessagesMigrateChat
• MessagesGetMessageReadParticipants2C6F97B7
• MessagesGetFullChat
• MessagesGetCommonChats
• MessagesGetChats
• MessagesGetAllChats
• MessagesEditChatTitle
• MessagesEditChatPhoto
• MessagesEditChatDefaultBannedRights
• MessagesGetMessageReadParticipants31C1C44F
• MessagesEditChatAdmin
• MessagesDeleteChat
• MessagesDeleteChatUser
• MessagesEditChatAbout
• createChat
• MessagesCreateChat9CB126E
• MessagesCreateChat92CEDDD4
• addChatUser
• MessagesAddChatUserF24753E3
• MessagesAddChatUserCBC6D107
• ChannelsSetEmojiStickers
• ChannelsConvertToGigagroup
• MessagesCreateChat34A818

configuration (11)#

• HelpGetSupport
• HelpGetNearestDc
• HelpGetInviteText
• HelpGetCountriesList
• HelpGetAppUpdate
• HelpGetAppConfig98914110
• HelpGetAppConfig61E3F854
• HelpGetAppChangelog
• HelpDismissSuggestion
• HelpGetSupportName
• HelpGetConfig

contacts (23)#

• ContactsUpdateContactNote
• ContactsToggleTopPeers
• ContactsSetBlocked
• ContactsSearch
• ContactsResetTopPeerRating
• ContactsResetSaved
• ContactsImportContacts
• ContactsGetTopPeers
• ContactsGetStatuses
• ContactsGetSaved
• ContactsGetLocated
• ContactsGetContacts
• ContactsGetContactIDs
• ContactsGetBlocked
• ContactsEditCloseFriends
• ContactsDeleteByPhones
• ContactsBlock
• ContactsAddContact
• ContactsAcceptContact
• ContactsUnblock
• AccountSetContactSignUpNotification
• AccountGetContactSignUpNotification
• ContactsDeleteContacts

dialogs (15)#

• MessagesToggleDialogPin
• MessagesSetHistoryTTL
• MessagesSendScreenshotNotification
• MessagesReorderPinnedDialogs
• MessagesMarkDialogUnread
• MessagesHidePeerSettingsBar
• MessagesGetSavedHistory
• MessagesGetSavedDialogs
• MessagesGetPinnedDialogs
• MessagesGetPeerSettings
• MessagesGetPeerDialogs
• MessagesGetOnlines
• MessagesGetDialogs
• MessagesSetTyping
• MessagesGetDialogUnreadMarks

drafts (3)#

• MessagesSaveDraft
• MessagesClearAllDrafts
• MessagesGetAllDrafts

files (12)#

• UploadSaveFilePart
• UploadReuploadCdnFile
• UploadGetWebFile
• UploadGetFile
• UploadGetFileHashes
• UploadGetCdnFile
• UploadGetCdnFileHashes
• MessagesUploadMedia
• makeMediaByInputMedia
• MessagesUploadEncryptedFile
• MessagesGetDocumentByHash
• HelpGetCdnConfig
• UploadSaveBigFilePart

messages (33)#

• MessagesUpdatePinnedMessage
• MessagesToggleNoForwards
• MessagesSummarizeText
• MessagesSendMultiMedia
• MessagesSendMessage
• MessagesSendMedia
• MessagesSearch
• MessagesSearchGlobal
• MessagesUnpinAllMessages
• MessagesSaveDefaultSendAs
• MessagesReceivedMessages
• MessagesReadMentions
• MessagesReadMessageContents
• MessagesReadHistory
• MessagesGetUnreadMentions
• MessagesGetSearchResultsCalendar
• MessagesGetSearchCounters
• MessagesGetSearchResultsPositions
• MessagesGetRecentLocations
• MessagesGetMessages
• MessagesGetMessagesViews
• MessagesGetMessageEditData
• MessagesGetExtendedMedia
• MessagesSearchSentMedia
• MessagesGetHistory
• MessagesForwardMessages
• checkForwardPrivacy
• makeForwardMessages
• MessagesDeleteMessages
• MessagesDeleteHistory
• MessagesEditMessage
• ChannelsSearchPosts
• ChannelsGetSendAs
• ChannelsCheckSearchPostsFlood
• MessagesGetOutboxReadDate

miscellaneous (2)#

• HelpTest
• HelpSaveAppLog

notification (7)#

• AccountUpdateNotifySettings
• AccountUnregisterDevice
• AccountResetNotifySettings
• AccountGetNotifySettings
• AccountGetNotifyExceptions
• AccountUpdateDeviceLocked
• AccountRegisterDevice

nsfw (2)#

• AccountSetContentSettings
• AccountGetContentSettings

passkey (6)#

• AuthInitPasskeyLogin
• AccountRegisterPasskey
• AccountInitPasskeyRegistration
• AccountGetPasskeys
• AuthFinishPasskeyLogin
• AccountDeletePasskey

passport (11)#

• UsersSetSecureValueErrors
• AccountVerifyPhone
• AccountSendVerifyPhoneCode
• AccountSaveSecureValue
• AccountGetSecureValue
• AccountGetAuthorizations
• AccountGetAuthorizationForm
• AccountGetAllSecureValues
• AccountDeleteSecureValue
• AccountAcceptAuthorization
• HelpGetPassportConfig

premium (5)#

• PaymentsCanPurchaseStore
• PaymentsAssignPlayMarketTransaction
• PaymentsAssignAppStoreTransaction
• HelpGetPremiumPromo
• PaymentsCanPurchasePremium

privacysettings (8)#

• UsersGetRequirementsToContact
• MessagesSetDefaultHistoryTTL
• MessagesGetDefaultHistoryTTL
• AccountSetPrivacy
• AccountSetGlobalPrivacySettings
• AccountGetGlobalPrivacySettings
• UsersGetIsPremiumRequiredToContact
• AccountGetPrivacy

qrcode (3)#

• AuthImportLoginToken
• AuthAcceptLoginToken
• AuthExportLoginToken

savedmessagedialogs (9)#

• MessagesToggleSavedDialogPin
• MessagesReadSavedHistory
• MessagesGetSavedHistory
• MessagesGetSavedDialogs
• MessagesGetSavedDialogsByID
• MessagesGetPinnedSavedDialogs
• MessagesReorderPinnedSavedDialogs
• ChannelsGetMessageAuthor
• MessagesDeleteSavedHistory

sponsoredmessages (11)#

• MessagesViewSponsoredMessage
• MessagesGetSponsoredMessages
• MessagesClickSponsoredMessage
• ContactsGetSponsoredPeers
• ChannelsViewSponsoredMessage
• ChannelsRestrictSponsoredMessages
• ChannelsReportSponsoredMessage
• ChannelsGetSponsoredMessages
• ChannelsClickSponsoredMessage
• MessagesReportSponsoredMessage
• AccountToggleSponsoredMessages

tos (2)#

• HelpGetTermsOfServiceUpdate
• HelpAcceptTermsOfService

updates (3)#

• UpdatesGetState
• UpdatesGetDifference
• UpdatesGetChannelDifference

userchannelprofiles (18)#

• UsersSuggestBirthday
• UsersGetSavedMusicByID
• PhotosUploadProfilePhoto
• PhotosUpdateProfilePhoto
• PhotosGetUserPhotos
• PhotosDeletePhotos
• ContactsGetBirthdays
• ChannelsSetMainProfileTab
• UsersGetSavedMusic
• AccountUpdateVerified
• AccountUpdateProfile
• AccountUpdateStatus
• AccountUpdatePersonalChannel
• AccountSetMainProfileTab
• AccountUpdateBirthday
• AccountSaveMusic
• AccountGetSavedMusicIds
• PhotosUploadContactProfilePhoto

usernames (5+1)#

• ContactsResolveUsername
• ChannelsCheckUsername
• AccountUpdateUsername
• updateUsername
• AccountCheckUsername
• ChannelsUpdateUsername

users (4)#

• UsersGetUsers
• UsersGetMe
• UsersGetFullUser
• ContactsResolvePhone

典型请求模式：auth.sendCode#

auth.sendCode 的 handler 展示 BFF 的典型模式：

1. 校验 api_id/api_hash
2. 解析/校验手机号
3. 调用 biz.user 查询用户是否存在
4. 调用 status 获取在线会话 → 决定是否走 app code
5. 调用 VerifyCodeInterface 下发短信

常见错误（TL/协议层）：

• PHONE_NUMBER_INVALID / PHONE_NUMBER_BANNED / PHONE_NUMBER_FLOOD
• SESSION_PASSWORD_NEEDED（两步验证）
• MIGRATE（跨 DC 重定向：Teamgram 社区版常保留 TODO）

关键代码路径#

• BFF 模块目录： app/bff/<module>/internal/core/*_handler.go
• BFF 聚合注册： app/bff/bff/internal/server/server.go
• 配置文件： teamgramd/etc/bff.yaml

Source Code References#

• Repository: https://github.com/teamgram/teamgram-server (Apache-2.0)