Session Identifiers
Session Identifiers provide a unique identifier for all call activity. This is necessary (in addition to the telephone number) when, for example, two individuals were contactable via the same phone number.
These take the form of a Session Identifier (SI) parameter included in all messages where the Telephone Number (TN) parameter is used, as listed below.
The Session Identifier (SI) is used to give each called party a unique key (from the database, for example). This enables Softdial CallGem™ to dial duplicate telephone numbers on the same campaign, provided that they have a different session ID.
Session Identifiers must be globally unique across all campaigns.
Messages to Softdial CallGem™
The Session Identifier (SI) parameter is optional in all messages to Softdial CallGem™, where it is specified as a parameter, with one exception:
The MakeCall [MC] Message
For the Make Call [MC] message:
- the Telephone Number (TN) parameter is mandatory.
- the Session Identifier (SI) parameter is handled according to the table below.
Either the Session Identifier (SI) or the Telephone Number (TN) parameter can be used alone to refer to a call. Softdial CallGem™ obeys the following rules in dealing with these parameters:
| SI specified? | TN specified? | Action | Subsequent Messages from Softdial CallGem™ |
|---|---|---|---|
| No | No (Does not apply to the Make Call [MC] message. See above.) |
Softdial CallGem™ returns Error Code 120 - Telephone Number (TN) parameter missing. | Not applicable. |
| Yes | Softdial CallGem™ uses the Session Identifier (SI) parameter to refer to the call. | Use both SI and Telephone Number (TN) as specified in the Session Identifier (SI) parameter here. | |
| No | Yes | Softdial CallGem™ uses the Telephone Number (TN) parameter to refer to the call, and assumes the Session Identifier (SI) parameter to be the same as the Telephone Number (TN) parameter. | Use both Session Identifier (SI) and Telephone Number (TN) as specified in the Telephone Number (TN) parameter here. |
| Yes | Yes | Softdial CallGem™ cross-references Session Identifier (SI) and Telephone Number (TN) parameter values. If discrepancy
|
Use both Session Identifier (SI)and Telephone Number (TN) as specified here. |
Messages from Softdial CallGem™
The Session Identifier (SI) parameter is optional in all messages to Softdial CallGem™, where it is specified as a parameter.
The values for the Session Identifier (SI) and Telephone Number (TN) parameters are attributed according to the above table.