teamgram-bff-aggregation

Complete reference for the BFF aggregation layer in Teamgram Server with all 27 RPC modules and 268 handlers implementing Telegram-compatible API endpoints.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "teamgram-bff-aggregation" with this command: npx skills add zhihang9978/teamgram-bff-aggregation

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文件上传/下载/CDN
messages33消息发送/编辑/删除/搜索/转发/置顶
miscellaneous2测试/日志
notification7通知设置/设备注册
nsfw2内容设置
passkey6Passkey 认证
passport11Telegram Passport
premium5Premium/支付
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

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

URL to PDF

Convert URL to PDF suitable for mobile reading.

Registry SourceRecently Updated
1.3K0guoqiao
General

pdf-ocr-layout

基于智谱 GLM-OCR、GLM-4.7 及 GLM-4.6V 的多模态文档深度解析工具。 Use when: - 需要高精度提取文档（PDF/图片）中的表格并转换为 Markdown 格式 - 需要从文档页面中自动裁剪并提取插图、图表为独立文件 - 需要对提取的图表进行深度语义理解（基于 GLM-4.6V 视觉分析） - 需要对提取的表格数据进行逻辑分析（基于 GLM-4.7 文本分析） 核心架构： 1. 视觉提取：GLM-OCR 2. 语义理解：GLM-4.7 (纯文本/表格) + GLM-4.6V (多模态/图像)

Registry SourceRecently Updated
1.5K1baokui
General

rupali

Playful virtual girlfriend voice companion. Use when the user wants short, flirty, friendly text replies returned as Bulbul v3 audio across chat channels (Discord/Telegram/WhatsApp). Generate a brief response, then synthesize and send MP3.

Registry SourceRecently Updated
8470altonappleton32-ux
General

博查搜索

博查搜索 API 插件，从全网搜索网页信息，结果准确、摘要完整，适合 AI 使用。

Registry SourceRecently Updated
1.8K0sunjingji