Jump to: navigation, search

channel-<any name>-monitor-<any name> Section

Important
For a Twitter channel this section is called channel-<any name>-monitor.

access-token

Default Value: The value of the x-acess-token option
Valid Values: Any valid media access token (string)
Changes Take Effect: After the time interval specified in the sampling-period or x-sampling-period options

Specifies the default media access token that will be used for communication. With Facebook, for monitors of type private-messaging, a page access token must be used.

cleanup-relations

Default Value: 7
Valid Values: 0–365
Changes Take Effect: Immediately

Specifies, in days, how frequently the relations data (friends, followers and actions records) of Twitter channels is cleaned up by the server. A value of 0 means the cleaning is not performed.

control-str-public

Default Value: on
Valid Values: on, off
Changes Take Effect: After restart

Specifies whether Twitter Driver uses the public messages data stream. If on, the stream is used. If off, the stream is not used.

Important
The public data stream delivers messages that are specified by the options str-follow-<any name> and str-track-<any name>.

control-str-user

Default Value: on
Valid Values: on, off
Changes Take Effect: After restart

Specifies whether Twitter Driver uses the user data stream. If on, the stream is used. If off, the stream is not used.

Important
The user data stream delivers home timeline tweets, tweets with mention of a channel account, and direct messages.

get-direct-messages

Default Value: true
Valid Values: true, false
Changes Take Effect: Immediately

Specifies whether to turn off (false) or on (true) fetching of direct messages from your own account.

get-home-timeline

Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately

Specifies whether to turn off (false) or on (true) fetching of messages from your home timeline.

get-mentions

Default Value: true
Valid Values: true, false
Changes Take Effect: Immediately

Specifies whether to turn off (false) or on (true) fetching of messages from your home account.

history-length

Default Value: 1000
Valid Values: Any positive integer.
Changes Take Effect: After the time interval specified in the sampling-period or x-sampling-period options.

Specifies how many successfully submitted interaction IDs the RSS/ATOM driver will keep in the history file in order to avoid a duplicate submission.

Important
This option overwrites the option x-print-rss-channel in the main channel section.

history-time-period

Default Value: value of the x-history-time-period option
Valid Values: 60–31536000 (1 min-365 days)
Changes Take Effect: After restart

Specifies the length, in seconds, of the history time period during which objects are read from.

Important
The history-time-period option can be configured for all monitors using the x-history-time-period option. The option in a particular monitor section overwrites the option in the main channel section.

This option replaces the posts-time-period and messages-time-period options.

This option is processed by all monitor types.

history-writing-frequency

Default Value: value of the x-history-writing-frequency option
Valid Values: 10-10000
Changes Take Effect: Immediately

Specifies how often, in scanning cycles, the history is written to the history file on the local host. For example, if set to 3, each third scanning cycle writes to the history file on the local host.

Important
The history-writing-frequency option can be configured for all monitors using the x-history-writing-frequency option. The option in a particular monitor section overwrites the option in the main channel section. This option is processed by all monitor types.

id

Default Value: No default value
Valid Values: Any numeric string: the valid ID of a Facebook object for monitoring
Changes Take Effect: After restart

Mandatory when the monitor-type is set to generic, event or private-messaging. If the monitor-type is generic, this can be the ID of a Page, User, Event, Application or Group. If the monitor-type is private-messaging, this can only be a the ID of a Page. If the monitor-type is event, this can only be a the ID of an Event.

inbound-media

Default Value: The value of the x-inbound-media option
Valid Values: Any valid media name
Changes Take Effect: After the time interval specified in the sampling-period or x-sampling-period options

If the monitor-type is set to generic, event or search, inbound-media specifies the media type assigned to interactions that are submitted to Interaction Server. This value is attached to the interaction User Data with the particular key.

Important
This value can also be configured at the channel level using the x-inbound-media option.

itx-submit-timeout

Default Value: 10
Valid Values: 10–60
Changes Take Effect: Immediately

Specifies the time, in seconds, that Social Messaging Server waits for a response after sending a request to Interaction Server.

itx-resubmit-attempts

Default Value: 3
Valid Values: 0–9
Changes Take Effect: Immediately

Specifies the number of times that Social Messaging Server resubmits an interaction after the itx-submit-timeout timeout expires.

