The Signal object must be included in the body of the request. Signal objects can be subscribed and unsubscribed. The management of those subscriptions at both the individual and company-wide scales requires entitlements (see Entitlements below). The Signal object contains the following fields:
Field | Type | Description |
---|---|---|
name | String | Signal name. |
query | String | The query used to define this signal and is composed of field:value pairs combined by the operators AND or OR .Supported fields are: author , hashtag and cashtag (case-insensitive), and MUST contain at least one hashtag or cashtag definition.This field uses the same syntax as the Message Search with these fields: HASHTAG , CASHTAG , AUTHOR , POSTEDBY .POSTEDBY refers to wall posts by the end user. |
visibleOnProfile | Boolean | Specifies whether the signal is visible on its creator's profile. |
companyWide | Boolean | Specifies whether the signal is a company-wide signal. Users in the pod cannot unsubscribe. The Can create push signals entitlement is required to set this field. See Entitlements for more information. |
Entitlements
The following entitlements, which appear in the Admin Portal, provide you with subscription capabilities for both specified users and company-wide pods.
Entitlement | Capability |
---|---|
Can manage signal subscriptions | Allows you to subscribe specified users who cannot unsubscribe from a given signal. |
Can create push signals | Allows you to create company-wide signals that cannot be unsubscribed. |