Message history

PubNub APIs let you effectively fetch historical messages from direct, group, or public conversations.

While App Context API lets you manage metadata and relationships between users and channels, enabling efficient tracking of which channels are associated with a given user, Message Persistence API lets you retrieve messages from those channels. Together, these APIs enable you to gather all conversations involving a user and easily fetch specific message histories for any interactions between users.

Use GetMessageHistory() to fetch past messages from a channel.

API limitation

Results cannot be filtered by message type. All messages within the specified timeframe are returned.

Method signature

This method takes the following parameters:

1channel.GetMessageHistory(
2    string startTimeToken, 
3    string endTimeToken,
4    int count
5)

Input

How to use the startTimetoken and endTimetoken parameters

PubNub retrieves messages by searching backward through time (newest to oldest). Because of this, the parameter names are the reverse of their intuitive meaning:

• startTimetoken is the newer boundary (higher timetoken value) - search begins here, exclusive
• endTimetoken is the older boundary (lower timetoken value) - search stops here, inclusive

When you provide both parameters, startTimetoken must be a higher timetoken than endTimetoken.

9:00 AM10:00 AM11:00 AM11:59 AM

Results are always returned in oldest-first order.

* required

Parameter	Description
startTimetoken * Type: string Default: n/a	Timetoken delimiting the start of a time slice (exclusive) to pull messages from. For details, refer to the Fetch History section.
endTimetoken * Type: string Default: n/a	Timetoken delimiting the end of a time slice (inclusive) to pull messages from. For details, refer to the Fetch History section.
count * Type: int Default: 25	Number of historical messages to return for the channel in a single call. Since each call returns all attached message reactions by default, the maximum number of returned messages is 25. For more details, refer to the description of the IncludeMessageActions parameter in the Unity SDK docs.

Output

This method returns an awaitable Task<ChatOperationResult<List<Message>>> with messages sent within the given timeframe.

By default, each call returns all message reactions and metadata attached to the retrieved messages.

Sample code

From the support channel, fetch 10 historical messages older than the timetoken 15343325214676133.

1