itx-resubmit-delay

Default Value: 30
Valid Values: 1–120
Changes Take Effect: Immediately

Specifies the time, in seconds, that Social Messaging Server waits between attempts to resubmit an interaction.

max-comments-per-post-to-process

Default Value: value of x-max-comments-per-post-to-process option
Valid Values: 0–5000; 0 specifies no limit
Changes Take Effect: Immediately

Specifies the maximum number of comments that can be attached to an interaction. For example, if a Post has one hundred Comments and this option is set to 50, only the fifty most recent comments are attached to the interaction and passed to an Agent. If the option is set to 0, all comments are attached to the interaction and passed to an Agent.

Important
The max-comments-per-post-to-process option can be configured for all monitors using the x-max-comments-per-post-to-process option. The option in a particular monitor section overwrites the option in the main channel section. This option is processed by the generic, event and search monitor types.

max-listed-posts-per-request

Default Value: The value of the x-max-listed-posts-per-request option
Valid Values: 50–1000
Changes Take Effect: Immediately

Specifies the maximum number of explicitly listed post IDs in an FQL request. This option is intended for use by Genesys Professional Services only. In May 2013, Facebook could process FQL requests with more than 1,000 explicitly listed post IDs; however, in July 2013, this amount dropped to approximately 300. This option was added for fine-tuning in case of further changes in Facebook behavior.


max-objects-per-request

Default Value: value of the x-max-objects-per-request option
Valid Values: 50–1500
Changes Take Effect: Immediately

Specifies the maximum number of Facebook objects (Posts, Comments, Messages) that are retrieved by one request to the Facebook server. Applies to requests using either FQL (Facebook Query Language) or the Graph API.

Important
The max-objects-per-request option can be configured for all monitors using the x-max-objects-per-request option. The option in a particular monitor section overwrites the option in the main channel section.

This option replaces the max-posts-per-fql-request, max-comments-per-fql-request, and max-messages-per-fql-request options.

The bigger the value is, the longer the response time from the Facebook Server. This increases the possibility of losing connection to the Facebook server due to HTTP session timeouts.

This option is processed by all monitor types

monitor-type

Default Value: No default value
Valid Values: generic, search, event, private-messaging
Changes Take Effect: After restart

Specifies the monitor type.

Important
If the value of monitor-type is private-messaging, then access-token must represent a Facebook Page access token.

If the value of monitor-type is invalid or empty, Facebook Driver will not create a monitor for this section. In this case, the monitor-type option can be changed to any valid value at any time without restarting the server. Once a valid monitor is created, changes to

monitor-type are ignored unless the server is restarted.

posts-buffer-size

Default value: 1000
Valid values: 50-2147483647
Changes take effect: Immediately

Specifies the maximum number of stream posts retrieved that were created or updated during the history-time-period timespan. If the actual number of posts is greater than this value, the most recent posts are retrieved. The Driver processes this option only when the monitor-type is generic or event.

Important
This value can also be configured at the channel level using the x-posts-buffer-size option.

print-rss-channel

Default value: false
Valid values: true, false
Changes take effect: After the time interval specified in the sampling-period or x-sampling-period options.

Specifies whether the driver should print common fields of the received RSS/ATOM feed to a log file.

Important
This option overwrites the option x-print-rss-channel in the main channel section.

print-rss-items

Default value: 0
Valid values: Any interger 0 and above. Changes take effect: After the time interval specified in the sampling-period or x-sampling-period options.

Specifies how many received RSS/ATOM items the driver prints to a log file.

Important
This option overwrites the option x-print-rss-items in the main channel section.

publish-access-token

Default: No default value
Valid Values: Any valid access token (string)
Changes take effect: After the time interval specified in the sampling-period or x-sampling-period options

Specifies an access token that is used by the Driver to publish posts and comments. The Driver processes this option only when the monitor-type is generic or event.

query

Default Value: No default value
Valid Values: Any valid Facebook query (string)
Changes Take Effect: After the time interval specified in the sampling-period or x-sampling-period options

Specifies the text to search in Posts on Facebook. The Driver processes this option only when the monitor-type is set to search.

refresh-period-channel-account

Default Value: 30
Valid Values: 0 (the list is not refreshed) or 5–1440
Changes Take Effect: Immediately

