Telephony
  • Telephony
  • Permissions
  • Sending An SMS
  • Query SMS
  • Query Conversations
  • Listen Incoming SMS
  • Network Data and Metrics
  • Start Phone Call
  • Executing in Background
Powered by GitBook
On this page
  • getConversations()
  • SmsConversation
  • ConversationColumn
  • ConversationFilter

Was this helpful?

Query Conversations

PreviousQuery SMSNextListen Incoming SMS

Last updated 4 years ago

Was this helpful?

Requires READ_SMS permission.

Add the following permission in your AndroidManifest.xml

<uses-permission android:name="android.permission.READ_SMS"/>

getConversations()

Returns Future<List<>>

Parameters

Type

Description

Optional

Default Value

Filter

Filters the result by given constraints. Works like SQL WHERE clause.

✔️

null

sortOrder

Sorts the result prioritized by order of declaration.

✔️

null

List<SmsConversation> conversations = await telephony.getConversations(
        filter: SmsFilter.where(ConversationColumn.THREAD_ID)
                 .equals("12")
                 .and(ConversationColumn.SNIPPET)
                 .like("starwars"),
        sortOrder: [OrderBy(ConversationColumn.THREAD_ID, sort: Sort.ASC)]
        );

All parameters are optional.

List<SmsConversation> conversations = await telephony.getConversations();

SmsConversation

Property

Type

snippet

String

threadId

int

messageCount

int

ConversationColumn

Values

SNIPPET

THREAD_ID

MSG_COUNT

ConversationFilter

List of

Works exactly like but works with instead of

SmsConversation
ConversationFilter
ConversationColumn
SmsFilter
SmsColumn
OrderBy