Jump to: navigation, search

channel-<any name> Section

driver-classname

Default Value: No default value
Valid Values: Any valid driver class name
Changes Take Effect: After restart

Specifies the class name of the media driver for a specific media service. The class name is provided in the cfg file in the driver's installation directory.

inbound-route

Default Value: No default value
Valid Values: <tenant id> : <access point name> or
<tenant id> : <access point name1>, <tenant id> : <access point name2>
Changes Take Effect: After restart

The value <tenant id> : <access point name> specifies the access point that is used to place submitted interactions for incoming messages. For example:
101:facebook_queue
or
101:inqueue-acc-point
The value <tenant id> : <access point name1>, <tenant id> : <access point name2> is applicable only in support of Facebook session mode. <access point name2> specifies the access point Facebook Driver provides to Chat Server.
The second access point is required for support of private conversations (sessions) between a Facebook user and an agent. Sessions are supported only for the monitor type private-messaging. For monitors of other types, the second access point is ignored.
The second access point must point to the corresponding access point in Chat Server, as described in Step 10 of Configuring Chat Server for Facebook session mode.

Important
For sessions, if the second access point is not configured in Chat Server, all private-messaging interactions are placed in the default Chat Server queue.
The name of this option was changed from inbound-route-default to inbound-route in eServices 8.1.


reconnection-timeout

Default Value: 180
Valid Values: Any positive integer greater than or equal to 10
Changes Take Effect: After restart

Specifies the delay, in seconds, before the server starts the reconnection procedure for this media channel if the connection was lost.

ucs-in-use

Default Value: false
Valid Values: true, false
Changes Take Effect: After restart

Allows the use of Universal Contact Server to save data, such as account relations.

ucs-request-timeout

Default Value: 60
Valid Values: 10–300
Changes Take Effect: After restart

Specifies the length of time, in seconds, to wait for UCS to return the result of an ESP request.


x-access-token

Default Value: No default value
Valid Values: Any valid access token (string)
Changes Take Effect: Immediately

Specifies an access token that is used by the driver to access a service. To obtain this value, you must register Social Messaging Server as an application in the respective service, as described in:

x-access-token-secret

Default Value: No default value
Valid Values: Any valid access token (string)
Changes Take Effect: After restart

Specifies an access token secret (password) that is used by the driver to access a Twitter service. To obtain this value, you must register Social Messaging Server as an application in Twitter service, as described in the description for x-consumer-key.

x-consumer-key

Default Value:
Valid Values:
Changes Take Effect: After restart

Specifies the consumer key that is used by the drive to access a Twitter service. To obtain this value, you must register Social Messaging Server as an application in Twitter service. Refer to the following websites for information about how to register Social Messaging Server:

x-consumer-secret

Default Value: No default value
Valid Values: Any valid string with a consumer key secret
Changes Take Effect: After restart

Specifies the consumer key secret (password) that is used with the value of the x-consumer-key option by the driver to access a Twitter service. To obtain this value, you must register Social Messaging Server as an application in Twitter service, as described in the description for x-consumer-key.

x-debug-mode

Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Specifies the form of logging. If set to true, an extended form of logging is set for the driver. If set to false, a reduced form of logging is set for the driver.

x-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 duplicate submissions.

Important
This option can be configured for each monitor section individually using the history-length option. The option in a particular monitor section overwrites the option in the main channel section.

x-history-time-period

Default Value: 2592000 (30 days)
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 x-history-time-period option can be configured for each monitor section individually using the history-time-period option. The option in a particular monitor section overwrites the option in the main channel section. This option replaces the x-posts-time-period and x-messages-time-period options.

x-history-writing-frequency

Default Value: 3
Valid Values: 1–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 x-history-writing-frequency option can be configured for each monitor section individually using the history-writing-frequency option. The option in a particular monitor section overwrites the option in the main channel section. The history file keeps data about the latest successfully submitted interaction.The history file name has the following formats:
  • For monitors of the generic, event, and private-messaging types, the format is <type>_<id>; for example, generic_481918061818707.
  • For monitors of the search type, the format is <type>_<hash-code>, where hash-code is some unique number that is calculated based on the value of the query option.

x-inbound-media

Default Value: facebook for a Facebook channel, rss for an RSS channel, twitter for a Twitter channel
Valid Values: Any valid media name
Changes Take Effect: Immediately

Specifies the media type that is assigned to interactions that are submitted to Interaction Server.

Important
The x-inbound-media option can be configured for each monitor section individually using the inbound-media option. The option in a particular monitor section overwrites the option in the main channel section.

x-itx-resubmit-attempts

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

Specifies the number of times the application will attempt to resubmit an interaction.

x-itx-resubmit-delay

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

Specifies the number of seconds between each resubmit of an interaction. The application will pause for the specified period of time between each resubmit of an interaction.

x-itx-submit-timeout

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

Specifies the amount of time, in seconds, that Social Messaging Server waits for a positive response when it submits a request with an inbound message to Interaction Server.

x-max-comments-per-post-to-process

Default Value: 50
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 x-max-comments-per-post-to-process option can be configured for each monitor section individually using the 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,


x-max-listed-posts-per-request

Default Value: 200
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.

Important
This option can be configured for each monitor section using the max-listed-posts-per-request option. The larger the value, the longer the Facebook response time.


x-max-objects-per-request

Default Value: 1000
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 x-max-objects-per-request option can be configured for each monitor section individually using the max-objects-per-request option. The option in a particular monitor section overwrites the option in the main channel section.

This option replaces the x-max-posts-per-fql-request, x-max-comments-per-fql-request, x-max-messages-per-fql-request, and x-post-chunk-size 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.

x-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 x-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
The x-posts-buffer-size option can be configured for each monitor section individually using the posts-buffer-size option. The option in a particular monitor section overwrites the option in the main channel section.

x-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 can be configured for each monitor section individually using the print-rss-channel option. The option in a particular monitor section overwrites the option in the main channel section.

x-print-rss-items

Default value: 0
Valid values: Any integer above 0.
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 can be configured for each monitor section individually using the print-rss-items option. The option in a particular monitor section overwrites the option in the main channel section.

x-publish-access-token

Default: No default value
Valid Values: Any valid access token (string)
Changes Take Effect: Immediately

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.

Important
The x-publish-access-token option can be configured for each monitor section individually using the publish-access-token option. The option in a particular monitor section overwrites the option in the main channel section.

x-sampling-period

Default Value: 240
Valid Values: 1-31536000
Changes Take Effect: Immediately

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

Important
The value of sampling-period cannot be smaller than the value of sampling-time-buffer.

x-sampling-time-buffer

Default Value: 30
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 the monitors.

x-source-nick-name

Default Value:
Valid Values:
Changes Take Effect: Immediately

Specifies the nickname of the channel. The nickname may be shown to the agent by an agent client application.

x-submit-comments-itx

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

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
The x-submit-comments-itx option can be configured for each monitor section individually using the submit-comments-itx option. The option in a particular monitor section overwrites the option in the main channel section.

x-submit-internal-itx

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

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
The x-submit-internal-itx option can be configured for each monitor section individually using the submit-internal-itx option. The option in a particular monitor section overwrites the option in the main channel section.

x-submit-own-all

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

Specifies whether the inbound messages originating from the media account associated with this channel ("own" messages) are submitted to Interaction Server.

x-ucs-relations-chunk

Default Value: 200
Valid Values: 100–5000
Changes Take Effect: After restart

Specifies the maximum number of relations sent to UCS in one ESP request.



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

Feedback

Comment on this article:

blog comments powered by Disqus