Rate this page:

Reachability Indicator

Your Conversations applications can display a chat user's online or offline status to other users of the application. This feature is called the Reachability Indicator, and the Conversations service automatically manages the online or offline state for each user if it is activated.

This feature also provides the User's reachability by Push Notification within the Conversations Service instance.

Reachability state is automatically updated and synchronized by the Conversations service, provided the feature is enabled. The feature is enabled on a "per Service instance" basis.

Note: It is important to note that Users exist within the scope of a Conversations Service instance. Thus, the Reachability indicators are also within the same scope.

Enable the Reachability Indicator

Each Service instance can have Reachability enabled or disabled. The default is disabled. Reachability state will not be updated if the feature is disabled for a given Service instance. Once enabled, the state will update and synchronize.

You must set the ReachabilityEnabled property using the Service Configuration REST resource to configure the Reachability Indicator feature.


        If you choose to enable Reachability Indicators and later wish to return to disabled, set the ReachabilityEnabled property back to false.

        User Reachability Properties

        The Reachability indicators are exposed for Users in two places:

        REST API

        The following read-only properties within the Users REST resource provide Reachability information for Users:

        • is_online
        • is_notifiable

        These properties are set by the Conversations system if the Reachability Indicator feature is enabled for a User's Service instance.

        Note: These properties can be null under the following conditions:

        • The Reachability Indicator feature is disabled for the Service instance
        • The User has not been online since the Reachability indicator has been enabled
        • LIST GET resource representations only have a true or false value for specific GET requests

        Please see the REST Users resource documentation for more information.

        Client SDKs

        Within the Conversations Client SDKs, the Reachability Indicator properties are exposed in the User objects.

        Real-time updates to other Users' Reachability Indicator states are communicated via the update event mechanism for subscribed User objects. Please see the specific SDK API documentation for details, as each SDK/platform handles this update a little differently.

        An indicator of your Service instance's Reachability status (reachability_enabled ) is also exposed at the SDK client level.

        The read only client SDK properties exposed are:

        • ConversationsClient.reachabilityEnabled
        • User.isOnline
        • User.isNotifiable

        Note: The above are representations. The specifics of how these properties are accessed are distinct for each language/SDK.

        Note: These user properties are read only and cannot be set. Conversations will update these settings and synchronize them as necessary. The Service Configuration REST resource manages the Service-level Reachability feature from the back-end code.

              Handle an UpdateReason change and process the Reachability Indicators

              Handle Reachability updates

              Handle an UpdateReason change and process the Reachability Indicators
              Rate this page:

              Need some help?

              We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.


                    Thank you for your feedback!

                    We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

                    Sending your feedback...
                    🎉 Thank you for your feedback!
                    Something went wrong. Please try again.

                    Thanks for your feedback!

                    Refer us and get $10 in 3 simple steps!

                    Step 1

                    Get link

                    Get a free personal referral link here

                    Step 2

                    Give $10

                    Your user signs up and upgrade using link

                    Step 3

                    Get $10

                    1,250 free SMSes
                    OR 1,000 free voice mins
                    OR 12,000 chats
                    OR more