Signal Object
Last updated
Last updated
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 |
---|---|---|
The following entitlements, which appear in the Admin Portal, provide you with subscription capabilities for both specified users and company-wide pods.
Entitlement | Capability |
---|---|
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.
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.