Skip to content

docs: document DM history limitations in Social SDK #8004

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
Nov 25, 2025
+7 −2
Merged

docs: document DM history limitations in Social SDK #8004

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
9 changes: 7 additions & 2 deletions docs/discord-social-sdk/development-guides/sending-direct-messages.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -154,7 +154,7 @@ Use [`Client::GetUserMessagesWithLimit`] to fetch message history from a specifi

```cpp
const uint64_t recipientId = 1234567890; // The other user's Discord ID
const int32_t messageLimit = 50; // Number of recent messages to retrieve
const int32_t messageLimit = 50; // Number of recent messages to retrieve (max 200)

client->GetUserMessagesWithLimit(
recipientId, messageLimit,
Expand All @@ -176,11 +176,16 @@ client->GetUserMessagesWithLimit(
);
```

**Important limitations:**
- Only a maximum of 200 messages and up to 72 hours of history can be retrieved
- Both players must have played the game for DM history to be accessible
- If either user hasn't played the game, the system cannot find a channel between them and may return a 404 `discordpp::ErrorType::HTTPError` error

Key points about [`Client::GetUserMessagesWithLimit`] that are important to note:

- Messages are returned in reverse chronological order (newest first)
- The function checks the local cache first and only makes an HTTP request if needed
- Pass 0 or a negative value for `limit` to retrieve all available messages
- Pass 0 or a negative value for `limit` to retrieve all available messages (up to the 200 message maximum)

This functionality is useful for:
- Displaying conversation history when a user opens a DM
Expand Down