Twilio’s Programmable Chat client SDKs use paging to improve performance when accessing potentially large collections of chat objects.
While the signature of the individual methods will vary by SDK platform, each paginator has the following accessors:
- A way to obtain the items.
- A boolean property indicating if there are subsequent pages.
- A method taking the same callback mechanism as the original call to request the next page.
The messages collection behaves a bit differently than channels and members since there is a temporal quality to how the objects are typically presented.
The messages collection objects offer the following ways to access items:
getLastMessagesfetches the specified number of messages, starting with the most recent in the collection.
getMessagesBeforefetches messages before (and including) the anchor message index specified.
getMessagesAfterfetches messages after (and including) the anchor message index specified.
messageWithConsumptionIndexfetches the message with the specified index or, if that message is no longer available, the message directly before it.
messageWithIndexfetches the message specified by the index, if available.
Next: Roles and Permissions