Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now


Rate this page:

Thanks for rating this page!

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


The Reachability Indicator feature of Programmable Chat provides visibility into whether a User is online or offline within the Chat Service instance context. This feature also provides the User's reachability by Push Notification within the Chat Service instance.

Reachability state is automatically updated and synchronized by the Chat 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 Chat 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 Services REST resource to configure the Reachability Indicator feature.

To see if the feature is enabled for a Service instance, please refer to the reachability_enabled property of the Service REST resource representation.


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



              The Reachability indicators are exposed for Users in two places:

              • REST API - Userリソース
              • クライアントSDK - UserおよびUserDescriptorオブジェクト

              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 Chat system if the Reachability Indicator feature is enabled for a User's Service instance.

              メモ: これらのプロパティーは下記の条件によって null となることがあります。

              • 在席インジケーター機能がサービスインスタンスに対してオフにされている場合
              • 在席インジケーターがオンになってから、ユーザーがオンラインになっていない場合
              • LIST GET resource representations only have a true or false value for specific GET requests

              詳細については、REST Usersリソースドキュメントをご参照ください。


              Within the Chat Client SDKs, the Reachability Indicator properties are exposed in the User and UserDescriptor objects.

              Real-time updates to other Users' Reachability Indicator states are communicated via the update event mechanism for subscribed User objects. Reachability on UserDescriptor objects is a snapshot in time. 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.


              • ChatClient.reachabilityEnabled
              • User.isOnline and UserDescriptior.isOnline
              • User.isNotifiable and UserDescriptor.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. Chat will update these settings and synchronize them as necessary. The Service REST resource manages the Service-level Reachability feature.

                    Handle an UpdateReason change and process the Reachability Indicators

                    Process an UpdateReason

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


                    誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。