Specifies, in minutes, how frequently the account information of the channel is refreshed with data that is re-fetched from Twitter. A value of 0 means the list is not refreshed.

refresh-period-followers

Default Value: 10
Valid Values: 0, 5–1440, 100000
Changes Take Effect: Immediately

Specifies, in minutes, how frequently the followers list of the account channel is refreshed with data that is re-fetched from Twitter. A value of 0 disables the refresh period so that the followers list is fetched only once when the driver starts. A value of 100000 turns off fetching, so that the followers list is never fetched by the driver.

refresh-period-friends

Default Value: 20
Valid Values: 0, 5–1440, 100000
Changes Take Effect: Immediately

Specifies, in minutes, how frequently the friends list of the account channel is refreshed with data that is re-fetched from Twitter. A value of 0 disables the refresh period so that the followers list is fetched only once when the driver starts. A value of 100000 turns off fetching, so that the followers list is never fetched by the driver.

rss-url

Default value: empty
Valid values: Any valid URL.
Changes take effect: After the time interval specified in the sampling-period or x-sampling-period options.

Specifies URL of an RSS feeder, which is used to request data from the feeder.

sampling-history

Default Value: 0
Valid Values: 0–864000
Changes Take Effect: After Restart

Specifies the "historical depth," in seconds, of the first data fetching cycle from the Twitter data source. The first data fetching cycle requests messages with time stamps from (current_time_in_seconds minus sampling-history value) to (current_time_in_seconds). A value of zero means only new messages are fetched; that is, messages created after the driver's start time.

sampling-period

Default Value: The value of the x-sampling-period option
Valid Values: 1–31536000
Changes Take Effect: After the original time interval specified in the sampling-period or x-sampling-period options

Specifies the length, in seconds, of the sample period that will be used by monitor.

Important
If the value of monitor-type is generic, event or search, then the value of sampling-period cannot be smaller than the value of sampling-time-buffer.

The value can also be configured at the channel level using the x-sampling-period option.

Facebook Driver checks its configuration every time it requests data from Facebook.

sampling-time-buffer

Default Value: The value of the x-sampling-time-buffer option
Valid Values: 10–180
Changes Take Effect: After the time interval specified in the sampling-period or x-sampling-period options

Used to determine the buffer time in seconds for the sampling period. The buffer time will be deducted from the start and end time of each sampling period in monitors. The Driver processes this option only when the monitor-type is generic, event, or search.

Important
This value can also be configured at the channel level using the x-sampling-time-buffer option.

str-follow-<any name>

Default Value: No default value
Valid Values: Positive integer
Changes Take Effect: Immediately

Specifies the numeric ID of a Twitter user. Public statuses for this user are included in the messaging stream. Refer to the stream query parameter follow that is described at https://dev.twitter.com/docs/streaming-api/parameters.

str-track-<any name>

Default Value: No default value
Valid Values: Any string
Changes Take Effect: Immediately

Specifies keywords or phrases to track. Public statuses that match this option are included in the messaging stream. Refer to the stream query parameter that is described at https://dev.twitter.com/docs/streaming-api/parameters.

submit-comments-itx

Default Value: The value of the x-submit-comments-itx option
Valid Values: true, false
Changes Take Effect: After the time interval specified in the sampling-period or x-sampling-period options

Specifies whether a new interaction with Facebook type comment will be created for each comment (true). The Driver processes this option only when the monitor-type is generic, event, or search.

Important
This value can also be configured at the channel level using the x-submit-comments-itx option.

submit-internal-itx

Default Value: The value of the x-submit-internal-itx option
Valid Values: true, false
Changes Take Effect: After the time interval specified in the sampling-period or x-sampling-period options

When the Facebook driver is monitoring the Facebook wall it will read all of the posts and comments and some of the posts and comment might be created by agents. If this option is set to true, all Facebook interactions (regardless of who created the posts and comments) will be created. If this option is set to false, only interactions in which there is new content (posts or comments) created by customers will be created. All interactions that have older posts created prior to monitor read times and comments created only by agents will not be submitted. The Driver processes this option only when the monitor-type is generic, event, or search.

Important
This value can also be configured at the channel level using the x-submit-internal-itx option.


This page was last modified on November 20, 2018, at 10:36.

Feedback

Comment on this article:

blog comments powered by Disqus