Skip to content

Social SDK: Getting Lobby Chat History #7659

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 2, 2025
Merged

Social SDK: Getting Lobby Chat History #7659

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions docs/discord-social-sdk/development-guides/managing-lobbies.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -151,6 +151,46 @@ client->SetMessageCreatedCallback([&client](uint64_t messageId) {
});
```

---
## Getting Lobby Chat History

You can retrieve previous messages from a lobby using the [`Client::GetLobbyMessagesWithLimit`] function. This allows you to fetch chat history for display when users join a lobby or need to see previous conversations.

The function takes a lobby ID and a limit parameter to specify how many recent messages to retrieve.

**Important limitations:**
- Only a maximum of 200 messages and up to 72 hours of history can be retrieved
- Only messages from lobbies the user is currently a member of can be retrieved

```cpp
const uint64_t lobbyId = 01234567890;
const uint32_t messageLimit = 50; // Number of recent messages to retrieve (max 200)

client->GetLobbyMessagesWithLimit(
lobbyId, messageLimit,
[](const discordpp::ClientResult &result, const std::vector<discordpp::MessageHandle> &messages) {
if (result.Successful()) {
std::cout << "? Retrieved " << messages.size()
<< " messages from lobby chat history!\n";

// Process the messages (they are returned in chronological order)
for (const auto &message : messages) {
std::cout << "Message: " << message.Content() << std::endl;
}
} else {
std::cerr << "? Failed to retrieve lobby chat history\n";
}
});
```

The messages are returned as a list of [`MessageHandle`] objects, ordered chronologically from oldest to newest.
Each [`MessageHandle`] contains the message content, author information, and timestamp.

This is particularly useful for:
- Displaying recent chat when a user joins a lobby
- Implementing chat history scrollback features
- Preserving conversation context across game sessions

---

## Linking a Channel to Lobby
Expand Down Expand Up @@ -206,6 +246,7 @@ With your game able to create and manage lobbies, you can now implement addition
[`ChannelHandle`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1ChannelHandle.html#ac32096b2ef15c5c220e9b7b92253cc46
[`Client::CreateOrJoinLobby`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a8b4e195555ecaa89ccdfc0acd28d3512
[`Client::CreateOrJoinLobbyWithMetadata`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a5c84fa76c73cf3c0bfd68794ca5595c1
[`Client::GetLobbyMessagesWithLimit`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a0586192e85caf548b8b321f1cb21301f
[`Client::LeaveLobby`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a8c78f797240b35d721383461a2e62926
[`Client::SendLobbyMessage`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a779e0483f51dc99f0db3dd761d22ab6f
[`Client::SetMessageCreatedCallback`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a28325a8e8c688a84ac851da4bc86e148
Expand Down